LibreOfficeDev
LibreOfficeDev 26.8 SDK C/C++ API Reference
ustring.hxx
Go to the documentation of this file.
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3  * This file is part of the LibreOffice project.
4  *
5  * This Source Code Form is subject to the terms of the Mozilla Public
6  * License, v. 2.0. If a copy of the MPL was not distributed with this
7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8  *
9  * This file incorporates work covered by the following license notice:
10  *
11  * Licensed to the Apache Software Foundation (ASF) under one or more
12  * contributor license agreements. See the NOTICE file distributed
13  * with this work for additional information regarding copyright
14  * ownership. The ASF licenses this file to you under the Apache
15  * License, Version 2.0 (the "License"); you may not use this file
16  * except in compliance with the License. You may obtain a copy of
17  * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18  */
19 
20 /*
21  * This file is part of LibreOffice published API.
22  */
23 
24 #ifndef INCLUDED_RTL_USTRING_HXX
25 #define INCLUDED_RTL_USTRING_HXX
26 
27 #include "sal/config.h"
28 
29 #include <cassert>
30 #include <cstddef>
31 #include <cstdlib>
32 #include <ostream>
33 #include <utility>
34 
35 #if defined LIBO_INTERNAL_ONLY
36 #include <algorithm>
37 #endif
38 
39 #include "rtl/math.h"
40 #include "rtl/ustring.h"
41 #include "rtl/string.hxx"
42 #include "rtl/stringutils.hxx"
43 #include "rtl/textenc.h"
44 
45 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
46 #include "config_global.h"
47 #include "o3tl/safeint.hxx"
48 #include "rtl/stringconcat.hxx"
49 #endif
50 
51 #ifdef RTL_STRING_UNITTEST
52 extern bool rtl_string_unittest_invalid_conversion;
53 #endif
54 
55 // The unittest uses slightly different code to help check that the proper
56 // calls are made. The class is put into a different namespace to make
57 // sure the compiler generates a different (if generating also non-inline)
58 // copy of the function and does not merge them together. The class
59 // is "brought" into the proper rtl namespace by a typedef below.
60 #ifdef RTL_STRING_UNITTEST
61 #define rtl rtlunittest
62 #endif
63 
64 namespace rtl
65 {
66 
67 class OUStringBuffer;
68 
69 #ifdef RTL_STRING_UNITTEST
70 #undef rtl
71 #endif
72 
73 #if defined LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
75 
82 template<std::size_t N> class SAL_WARN_UNUSED OUStringLiteral {
83  static_assert(N != 0);
84  static_assert(N - 1 <= std::numeric_limits<sal_Int32>::max(), "literal too long");
85 
86 public:
87 #if HAVE_CPP_CONSTEVAL
88  consteval
89 #else
90  constexpr
91 #endif
92  OUStringLiteral(char16_t const (&literal)[N]) {
93  assertLayout();
94  assert(literal[N - 1] == '\0');
95  std::copy_n(literal, N, more.buffer);
96  }
97 
98  constexpr sal_Int32 getLength() const { return more.length; }
99 
100  constexpr sal_Unicode const * getStr() const SAL_RETURNS_NONNULL { return more.buffer; }
101 
102  constexpr operator std::u16string_view() const { return {more.buffer, sal_uInt32(more.length)}; }
103 
104 private:
105  static constexpr void assertLayout() {
106  // These static_asserts verifying the layout compatibility with rtl_uString cannot be class
107  // member declarations, as offsetof requires a complete type, so defer them to here:
108  static_assert(std::is_standard_layout_v<OUStringLiteral>);
109  static_assert(offsetof(OUStringLiteral, str.refCount) == offsetof(OUStringLiteral, more.refCount));
110  static_assert(offsetof(OUStringLiteral, str.length) == offsetof(OUStringLiteral, more.length));
111  static_assert(offsetof(OUStringLiteral, str.buffer) == offsetof(OUStringLiteral, more.buffer));
112  }
113 
114  struct Data {
115  Data() = default;
116 
117  oslInterlockedCount refCount = 0x40000000; // SAL_STRING_STATIC_FLAG (sal/rtl/strimp.hxx)
118  sal_Int32 length = N - 1;
119  sal_Unicode buffer[N];
120  };
121 
122 public:
123  // (Data members must be public so that OUStringLiteral is a structural type that can be used as
124  // a non-type template parameter type for operator ""_ustr:)
125  union {
126  rtl_uString str;
127  Data more = {};
128  };
129 };
130 
131 #if defined RTL_STRING_UNITTEST
132 namespace libreoffice_internal {
133 template<std::size_t N> struct ExceptConstCharArrayDetector<OUStringLiteral<N>> {};
134 template<std::size_t N> struct ExceptCharArrayDetector<OUStringLiteral<N>> {};
135 }
136 #endif
137 
139 #endif
140 
141 /* ======================================================================= */
142 
166 // coverity[ missing_move_assignment : SUPPRESS] - don't report the suppressed move assignment
167 class SAL_WARN_UNUSED SAL_DLLPUBLIC_RTTI OUString
168 {
169 public:
171  rtl_uString * pData;
173 
177 #if defined LIBO_INTERNAL_ONLY
178  constexpr
179 #endif
180  OUString()
181  {
182 #if defined LIBO_INTERNAL_ONLY
183  pData = const_cast<rtl_uString *>(&empty.str);
184 #else
185  pData = NULL;
186  rtl_uString_new( &pData );
187 #endif
188  }
194 #if defined LIBO_INTERNAL_ONLY
195  constexpr
196 #endif
197  OUString( const OUString & str )
198  {
199  pData = str.pData;
200 #if defined LIBO_INTERNAL_ONLY
201  if (std::is_constant_evaluated()) {
202  //TODO: We would want to
203  //
204  // assert(SAL_STRING_IS_STATIC(pData));
205  //
206  // here, but that wouldn't work because read of member `str` of OUStringLiteral's
207  // anonymous union with active member `more` is not allowed in a constant expression.
208  } else
209 #endif
210  rtl_uString_acquire( pData );
211  }
212 
213 #if defined LIBO_INTERNAL_ONLY
214 #if !defined(__COVERITY__) // suppress COPY_INSTEAD_OF_MOVE suggestions
221  constexpr
222  OUString( OUString && str ) noexcept
223  {
224  pData = str.pData;
225  if (std::is_constant_evaluated()) {
226  //TODO: We would want to
227  //
228  // assert(SAL_STRING_IS_STATIC(pData));
229  //
230  // here, but that wouldn't work because read of member `str` of OUStringLiteral's
231  // anonymous union with active member `more` is not allowed in a constant expression.
232  return;
233  }
234  str.pData = nullptr;
235  rtl_uString_new( &str.pData );
236  }
237 #endif
238 #endif
239 
245  OUString( rtl_uString * str )
246  {
247  pData = str;
248  rtl_uString_acquire( pData );
249  }
250 
251 #if defined LIBO_INTERNAL_ONLY
253  // Catch inadvertent conversions to the above ctor:
254  OUString(std::nullptr_t) = delete;
256 #endif
257 
266  OUString( rtl_uString * str, __sal_NoAcquire )
267  { pData = str; }
268 
274  explicit OUString( sal_Unicode value )
275  : pData (NULL)
276  {
277  rtl_uString_newFromStr_WithLength( &pData, &value, 1 );
278  }
279 
280 #if defined LIBO_INTERNAL_ONLY && !defined RTL_STRING_UNITTEST_CONCAT
282  // Catch inadvertent conversions to the above ctor (but still allow
283  // construction from char literals):
284  OUString(int) = delete;
285  explicit OUString(char c):
286  OUString(sal_Unicode(static_cast<unsigned char>(c)))
287  {}
289 #endif
290 
291 #if defined LIBO_INTERNAL_ONLY
292 
293  template<typename T> explicit OUString(
294  T const & value,
295  typename libreoffice_internal::CharPtrDetector<T, libreoffice_internal::Dummy>::TypeUtf16
296  = libreoffice_internal::Dummy()):
297  pData(nullptr)
298  { rtl_uString_newFromStr(&pData, value); }
299 
300  template<typename T> explicit OUString(
301  T & value,
302  typename
303  libreoffice_internal::NonConstCharArrayDetector<T, libreoffice_internal::Dummy>::TypeUtf16
304  = libreoffice_internal::Dummy()):
305  pData(nullptr)
306  { rtl_uString_newFromStr(&pData, value); }
307 
308 #else
309 
315  OUString( const sal_Unicode * value )
316  {
317  pData = NULL;
318  rtl_uString_newFromStr( &pData, value );
319  }
320 
321 #endif
322 
331  OUString( const sal_Unicode * value, sal_Int32 length )
332  {
333  pData = NULL;
334  rtl_uString_newFromStr_WithLength( &pData, value, length );
335  }
336 
352  template< typename T >
353  OUString( T& literal, typename libreoffice_internal::ConstCharArrayDetector< T, libreoffice_internal::Dummy >::Type = libreoffice_internal::Dummy() )
354  {
355  assert(
356  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
357  pData = NULL;
358  if SAL_CONSTEXPR (libreoffice_internal::ConstCharArrayDetector<T>::length == 0) {
359  rtl_uString_new(&pData);
360  } else {
361  rtl_uString_newFromLiteral(
362  &pData,
363  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
364  literal),
365  libreoffice_internal::ConstCharArrayDetector<T>::length, 0);
366  }
367 #ifdef RTL_STRING_UNITTEST
368  rtl_string_unittest_const_literal = true;
369 #endif
370  }
371 
372 #if defined LIBO_INTERNAL_ONLY
373  // Rather use a u""_ustr literal (but don't remove this entirely, to avoid implicit support for
374  // it via std::u16string_view from kicking in):
375  template<typename T> OUString(
376  T &,
377  typename libreoffice_internal::ConstCharArrayDetector<
378  T, libreoffice_internal::Dummy>::TypeUtf16
379  = libreoffice_internal::Dummy()) = delete;
380 
381  OUString(OUStringChar c): pData(nullptr) { rtl_uString_newFromStr_WithLength(&pData, &c.c, 1); }
382 #endif
383 
384 #if defined LIBO_INTERNAL_ONLY && defined RTL_STRING_UNITTEST
386 
390  template< typename T >
391  OUString( T&, typename libreoffice_internal::ExceptConstCharArrayDetector< T >::Type = libreoffice_internal::Dummy() )
392  {
393  pData = NULL;
394  rtl_uString_newFromLiteral( &pData, "!!br0ken!!", 10, 0 ); // set to garbage
395  rtl_string_unittest_invalid_conversion = true;
396  }
401  template< typename T >
402  OUString( const T&, typename libreoffice_internal::ExceptCharArrayDetector< T >::Type = libreoffice_internal::Dummy() )
403  {
404  pData = NULL;
405  rtl_uString_newFromLiteral( &pData, "!!br0ken!!", 10, 0 ); // set to garbage
406  rtl_string_unittest_invalid_conversion = true;
407  }
409 #endif
410 
411 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
413 
418  template<std::size_t N> constexpr OUString(OUStringLiteral<N> const & literal):
419  pData(const_cast<rtl_uString *>(&literal.str)) {}
420  template<std::size_t N> OUString(OUStringLiteral<N> &&) = delete;
422 #endif
423 
424 #if defined LIBO_INTERNAL_ONLY
425  // For operator ""_tstr:
426  template<OStringLiteral L> OUString(detail::OStringHolder<L> const & holder) {
427  pData = nullptr;
428  if (holder.literal.getLength() == 0) {
429  rtl_uString_new(&pData);
430  } else {
431  rtl_uString_newFromLiteral(
432  &pData, holder.literal.getStr(), holder.literal.getLength(), 0);
433  }
434  }
435 #endif
436 
451  OUString( const char * value, sal_Int32 length,
452  rtl_TextEncoding encoding,
453  sal_uInt32 convertFlags = OSTRING_TO_OUSTRING_CVTFLAGS )
454  {
455  pData = NULL;
456  rtl_string2UString( &pData, value, length, encoding, convertFlags );
457  if (pData == NULL) {
458  throw std::bad_alloc();
459  }
460  }
461 
478  explicit OUString(
479  sal_uInt32 const * codePoints, sal_Int32 codePointCount):
480  pData(NULL)
481  {
482  rtl_uString_newFromCodePoints(&pData, codePoints, codePointCount);
483  if (pData == NULL) {
484  throw std::bad_alloc();
485  }
486  }
487 
488 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
493  template< typename T1, typename T2 >
494  OUString( OUStringConcat< T1, T2 >&& c )
495  {
496  const sal_Int32 l = c.length();
497  pData = rtl_uString_alloc( l );
498  if (l != 0)
499  {
500  sal_Unicode* end = c.addData( pData->buffer );
501  pData->length = l;
502  *end = '\0';
503  }
504  }
505 
510  template< std::size_t N >
511  OUString( OUStringNumber< N >&& n )
512  : OUString( n.buf, n.length )
513  {}
514 #endif
515 
516 #if defined LIBO_INTERNAL_ONLY
517  explicit OUString(std::u16string_view sv) {
518  if (sv.size() > sal_uInt32(std::numeric_limits<sal_Int32>::max())) {
519  throw std::bad_alloc();
520  }
521  pData = nullptr;
522  rtl_uString_newFromStr_WithLength(&pData, sv.data(), sv.size());
523  }
524 #endif
525 
529 #if defined LIBO_INTERNAL_ONLY
530  constexpr
531 #endif
532  ~OUString()
533  {
534 #if defined LIBO_INTERNAL_ONLY
535  if (std::is_constant_evaluated()) {
536  //TODO: We would want to
537  //
538  // assert(SAL_STRING_IS_STATIC(pData));
539  //
540  // here, but that wouldn't work because read of member `str` of OUStringLiteral's
541  // anonymous union with active member `more` is not allowed in a constant expression.
542  } else
543 #endif
544  rtl_uString_release( pData );
545  }
546 
558  static OUString const & unacquired( rtl_uString * const * ppHandle )
559  { return * reinterpret_cast< OUString const * >( ppHandle ); }
560 
561 #if defined LIBO_INTERNAL_ONLY
574  static OUString const& unacquired(const OUStringBuffer& str);
575 #endif
576 
582  OUString & operator=( const OUString & str )
583  {
584  rtl_uString_assign( &pData, str.pData );
585  return *this;
586  }
587 
588 #if defined LIBO_INTERNAL_ONLY
589 #if !defined(__COVERITY__) // suppress COPY_INSTEAD_OF_MOVE suggestions
596  OUString & operator=( OUString && str ) noexcept
597  {
598  std::swap(pData, str.pData);
599  return *this;
600  }
601 #endif
602 #endif
603 
616  template< typename T >
617  typename libreoffice_internal::ConstCharArrayDetector< T, OUString& >::Type operator=( T& literal )
618  {
619  assert(
620  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
621  if SAL_CONSTEXPR (libreoffice_internal::ConstCharArrayDetector<T>::length == 0) {
622  rtl_uString_new(&pData);
623  } else {
624  rtl_uString_newFromLiteral(
625  &pData,
626  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
627  literal),
628  libreoffice_internal::ConstCharArrayDetector<T>::length, 0);
629  }
630  return *this;
631  }
632 
633 #if defined LIBO_INTERNAL_ONLY
634  // Rather assign from a u""_ustr literal (but don't remove this entirely, to avoid implicit
635  // support for it via std::u16string_view from kicking in):
636  template<typename T>
637  typename
638  libreoffice_internal::ConstCharArrayDetector<T, OUString &>::TypeUtf16
639  operator =(T &) = delete;
640 
641  OUString & operator =(OUStringChar c) {
642  rtl_uString_newFromStr_WithLength(&pData, &c.c, 1);
643  return *this;
644  }
645 
647  template<std::size_t N> OUString & operator =(OUStringLiteral<N> const & literal) {
648  rtl_uString_release(pData);
649  pData = const_cast<rtl_uString *>(&literal.str);
650  return *this;
651  }
652  template<std::size_t N> OUString & operator =(OUStringLiteral<N> &&) = delete;
653 
654  template <std::size_t N>
655  OUString & operator =(OUStringNumber<N> && n) {
656  // n.length should never be zero, so no need to add an optimization for that case
657  rtl_uString_newFromStr_WithLength(&pData, n.buf, n.length);
658  return *this;
659  }
660 
661  OUString & operator =(std::u16string_view sv) {
662  if (sv.empty()) {
663  rtl_uString_new(&pData);
664  } else {
665  rtl_uString_newFromStr_WithLength(&pData, sv.data(), sv.size());
666  }
667  return *this;
668  }
669 #endif
670 
671 #if defined LIBO_INTERNAL_ONLY
680  inline OUString & operator+=( const OUStringBuffer & str ) &;
681 #endif
682 
690  OUString & operator+=( const OUString & str )
691 #if defined LIBO_INTERNAL_ONLY
692  &
693 #endif
694  {
695  return internalAppend(str.pData);
696  }
697 #if defined LIBO_INTERNAL_ONLY
698  void operator+=(OUString const &) && = delete;
699 #endif
700 
707  template<typename T>
708  typename libreoffice_internal::ConstCharArrayDetector<T, OUString &>::Type
709  operator +=(T & literal)
710 #if defined LIBO_INTERNAL_ONLY
711  &
712 #endif
713  {
714  assert(
715  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
716  rtl_uString_newConcatAsciiL(
717  &pData, pData,
718  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
719  libreoffice_internal::ConstCharArrayDetector<T>::length);
720  return *this;
721  }
722 #if defined LIBO_INTERNAL_ONLY
723  template<typename T>
724  typename libreoffice_internal::ConstCharArrayDetector<T, OUString &>::Type
725  operator +=(T &) && = delete;
726 #endif
727 
728 #if defined LIBO_INTERNAL_ONLY
730  template<typename T>
731  typename
732  libreoffice_internal::ConstCharArrayDetector<T, OUString &>::TypeUtf16
733  operator +=(T & literal) & {
734  rtl_uString_newConcatUtf16L(
735  &pData, pData,
736  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
737  libreoffice_internal::ConstCharArrayDetector<T>::length);
738  return *this;
739  }
740  template<typename T>
741  typename
742  libreoffice_internal::ConstCharArrayDetector<T, OUString &>::TypeUtf16
743  operator +=(T &) && = delete;
744 
746  template<std::size_t N> OUString & operator +=(OUStringLiteral<N> const & literal) & {
747  rtl_uString_newConcatUtf16L(&pData, pData, literal.getStr(), literal.getLength());
748  return *this;
749  }
750  template<std::size_t N> void operator +=(OUStringLiteral<N> const &) && = delete;
751 
752  OUString & operator +=(std::u16string_view sv) & {
753  if (sv.size() > sal_uInt32(std::numeric_limits<sal_Int32>::max())) {
754  throw std::bad_alloc();
755  }
756  rtl_uString_newConcatUtf16L(&pData, pData, sv.data(), sv.size());
757  return *this;
758  }
759  void operator +=(std::u16string_view) && = delete;
760 #endif
761 
762 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
767  template< typename T1, typename T2 >
768  OUString& operator+=( OUStringConcat< T1, T2 >&& c ) & {
769  sal_Int32 l = c.length();
770  if( l == 0 )
771  return *this;
772  l += pData->length;
773  rtl_uString_ensureCapacity( &pData, l );
774  sal_Unicode* end = c.addData( pData->buffer + pData->length );
775  *end = '\0';
776  pData->length = l;
777  return *this;
778  }
779  template<typename T1, typename T2> void operator +=(
780  OUStringConcat<T1, T2> &&) && = delete;
781 
786  template< std::size_t N >
787  OUString& operator+=( OUStringNumber< N >&& n ) & {
788  sal_Int32 l = n.length;
789  if( l == 0 )
790  return *this;
791  l += pData->length;
792  rtl_uString_ensureCapacity( &pData, l );
793  sal_Unicode* end = addDataHelper( pData->buffer + pData->length, n.buf, n.length );
794  *end = '\0';
795  pData->length = l;
796  return *this;
797  }
798  template<std::size_t N> void operator +=(
799  OUStringNumber<N> &&) && = delete;
800 #endif
801 
806  void clear()
807  {
808  rtl_uString_new( &pData );
809  }
810 
819  sal_Int32 getLength() const { return pData->length; }
820 
829  bool isEmpty() const
830  {
831  return pData->length == 0;
832  }
833 
841  const sal_Unicode * getStr() const SAL_RETURNS_NONNULL { return pData->buffer; }
842 
852  sal_Unicode operator [](sal_Int32 index) const {
853  // silence spurious -Werror=strict-overflow warnings from GCC 4.8.2
854  assert(index >= 0 && static_cast<sal_uInt32>(index) < static_cast<sal_uInt32>(getLength()));
855  return getStr()[index];
856  }
857 
870 #if defined LIBO_INTERNAL_ONLY
871  sal_Int32 compareTo( std::u16string_view str ) const
872  {
873  return rtl_ustr_compare_WithLength( pData->buffer, pData->length,
874  str.data(), str.length() );
875  }
876 #else
877  sal_Int32 compareTo( const OUString & str ) const
878  {
879  return rtl_ustr_compare_WithLength( pData->buffer, pData->length,
880  str.pData->buffer, str.pData->length );
881  }
882 #endif
883 
899 #if defined LIBO_INTERNAL_ONLY
900  sal_Int32 compareTo( std::u16string_view str, sal_Int32 maxLength ) const
901  {
902  return rtl_ustr_shortenedCompare_WithLength( pData->buffer, pData->length,
903  str.data(), str.length(), maxLength );
904  }
905 #else
906  sal_Int32 compareTo( const OUString & str, sal_Int32 maxLength ) const
907  {
908  return rtl_ustr_shortenedCompare_WithLength( pData->buffer, pData->length,
909  str.pData->buffer, str.pData->length, maxLength );
910  }
911 #endif
912 
925 #if defined LIBO_INTERNAL_ONLY
926  sal_Int32 reverseCompareTo(std::u16string_view sv) const {
927  return rtl_ustr_reverseCompare_WithLength(
928  pData->buffer, pData->length, sv.data(), sv.size());
929  }
930 #else
931  sal_Int32 reverseCompareTo( const OUString & str ) const
932  {
933  return rtl_ustr_reverseCompare_WithLength( pData->buffer, pData->length,
934  str.pData->buffer, str.pData->length );
935  }
936 #endif
937 
943  template< typename T >
944  typename libreoffice_internal::ConstCharArrayDetector< T, sal_Int32 >::Type reverseCompareTo( T& literal ) const
945  {
946  assert(
947  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
948  return rtl_ustr_asciil_reverseCompare_WithLength(
949  pData->buffer, pData->length,
950  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
951  libreoffice_internal::ConstCharArrayDetector<T>::length);
952  }
953 
965  bool equals( const OUString & str ) const
966  {
967  if ( pData->length != str.pData->length )
968  return false;
969  if ( pData == str.pData )
970  return true;
971  return rtl_ustr_reverseCompare_WithLength( pData->buffer, pData->length,
972  str.pData->buffer, str.pData->length ) == 0;
973  }
974 
989 #if defined LIBO_INTERNAL_ONLY
990  bool equalsIgnoreAsciiCase(std::u16string_view sv) const {
991  if ( sal_uInt32(pData->length) != sv.size() )
992  return false;
993  if ( pData->buffer == sv.data() )
994  return true;
995  return
996  rtl_ustr_compareIgnoreAsciiCase_WithLength(
997  pData->buffer, pData->length, sv.data(), sv.size())
998  == 0;
999  }
1000 #else
1001  bool equalsIgnoreAsciiCase( const OUString & str ) const
1002  {
1003  if ( pData->length != str.pData->length )
1004  return false;
1005  if ( pData == str.pData )
1006  return true;
1007  return rtl_ustr_compareIgnoreAsciiCase_WithLength( pData->buffer, pData->length,
1008  str.pData->buffer, str.pData->length ) == 0;
1009  }
1010 #endif
1011 
1027 #if defined LIBO_INTERNAL_ONLY
1028  sal_Int32 compareToIgnoreAsciiCase(std::u16string_view sv) const {
1029  return rtl_ustr_compareIgnoreAsciiCase_WithLength(
1030  pData->buffer, pData->length, sv.data(), sv.size());
1031  }
1032 #else
1033  sal_Int32 compareToIgnoreAsciiCase( const OUString & str ) const
1034  {
1035  return rtl_ustr_compareIgnoreAsciiCase_WithLength( pData->buffer, pData->length,
1036  str.pData->buffer, str.pData->length );
1037  }
1038 #endif
1039 
1045  template< typename T >
1046  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type equalsIgnoreAsciiCase( T& literal ) const
1047  {
1048  assert(
1049  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
1050  return
1051  (pData->length
1052  == libreoffice_internal::ConstCharArrayDetector<T>::length)
1053  && (rtl_ustr_ascii_compareIgnoreAsciiCase_WithLength(
1054  pData->buffer, pData->length,
1055  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
1056  literal))
1057  == 0);
1058  }
1059 
1075 #if defined LIBO_INTERNAL_ONLY
1076  bool match(std::u16string_view sv, sal_Int32 fromIndex = 0) const {
1077  assert(fromIndex >= 0);
1078  return
1079  rtl_ustr_shortenedCompare_WithLength(
1080  pData->buffer + fromIndex, pData->length - fromIndex, sv.data(), sv.size(),
1081  sv.size())
1082  == 0;
1083  }
1084 #else
1085  bool match( const OUString & str, sal_Int32 fromIndex = 0 ) const
1086  {
1087  assert(fromIndex >= 0);
1088  return rtl_ustr_shortenedCompare_WithLength( pData->buffer+fromIndex, pData->length-fromIndex,
1089  str.pData->buffer, str.pData->length, str.pData->length ) == 0;
1090  }
1091 #endif
1092 
1098  template< typename T >
1099  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type match( T& literal, sal_Int32 fromIndex = 0 ) const
1100  {
1101  assert(
1102  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
1103  assert(fromIndex >= 0);
1104  return
1105  rtl_ustr_ascii_shortenedCompare_WithLength(
1106  pData->buffer+fromIndex, pData->length-fromIndex,
1107  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
1108  literal),
1109  libreoffice_internal::ConstCharArrayDetector<T>::length)
1110  == 0;
1111  }
1112 
1131 #if defined LIBO_INTERNAL_ONLY
1132  bool matchIgnoreAsciiCase(std::u16string_view sv, sal_Int32 fromIndex = 0) const {
1133  assert(fromIndex >= 0);
1134  return
1135  rtl_ustr_shortenedCompareIgnoreAsciiCase_WithLength(
1136  pData->buffer + fromIndex, pData->length - fromIndex, sv.data(), sv.size(),
1137  sv.size())
1138  == 0;
1139  }
1140 #else
1141  bool matchIgnoreAsciiCase( const OUString & str, sal_Int32 fromIndex = 0 ) const
1142  {
1143  assert(fromIndex >= 0);
1144  return rtl_ustr_shortenedCompareIgnoreAsciiCase_WithLength( pData->buffer+fromIndex, pData->length-fromIndex,
1145  str.pData->buffer, str.pData->length,
1146  str.pData->length ) == 0;
1147  }
1148 #endif
1149 
1155  template< typename T >
1156  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type matchIgnoreAsciiCase( T& literal, sal_Int32 fromIndex = 0 ) const
1157  {
1158  assert(
1159  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
1160  return matchIgnoreAsciiCaseAsciiL(
1161  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
1162  libreoffice_internal::ConstCharArrayDetector<T>::length, fromIndex);
1163  }
1164 
1181  sal_Int32 compareToAscii( const char* asciiStr ) const
1182  {
1183  return rtl_ustr_ascii_compare_WithLength( pData->buffer, pData->length, asciiStr );
1184  }
1185 
1208  SAL_DEPRECATED(
1209  "replace s1.compareToAscii(s2, strlen(s2)) == 0 with s1.startsWith(s2)")
1210  sal_Int32 compareToAscii( const char * asciiStr, sal_Int32 maxLength ) const
1211  {
1212  return rtl_ustr_ascii_shortenedCompare_WithLength( pData->buffer, pData->length,
1213  asciiStr, maxLength );
1214  }
1215 
1234  sal_Int32 reverseCompareToAsciiL( const char * asciiStr, sal_Int32 asciiStrLength ) const
1235  {
1236  return rtl_ustr_asciil_reverseCompare_WithLength( pData->buffer, pData->length,
1237  asciiStr, asciiStrLength );
1238  }
1239 
1255  bool equalsAscii( const char* asciiStr ) const
1256  {
1257  return rtl_ustr_ascii_compare_WithLength( pData->buffer, pData->length,
1258  asciiStr ) == 0;
1259  }
1260 
1277  bool equalsAsciiL( const char* asciiStr, sal_Int32 asciiStrLength ) const
1278  {
1279  if ( pData->length != asciiStrLength )
1280  return false;
1281 
1282  return rtl_ustr_asciil_reverseEquals_WithLength(
1283  pData->buffer, asciiStr, asciiStrLength );
1284  }
1285 
1304  bool equalsIgnoreAsciiCaseAscii( const char * asciiStr ) const
1305  {
1306  return rtl_ustr_ascii_compareIgnoreAsciiCase_WithLength( pData->buffer, pData->length, asciiStr ) == 0;
1307  }
1308 
1309 #if defined LIBO_INTERNAL_ONLY
1310  bool equalsIgnoreAsciiCaseAscii( std::string_view asciiStr ) const
1311  {
1312  return o3tl::make_unsigned(pData->length) == asciiStr.length()
1313  && rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths(
1314  pData->buffer, pData->length, asciiStr.data(), asciiStr.length()) == 0;
1315  }
1316 #endif
1317 
1336  sal_Int32 compareToIgnoreAsciiCaseAscii( const char * asciiStr ) const
1337  {
1338  return rtl_ustr_ascii_compareIgnoreAsciiCase_WithLength( pData->buffer, pData->length, asciiStr );
1339  }
1340 
1341 #if defined LIBO_INTERNAL_ONLY
1342  sal_Int32 compareToIgnoreAsciiCaseAscii( std::string_view asciiStr ) const
1343  {
1344  sal_Int32 nMax = std::min<size_t>(asciiStr.length(), std::numeric_limits<sal_Int32>::max());
1345  sal_Int32 result = rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths(
1346  pData->buffer, pData->length, asciiStr.data(), nMax);
1347  if (result == 0 && o3tl::make_unsigned(pData->length) < asciiStr.length())
1348  result = -1;
1349  return result;
1350  }
1351 #endif
1352 
1372  bool equalsIgnoreAsciiCaseAsciiL( const char * asciiStr, sal_Int32 asciiStrLength ) const
1373  {
1374  if ( pData->length != asciiStrLength )
1375  return false;
1376 
1377  return rtl_ustr_ascii_compareIgnoreAsciiCase_WithLength( pData->buffer, pData->length, asciiStr ) == 0;
1378  }
1379 
1400  bool matchAsciiL( const char* asciiStr, sal_Int32 asciiStrLength, sal_Int32 fromIndex = 0 ) const
1401  {
1402  assert(fromIndex >= 0);
1403  return rtl_ustr_ascii_shortenedCompare_WithLength( pData->buffer+fromIndex, pData->length-fromIndex,
1404  asciiStr, asciiStrLength ) == 0;
1405  }
1406 
1407  // This overload is left undefined, to detect calls of matchAsciiL that
1408  // erroneously use RTL_CONSTASCII_USTRINGPARAM instead of
1409  // RTL_CONSTASCII_STRINGPARAM (but would lead to ambiguities on 32 bit
1410  // platforms):
1411 #if SAL_TYPES_SIZEOFLONG == 8
1412  void matchAsciiL(char const *, sal_Int32, rtl_TextEncoding) const;
1413 #endif
1414 
1438  bool matchIgnoreAsciiCaseAsciiL( const char* asciiStr, sal_Int32 asciiStrLength, sal_Int32 fromIndex = 0 ) const
1439  {
1440  assert(fromIndex >= 0);
1441  return rtl_ustr_ascii_shortenedCompareIgnoreAsciiCase_WithLength( pData->buffer+fromIndex, pData->length-fromIndex,
1442  asciiStr, asciiStrLength ) == 0;
1443  }
1444 
1445  // This overload is left undefined, to detect calls of
1446  // matchIgnoreAsciiCaseAsciiL that erroneously use
1447  // RTL_CONSTASCII_USTRINGPARAM instead of RTL_CONSTASCII_STRINGPARAM (but
1448  // would lead to ambiguities on 32 bit platforms):
1449 #if SAL_TYPES_SIZEOFLONG == 8
1450  void matchIgnoreAsciiCaseAsciiL(char const *, sal_Int32, rtl_TextEncoding)
1451  const;
1452 #endif
1453 
1454 #if defined LIBO_INTERNAL_ONLY
1465  bool startsWith(std::u16string_view sv) const {
1466  return match(sv);
1467  }
1482  bool startsWith(std::u16string_view sv, OUString * rest) const {
1483  assert(rest);
1484  auto const b = startsWith(sv);
1485  if (b) {
1486  *rest = copy(sv.size());
1487  }
1488  return b;
1489  }
1503  bool startsWith(std::u16string_view sv, std::u16string_view * rest) const {
1504  assert(rest);
1505  auto const b = startsWith(sv);
1506  if (b) {
1507  *rest = subView(sv.size());
1508  }
1509  return b;
1510  }
1511 #else
1526  bool startsWith(OUString const & str, OUString * rest = NULL) const {
1527  bool b = match(str);
1528  if (b && rest != NULL) {
1529  *rest = copy(str.getLength());
1530  }
1531  return b;
1532  }
1533 #endif
1534 
1535 #if defined LIBO_INTERNAL_ONLY
1540  template< typename T >
1541  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type startsWith(
1542  T & literal) const
1543  {
1544  assert(
1545  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
1546  bool b
1547  = (libreoffice_internal::ConstCharArrayDetector<T>::length
1548  <= sal_uInt32(pData->length))
1549  && rtl_ustr_asciil_reverseEquals_WithLength(
1550  pData->buffer,
1551  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
1552  literal),
1553  libreoffice_internal::ConstCharArrayDetector<T>::length);
1554  return b;
1555  }
1561  template< typename T >
1562  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type startsWith(
1563  T & literal, OUString * rest) const
1564  {
1565  assert(rest);
1566  bool b = startsWith(literal);
1567  if (b) {
1568  *rest = copy(
1569  libreoffice_internal::ConstCharArrayDetector<T>::length);
1570  }
1571  return b;
1572  }
1577  template< typename T >
1578  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type startsWith(
1579  T & literal, std::u16string_view * rest) const
1580  {
1581  assert(rest);
1582  bool b = startsWith(literal);
1583  if (b) {
1584  *rest = subView(
1585  libreoffice_internal::ConstCharArrayDetector<T>::length);
1586  }
1587  return b;
1588  }
1589 #else
1595  template< typename T >
1596  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type startsWith(
1597  T & literal, OUString * rest = NULL) const
1598  {
1599  assert(
1600  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
1601  bool b
1602  = (libreoffice_internal::ConstCharArrayDetector<T>::length
1603  <= sal_uInt32(pData->length))
1604  && rtl_ustr_asciil_reverseEquals_WithLength(
1605  pData->buffer,
1606  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
1607  literal),
1608  libreoffice_internal::ConstCharArrayDetector<T>::length);
1609  if (b && rest != NULL) {
1610  *rest = copy(
1611  libreoffice_internal::ConstCharArrayDetector<T>::length);
1612  }
1613  return b;
1614  }
1615 #endif
1616 
1626  bool startsWith(sal_Unicode ch) const
1627  {
1628  return !isEmpty() && pData->buffer[0] == ch;
1629  }
1630 
1643  bool startsWith(sal_Unicode ch, OUString* rest) const {
1644  assert(rest);
1645  bool b = startsWith(ch);
1646 
1647  if (b)
1648  *rest = copy(1);
1649 
1650  return b;
1651  }
1652 
1653 #if defined LIBO_INTERNAL_ONLY
1666  bool startsWith(sal_Unicode ch, std::u16string_view* rest) const {
1667  assert(rest);
1668  bool b = startsWith(ch);
1669 
1670  if (b)
1671  *rest = subView(1);
1672 
1673  return b;
1674  }
1675 #endif
1676 
1697 #if defined LIBO_INTERNAL_ONLY
1698  bool startsWithIgnoreAsciiCase(std::u16string_view sv) const {
1699  return matchIgnoreAsciiCase(sv);
1700  }
1701  bool startsWithIgnoreAsciiCase(std::u16string_view sv, OUString * rest) const {
1702  assert(rest);
1703  auto const b = startsWithIgnoreAsciiCase(sv);
1704  if (b) {
1705  *rest = copy(sv.size());
1706  }
1707  return b;
1708  }
1709  bool startsWithIgnoreAsciiCase(std::u16string_view sv, std::u16string_view * rest) const {
1710  assert(rest);
1711  auto const b = startsWithIgnoreAsciiCase(sv);
1712  if (b) {
1713  *rest = subView(sv.size());
1714  }
1715  return b;
1716  }
1717 #else
1718  bool startsWithIgnoreAsciiCase(OUString const & str, OUString * rest = NULL)
1719  const
1720  {
1721  bool b = matchIgnoreAsciiCase(str);
1722  if (b && rest != NULL) {
1723  *rest = copy(str.getLength());
1724  }
1725  return b;
1726  }
1727 #endif
1728 
1729 #if defined LIBO_INTERNAL_ONLY
1735  template< typename T >
1736  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
1737  startsWithIgnoreAsciiCase(T & literal) const
1738  {
1739  assert(
1740  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
1741  bool b
1742  = (libreoffice_internal::ConstCharArrayDetector<T>::length
1743  <= sal_uInt32(pData->length))
1744  && (rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths(
1745  pData->buffer,
1746  libreoffice_internal::ConstCharArrayDetector<T>::length,
1747  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
1748  literal),
1749  libreoffice_internal::ConstCharArrayDetector<T>::length)
1750  == 0);
1751  return b;
1752  }
1758  template< typename T >
1759  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
1760  startsWithIgnoreAsciiCase(T & literal, OUString * rest) const
1761  {
1762  assert(rest);
1763  bool b = startsWithIgnoreAsciiCase(literal);
1764  if (b) {
1765  *rest = copy(
1766  libreoffice_internal::ConstCharArrayDetector<T>::length);
1767  }
1768  return b;
1769  }
1774  template< typename T >
1775  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
1776  startsWithIgnoreAsciiCase(T & literal, std::u16string_view * rest) const
1777  {
1778  assert(rest);
1779  bool b = startsWithIgnoreAsciiCase(literal);
1780  if (b) {
1781  *rest = subView(
1782  libreoffice_internal::ConstCharArrayDetector<T>::length);
1783  }
1784  return b;
1785  }
1786 #else
1792  template< typename T >
1793  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
1794  startsWithIgnoreAsciiCase(T & literal, OUString * rest = NULL) const
1795  {
1796  assert(
1797  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
1798  bool b
1799  = (libreoffice_internal::ConstCharArrayDetector<T>::length
1800  <= sal_uInt32(pData->length))
1801  && (rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths(
1802  pData->buffer,
1803  libreoffice_internal::ConstCharArrayDetector<T>::length,
1804  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
1805  literal),
1806  libreoffice_internal::ConstCharArrayDetector<T>::length)
1807  == 0);
1808  if (b && rest != NULL) {
1809  *rest = copy(
1810  libreoffice_internal::ConstCharArrayDetector<T>::length);
1811  }
1812  return b;
1813  }
1814 #endif
1815 
1816 #if defined LIBO_INTERNAL_ONLY
1827  bool endsWith(std::u16string_view sv) const {
1828  return sv.size() <= sal_uInt32(pData->length)
1829  && match(sv, pData->length - sv.size());
1830  }
1831  bool endsWith(std::u16string_view sv, OUString * rest) const {
1832  auto const b = endsWith(sv);
1833  if (b && rest != nullptr) {
1834  *rest = copy(0, (pData->length - sv.size()));
1835  }
1836  return b;
1837  }
1851  bool endsWith(std::u16string_view sv, std::u16string_view * rest) const {
1852  assert(rest);
1853  auto const b = endsWith(sv);
1854  if (b) {
1855  *rest = subView(0, (pData->length - sv.size()));
1856  }
1857  return b;
1858  }
1859 #else
1874  bool endsWith(OUString const & str, OUString * rest = NULL) const {
1875  bool b = str.getLength() <= getLength()
1876  && match(str, getLength() - str.getLength());
1877  if (b && rest != NULL) {
1878  *rest = copy(0, getLength() - str.getLength());
1879  }
1880  return b;
1881  }
1882 #endif
1883 
1893  bool endsWith(sal_Unicode ch) const
1894  {
1895  return !isEmpty() && pData->buffer[pData->length - 1] == ch;
1896  }
1897 
1910  bool endsWith(sal_Unicode ch, OUString* rest) const {
1911  assert(rest);
1912  bool b = endsWith(ch);
1913 
1914  if (b)
1915  *rest = copy(0, pData->length - 1);
1916 
1917  return b;
1918  }
1919 
1920 #if defined LIBO_INTERNAL_ONLY
1933  bool endsWith(sal_Unicode ch, std::u16string_view* rest) const {
1934  assert(rest);
1935  bool b = endsWith(ch);
1936 
1937  if (b)
1938  *rest = subView(0, pData->length - 1);
1939 
1940  return b;
1941  }
1942 #endif
1943 
1944 #if defined LIBO_INTERNAL_ONLY
1950  template< typename T >
1951  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
1952  endsWith(T & literal) const
1953  {
1954  assert(
1955  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
1956  bool b
1957  = (libreoffice_internal::ConstCharArrayDetector<T>::length
1958  <= sal_uInt32(pData->length))
1959  && rtl_ustr_asciil_reverseEquals_WithLength(
1960  (pData->buffer + pData->length
1961  - libreoffice_internal::ConstCharArrayDetector<T>::length),
1962  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
1963  literal),
1964  libreoffice_internal::ConstCharArrayDetector<T>::length);
1965  return b;
1966  }
1967  template< typename T >
1968  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
1969  endsWith(T & literal, OUString * rest) const
1970  {
1971  assert(rest);
1972  bool b = endsWith(literal);
1973  if (b) {
1974  *rest = copy(
1975  0,
1976  (getLength()
1977  - libreoffice_internal::ConstCharArrayDetector<T>::length));
1978  }
1979  return b;
1980  }
1981  template< typename T >
1982  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
1983  endsWith(T & literal, std::u16string_view * rest) const
1984  {
1985  assert(rest);
1986  bool b = endsWith(literal);
1987  if (b) {
1988  *rest = subView(
1989  0,
1990  (getLength()
1991  - libreoffice_internal::ConstCharArrayDetector<T>::length));
1992  }
1993  return b;
1994  }
1995 #else
2001  template< typename T >
2002  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
2003  endsWith(T & literal, OUString * rest = NULL) const
2004  {
2005  assert(
2006  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
2007  bool b
2008  = (libreoffice_internal::ConstCharArrayDetector<T>::length
2009  <= sal_uInt32(pData->length))
2010  && rtl_ustr_asciil_reverseEquals_WithLength(
2011  (pData->buffer + pData->length
2012  - libreoffice_internal::ConstCharArrayDetector<T>::length),
2013  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
2014  literal),
2015  libreoffice_internal::ConstCharArrayDetector<T>::length);
2016  if (b && rest != NULL) {
2017  *rest = copy(
2018  0,
2019  (getLength()
2020  - libreoffice_internal::ConstCharArrayDetector<T>::length));
2021  }
2022  return b;
2023  }
2024 #endif
2025 
2037  bool endsWithAsciiL(char const * asciiStr, sal_Int32 asciiStrLength)
2038  const
2039  {
2040  return asciiStrLength <= pData->length
2041  && rtl_ustr_asciil_reverseEquals_WithLength(
2042  pData->buffer + pData->length - asciiStrLength, asciiStr,
2043  asciiStrLength);
2044  }
2045 
2046 #if defined LIBO_INTERNAL_ONLY
2067  bool endsWithIgnoreAsciiCase(std::u16string_view sv) const {
2068  return sv.size() <= sal_uInt32(pData->length)
2069  && matchIgnoreAsciiCase(sv, pData->length - sv.size());
2070  }
2071  bool endsWithIgnoreAsciiCase(std::u16string_view sv, OUString * rest) const {
2072  auto const b = endsWithIgnoreAsciiCase(sv);
2073  if (b && rest != nullptr) {
2074  *rest = copy(0, pData->length - sv.size());
2075  }
2076  return b;
2077  }
2097  bool endsWithIgnoreAsciiCase(std::u16string_view sv, std::u16string_view * rest) const {
2098  assert(rest);
2099  auto const b = endsWithIgnoreAsciiCase(sv);
2100  if (b) {
2101  *rest = subView(0, pData->length - sv.size());
2102  }
2103  return b;
2104  }
2105 #else
2126  bool endsWithIgnoreAsciiCase(OUString const & str, OUString * rest = NULL) const
2127  {
2128  bool b = str.getLength() <= getLength()
2129  && matchIgnoreAsciiCase(str, getLength() - str.getLength());
2130  if (b && rest != NULL) {
2131  *rest = copy(0, getLength() - str.getLength());
2132  }
2133  return b;
2134  }
2135 #endif
2136 
2137 #if defined LIBO_INTERNAL_ONLY
2142  template< typename T >
2143  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
2144  endsWithIgnoreAsciiCase(T & literal) const
2145  {
2146  assert(
2147  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
2148  bool b
2149  = (libreoffice_internal::ConstCharArrayDetector<T>::length
2150  <= sal_uInt32(pData->length))
2151  && (rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths(
2152  (pData->buffer + pData->length
2153  - libreoffice_internal::ConstCharArrayDetector<T>::length),
2154  libreoffice_internal::ConstCharArrayDetector<T>::length,
2155  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
2156  literal),
2157  libreoffice_internal::ConstCharArrayDetector<T>::length)
2158  == 0);
2159  return b;
2160  }
2165  template< typename T >
2166  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
2167  endsWithIgnoreAsciiCase(T & literal, std::u16string_view * rest) const
2168  {
2169  assert(rest);
2170  bool b = endsWithIgnoreAsciiCase(literal);
2171  if (b) {
2172  *rest = subView(
2173  0,
2174  (getLength()
2175  - libreoffice_internal::ConstCharArrayDetector<T>::length));
2176  }
2177  return b;
2178  }
2179 #else
2185  template< typename T >
2186  typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type
2187  endsWithIgnoreAsciiCase(T & literal, OUString * rest = NULL) const
2188  {
2189  assert(
2190  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
2191  bool b
2192  = (libreoffice_internal::ConstCharArrayDetector<T>::length
2193  <= sal_uInt32(pData->length))
2194  && (rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths(
2195  (pData->buffer + pData->length
2196  - libreoffice_internal::ConstCharArrayDetector<T>::length),
2197  libreoffice_internal::ConstCharArrayDetector<T>::length,
2198  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
2199  literal),
2200  libreoffice_internal::ConstCharArrayDetector<T>::length)
2201  == 0);
2202  if (b && rest != NULL) {
2203  *rest = copy(
2204  0,
2205  (getLength()
2206  - libreoffice_internal::ConstCharArrayDetector<T>::length));
2207  }
2208  return b;
2209  }
2210 #endif
2211 
2222  bool endsWithIgnoreAsciiCaseAsciiL(
2223  char const * asciiStr, sal_Int32 asciiStrLength) const
2224  {
2225  return asciiStrLength <= pData->length
2226  && (rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths(
2227  pData->buffer + pData->length - asciiStrLength,
2228  asciiStrLength, asciiStr, asciiStrLength)
2229  == 0);
2230  }
2231 
2232  friend bool operator == ( const OUString& rStr1, const OUString& rStr2 )
2233  { return rStr1.equals(rStr2); }
2234 
2235  friend bool operator != ( const OUString& rStr1, const OUString& rStr2 )
2236  { return !(operator == ( rStr1, rStr2 )); }
2237 
2238  friend bool operator < ( const OUString& rStr1, const OUString& rStr2 )
2239  { return rStr1.compareTo( rStr2 ) < 0; }
2240  friend bool operator > ( const OUString& rStr1, const OUString& rStr2 )
2241  { return rStr1.compareTo( rStr2 ) > 0; }
2242  friend bool operator <= ( const OUString& rStr1, const OUString& rStr2 )
2243  { return rStr1.compareTo( rStr2 ) <= 0; }
2244  friend bool operator >= ( const OUString& rStr1, const OUString& rStr2 )
2245  { return rStr1.compareTo( rStr2 ) >= 0; }
2246 
2247 #if defined LIBO_INTERNAL_ONLY
2248 
2249  template<typename T> friend typename libreoffice_internal::CharPtrDetector<T, bool>::TypeUtf16
2250  operator ==(OUString const & s1, T const & s2) {
2251  return rtl_ustr_compare_WithLength(s1.getStr(), s1.getLength(), s2, rtl_ustr_getLength(s2))
2252  == 0;
2253  }
2254 
2255  template<typename T>
2256  friend typename libreoffice_internal::NonConstCharArrayDetector<T, bool>::TypeUtf16
2257  operator ==(OUString const & s1, T & s2) {
2258  return rtl_ustr_compare_WithLength(s1.getStr(), s1.getLength(), s2, rtl_ustr_getLength(s2))
2259  == 0;
2260  }
2261 
2262  template<typename T> friend typename libreoffice_internal::CharPtrDetector<T, bool>::TypeUtf16
2263  operator ==(T const & s1, OUString const & s2) {
2264  return rtl_ustr_compare_WithLength(s1, rtl_ustr_getLength(s1), s2.getStr(), s2.getLength())
2265  == 0;
2266  }
2267 
2268  template<typename T>
2269  friend typename libreoffice_internal::NonConstCharArrayDetector<T, bool>::TypeUtf16
2270  operator ==(T & s1, OUString const & s2) {
2271  return rtl_ustr_compare_WithLength(s1, rtl_ustr_getLength(s1), s2.getStr(), s2.getLength())
2272  == 0;
2273  }
2274 
2275  template<typename T> friend typename libreoffice_internal::CharPtrDetector<T, bool>::TypeUtf16
2276  operator !=(OUString const & s1, T const & s2) { return !(s1 == s2); }
2277 
2278  template<typename T>
2279  friend typename libreoffice_internal::NonConstCharArrayDetector<T, bool>::TypeUtf16
2280  operator !=(OUString const & s1, T & s2) { return !(s1 == s2); }
2281 
2282  template<typename T> friend typename libreoffice_internal::CharPtrDetector<T, bool>::TypeUtf16
2283  operator !=(T const & s1, OUString const & s2) { return !(s1 == s2); }
2284 
2285  template<typename T>
2286  friend typename libreoffice_internal::NonConstCharArrayDetector<T, bool>::TypeUtf16
2287  operator !=(T & s1, OUString const & s2) { return !(s1 == s2); }
2288 
2289 #else
2290 
2291  friend bool operator == ( const OUString& rStr1, const sal_Unicode * pStr2 )
2292  { return rStr1.compareTo( pStr2 ) == 0; }
2293  friend bool operator == ( const sal_Unicode * pStr1, const OUString& rStr2 )
2294  { return OUString( pStr1 ).compareTo( rStr2 ) == 0; }
2295 
2296  friend bool operator != ( const OUString& rStr1, const sal_Unicode * pStr2 )
2297  { return !(operator == ( rStr1, pStr2 )); }
2298  friend bool operator != ( const sal_Unicode * pStr1, const OUString& rStr2 )
2299  { return !(operator == ( pStr1, rStr2 )); }
2300 
2301 #endif
2302 
2310  template< typename T >
2311  friend typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type operator==( const OUString& rString, T& literal )
2312  {
2313  assert(
2314  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
2315  return rString.equalsAsciiL(
2316  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
2317  libreoffice_internal::ConstCharArrayDetector<T>::length);
2318  }
2326  template< typename T >
2327  friend typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type operator==( T& literal, const OUString& rString )
2328  {
2329  assert(
2330  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
2331  return rString.equalsAsciiL(
2332  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
2333  libreoffice_internal::ConstCharArrayDetector<T>::length);
2334  }
2342  template< typename T >
2343  friend typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type operator!=( const OUString& rString, T& literal )
2344  {
2345  assert(
2346  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
2347  return !rString.equalsAsciiL(
2348  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
2349  libreoffice_internal::ConstCharArrayDetector<T>::length);
2350  }
2358  template< typename T >
2359  friend typename libreoffice_internal::ConstCharArrayDetector< T, bool >::Type operator!=( T& literal, const OUString& rString )
2360  {
2361  assert(
2362  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
2363  return !rString.equalsAsciiL(
2364  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
2365  libreoffice_internal::ConstCharArrayDetector<T>::length);
2366  }
2367 
2368 #if defined LIBO_INTERNAL_ONLY
2370  template<typename T> friend typename libreoffice_internal::ConstCharArrayDetector<T, bool>::TypeUtf16
2371  operator ==(OUString const & string, T & literal) {
2372  return
2373  rtl_ustr_reverseCompare_WithLength(
2374  string.pData->buffer, string.pData->length,
2375  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
2376  literal),
2377  libreoffice_internal::ConstCharArrayDetector<T>::length)
2378  == 0;
2379  }
2381  template<typename T> friend typename libreoffice_internal::ConstCharArrayDetector<T, bool>::TypeUtf16
2382  operator ==(T & literal, OUString const & string) {
2383  return
2384  rtl_ustr_reverseCompare_WithLength(
2385  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
2386  literal),
2387  libreoffice_internal::ConstCharArrayDetector<T>::length,
2388  string.pData->buffer, string.pData->length)
2389  == 0;
2390  }
2392  template<typename T> friend typename libreoffice_internal::ConstCharArrayDetector<T, bool>::TypeUtf16
2393  operator !=(OUString const & string, T & literal) {
2394  return
2395  rtl_ustr_reverseCompare_WithLength(
2396  string.pData->buffer, string.pData->length,
2397  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
2398  literal),
2399  libreoffice_internal::ConstCharArrayDetector<T>::length)
2400  != 0;
2401  }
2403  template<typename T> friend typename libreoffice_internal::ConstCharArrayDetector<T, bool>::TypeUtf16
2404  operator !=(T & literal, OUString const & string) {
2405  return
2406  rtl_ustr_reverseCompare_WithLength(
2407  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(
2408  literal),
2409  libreoffice_internal::ConstCharArrayDetector<T>::length,
2410  string.pData->buffer, string.pData->length)
2411  != 0;
2412  }
2413 #endif
2414 
2422  sal_Int32 hashCode() const
2423  {
2424  return rtl_ustr_hashCode_WithLength( pData->buffer, pData->length );
2425  }
2426 
2440  sal_Int32 indexOf( sal_Unicode ch, sal_Int32 fromIndex = 0 ) const
2441  {
2442  assert(fromIndex >= 0);
2443  sal_Int32 ret = rtl_ustr_indexOfChar_WithLength( pData->buffer+fromIndex, pData->length-fromIndex, ch );
2444  return (ret < 0 ? ret : ret+fromIndex);
2445  }
2446 
2456  sal_Int32 lastIndexOf( sal_Unicode ch ) const
2457  {
2458  return rtl_ustr_lastIndexOfChar_WithLength( pData->buffer, pData->length, ch );
2459  }
2460 
2473  sal_Int32 lastIndexOf( sal_Unicode ch, sal_Int32 fromIndex ) const
2474  {
2475  return rtl_ustr_lastIndexOfChar_WithLength( pData->buffer, fromIndex, ch );
2476  }
2477 
2493 #if defined LIBO_INTERNAL_ONLY
2494  sal_Int32 indexOf(std::u16string_view sv, sal_Int32 fromIndex = 0) const {
2495  assert(fromIndex >= 0);
2496  auto const n = rtl_ustr_indexOfStr_WithLength(
2497  pData->buffer + fromIndex, pData->length - fromIndex, sv.data(), sv.size());
2498  return n < 0 ? n : n + fromIndex;
2499  }
2500 #else
2501  sal_Int32 indexOf( const OUString & str, sal_Int32 fromIndex = 0 ) const
2502  {
2503  assert(fromIndex >= 0);
2504  sal_Int32 ret = rtl_ustr_indexOfStr_WithLength( pData->buffer+fromIndex, pData->length-fromIndex,
2505  str.pData->buffer, str.pData->length );
2506  return (ret < 0 ? ret : ret+fromIndex);
2507  }
2508 #endif
2509 
2515  template< typename T >
2516  typename libreoffice_internal::ConstCharArrayDetector< T, sal_Int32 >::Type indexOf( T& literal, sal_Int32 fromIndex = 0 ) const
2517  {
2518  assert(
2519  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
2520  assert(fromIndex >= 0);
2521  sal_Int32 n = rtl_ustr_indexOfAscii_WithLength(
2522  pData->buffer + fromIndex, pData->length - fromIndex,
2523  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
2524  libreoffice_internal::ConstCharArrayDetector<T>::length);
2525  return n < 0 ? n : n + fromIndex;
2526  }
2527 
2551  sal_Int32 indexOfAsciiL(
2552  char const * str, sal_Int32 len, sal_Int32 fromIndex = 0) const
2553  {
2554  assert(fromIndex >= 0);
2555  sal_Int32 ret = rtl_ustr_indexOfAscii_WithLength(
2556  pData->buffer + fromIndex, pData->length - fromIndex, str, len);
2557  return ret < 0 ? ret : ret + fromIndex;
2558  }
2559 
2560  // This overload is left undefined, to detect calls of indexOfAsciiL that
2561  // erroneously use RTL_CONSTASCII_USTRINGPARAM instead of
2562  // RTL_CONSTASCII_STRINGPARAM (but would lead to ambiguities on 32 bit
2563  // platforms):
2564 #if SAL_TYPES_SIZEOFLONG == 8
2565  void indexOfAsciiL(char const *, sal_Int32 len, rtl_TextEncoding) const;
2566 #endif
2567 
2583 #if defined LIBO_INTERNAL_ONLY
2584  sal_Int32 lastIndexOf(std::u16string_view sv) const {
2585  return rtl_ustr_lastIndexOfStr_WithLength(
2586  pData->buffer, pData->length, sv.data(), sv.size());
2587  }
2588 #else
2589  sal_Int32 lastIndexOf( const OUString & str ) const
2590  {
2591  return rtl_ustr_lastIndexOfStr_WithLength( pData->buffer, pData->length,
2592  str.pData->buffer, str.pData->length );
2593  }
2594 #endif
2595 
2613 #if defined LIBO_INTERNAL_ONLY
2614  sal_Int32 lastIndexOf(std::u16string_view sv, sal_Int32 fromIndex) const {
2615  return rtl_ustr_lastIndexOfStr_WithLength(pData->buffer, fromIndex, sv.data(), sv.size());
2616  }
2617 #else
2618  sal_Int32 lastIndexOf( const OUString & str, sal_Int32 fromIndex ) const
2619  {
2620  return rtl_ustr_lastIndexOfStr_WithLength( pData->buffer, fromIndex,
2621  str.pData->buffer, str.pData->length );
2622  }
2623 #endif
2624 
2630  template< typename T >
2631  typename libreoffice_internal::ConstCharArrayDetector< T, sal_Int32 >::Type lastIndexOf( T& literal ) const
2632  {
2633  assert(
2634  libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
2635  return rtl_ustr_lastIndexOfAscii_WithLength(
2636  pData->buffer, pData->length,
2637  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
2638  libreoffice_internal::ConstCharArrayDetector<T>::length);
2639  }
2640 
2660  sal_Int32 lastIndexOfAsciiL(char const * str, sal_Int32 len) const
2661  {
2662  return rtl_ustr_lastIndexOfAscii_WithLength(
2663  pData->buffer, pData->length, str, len);
2664  }
2665 
2676  SAL_WARN_UNUSED_RESULT OUString copy( sal_Int32 beginIndex ) const
2677  {
2678  return copy(beginIndex, getLength() - beginIndex);
2679  }
2680 
2693  SAL_WARN_UNUSED_RESULT OUString copy( sal_Int32 beginIndex, sal_Int32 count ) const
2694  {
2695  rtl_uString *pNew = NULL;
2696  rtl_uString_newFromSubString( &pNew, pData, beginIndex, count );
2697  return OUString( pNew, SAL_NO_ACQUIRE );
2698  }
2699 
2700 #if defined LIBO_INTERNAL_ONLY
2711  SAL_WARN_UNUSED_RESULT std::u16string_view subView( sal_Int32 beginIndex ) const
2712  {
2713  assert(beginIndex >= 0);
2714  assert(beginIndex <= getLength());
2715  return subView(beginIndex, getLength() - beginIndex);
2716  }
2717 
2730  SAL_WARN_UNUSED_RESULT std::u16string_view subView( sal_Int32 beginIndex, sal_Int32 count ) const
2731  {
2732  assert(beginIndex >= 0);
2733  assert(count >= 0);
2734  assert(beginIndex <= getLength());
2735  assert(count <= getLength() - beginIndex);
2736  return std::u16string_view(*this).substr(beginIndex, count);
2737  }
2738 #endif
2739 
2740 #ifndef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
2749  SAL_WARN_UNUSED_RESULT OUString concat( const OUString & str ) const
2750  {
2751  rtl_uString* pNew = NULL;
2752  rtl_uString_newConcat( &pNew, pData, str.pData );
2753  return OUString( pNew, SAL_NO_ACQUIRE );
2754  }
2755 #endif
2756 
2757 #ifndef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
2758  friend OUString operator+( const OUString& rStr1, const OUString& rStr2 )
2759  {
2760  return rStr1.concat( rStr2 );
2761  }
2762 #endif
2763 
2777  SAL_WARN_UNUSED_RESULT OUString replaceAt( sal_Int32 index, sal_Int32 count, const OUString& newStr ) const
2778  {
2779  rtl_uString* pNew = NULL;
2780  rtl_uString_newReplaceStrAt( &pNew, pData, index, count, newStr.pData );
2781  return OUString( pNew, SAL_NO_ACQUIRE );
2782  }
2783 
2784 #ifdef LIBO_INTERNAL_ONLY
2785  SAL_WARN_UNUSED_RESULT OUString replaceAt( sal_Int32 index, sal_Int32 count, std::u16string_view newStr ) const
2786  {
2787  rtl_uString* pNew = NULL;
2788  rtl_uString_newReplaceStrAtUtf16L( &pNew, pData, index, count, newStr.data(), newStr.size() );
2789  return OUString( pNew, SAL_NO_ACQUIRE );
2790  }
2791  // Disambiguation
2792  template <std::size_t N>
2793  SAL_WARN_UNUSED_RESULT OUString replaceAt( sal_Int32 index, sal_Int32 count, const sal_Unicode (&newStr)[N] ) const
2794  {
2795  return replaceAt(index, count, std::u16string_view(newStr, N - 1));
2796  }
2797  template <class T, std::enable_if_t<std::is_convertible_v<T, std::u16string_view>, int> = 0>
2798  SAL_WARN_UNUSED_RESULT OUString replaceAt( sal_Int32 index, sal_Int32 count, const T& newStr ) const
2799  {
2800  return replaceAt(index, count, std::u16string_view(newStr));
2801  }
2802 #endif
2803 
2817  SAL_WARN_UNUSED_RESULT OUString replace( sal_Unicode oldChar, sal_Unicode newChar ) const
2818  {
2819  rtl_uString* pNew = NULL;
2820  rtl_uString_newReplace( &pNew, pData, oldChar, newChar );
2821  return OUString( pNew, SAL_NO_ACQUIRE );
2822  }
2823 
2842 #if defined LIBO_INTERNAL_ONLY
2843  [[nodiscard]] OUString replaceFirst(
2844  std::u16string_view from, std::u16string_view to, sal_Int32 * index = nullptr) const
2845  {
2846  rtl_uString * s = nullptr;
2847  sal_Int32 i = 0;
2848  rtl_uString_newReplaceFirstUtf16LUtf16L(
2849  &s, pData, from.data(), from.size(), to.data(), to.size(),
2850  index == nullptr ? &i : index);
2851  return OUString(s, SAL_NO_ACQUIRE);
2852  }
2853 #else
2854  SAL_WARN_UNUSED_RESULT OUString replaceFirst(
2855  OUString const & from, OUString const & to, sal_Int32 * index = NULL) const
2856  {
2857  rtl_uString * s = NULL;
2858  sal_Int32 i = 0;
2859  rtl_uString_newReplaceFirst(
2860  &s, pData, from.pData, to.pData, index == NULL ? &i : index);
2861  return OUString(s, SAL_NO_ACQUIRE);
2862  }
2863 #endif
2864 
2883 #if defined LIBO_INTERNAL_ONLY
2884  template<typename T> [[nodiscard]]
2885  typename libreoffice_internal::ConstCharArrayDetector<T, OUString >::Type replaceFirst(
2886  T & from, std::u16string_view to, sal_Int32 * index = nullptr) const
2887  {
2888  assert(libreoffice_internal::ConstCharArrayDetector<T>::isValid(from));
2889  rtl_uString * s = nullptr;
2890  sal_Int32 i = 0;
2891  rtl_uString_newReplaceFirstAsciiLUtf16L(
2892  &s, pData, libreoffice_internal::ConstCharArrayDetector<T>::toPointer(from),
2893  libreoffice_internal::ConstCharArrayDetector<T>::length, to.data(), to.size(),
2894  index == nullptr ? &i : index);
2895  return OUString(s, SAL_NO_ACQUIRE);
2896  }
2897 #else
2898  template< typename T >
2899  SAL_WARN_UNUSED_RESULT typename libreoffice_internal::ConstCharArrayDetector< T, OUString >::Type replaceFirst( T& from, OUString const & to,
2900  sal_Int32 * index = NULL) const
2901  {
2902  assert(libreoffice_internal::ConstCharArrayDetector<T>::isValid(from));
2903  rtl_uString * s = NULL;
2904  sal_Int32 i = 0;
2905  rtl_uString_newReplaceFirstAsciiL(
2906  &s, pData,
2907  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(from),
2908  libreoffice_internal::ConstCharArrayDetector<T>::length, to.pData,
2909  index == NULL ? &i : index);
2910  return OUString(s, SAL_NO_ACQUIRE);
2911  }
2912 #endif
2913 
2932 #if defined LIBO_INTERNAL_ONLY
2933  template<typename T> [[nodiscard]]
2934  typename libreoffice_internal::ConstCharArrayDetector<T, OUString >::Type replaceFirst(
2935  std::u16string_view from, T & to, sal_Int32 * index = nullptr) const
2936  {
2937  assert(libreoffice_internal::ConstCharArrayDetector<T>::isValid(to));
2938  rtl_uString * s = nullptr;
2939  sal_Int32 i = 0;
2940  rtl_uString_newReplaceFirstUtf16LAsciiL(
2941  &s, pData, from.data(), from.size(),
2942  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(to),
2943  libreoffice_internal::ConstCharArrayDetector<T>::length, index == nullptr ? &i : index);
2944  return OUString(s, SAL_NO_ACQUIRE);
2945  }
2946 #else
2947  template< typename T >
2948  SAL_WARN_UNUSED_RESULT typename libreoffice_internal::ConstCharArrayDetector< T, OUString >::Type replaceFirst( OUString const & from, T& to,
2949  sal_Int32 * index = NULL) const
2950  {
2951  assert(libreoffice_internal::ConstCharArrayDetector<T>::isValid(to));
2952  rtl_uString * s = NULL;
2953  sal_Int32 i = 0;
2954  rtl_uString_newReplaceFirstToAsciiL(
2955  &s, pData, from.pData,
2956  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(to),
2957  libreoffice_internal::ConstCharArrayDetector<T>::length,
2958  index == NULL ? &i : index);
2959  return OUString(s, SAL_NO_ACQUIRE);
2960  }
2961 #endif
2962 
2981  template< typename T1, typename T2 >
2982  SAL_WARN_UNUSED_RESULT typename libreoffice_internal::ConstCharArrayDetector< T1, typename libreoffice_internal::ConstCharArrayDetector< T2, OUString >::Type >::Type
2983  replaceFirst( T1& from, T2& to, sal_Int32 * index = NULL) const
2984  {
2985  assert(libreoffice_internal::ConstCharArrayDetector<T1>::isValid(from));
2986  assert(libreoffice_internal::ConstCharArrayDetector<T2>::isValid(to));
2987  rtl_uString * s = NULL;
2988  sal_Int32 i = 0;
2989  rtl_uString_newReplaceFirstAsciiLAsciiL(
2990  &s, pData,
2991  libreoffice_internal::ConstCharArrayDetector<T1>::toPointer(from),
2992  libreoffice_internal::ConstCharArrayDetector<T1>::length,
2993  libreoffice_internal::ConstCharArrayDetector<T2>::toPointer(to),
2994  libreoffice_internal::ConstCharArrayDetector<T2>::length,
2995  index == NULL ? &i : index);
2996  return OUString(s, SAL_NO_ACQUIRE);
2997  }
2998 
3014 #if defined LIBO_INTERNAL_ONLY
3015  [[nodiscard]] OUString replaceAll(
3016  std::u16string_view from, std::u16string_view to, sal_Int32 fromIndex = 0) const
3017  {
3018  rtl_uString * s = nullptr;
3019  rtl_uString_newReplaceAllFromIndexUtf16LUtf16L(
3020  &s, pData, from.data(), from.size(), to.data(), to.size(), fromIndex);
3021  return OUString(s, SAL_NO_ACQUIRE);
3022  }
3023 #else
3024  SAL_WARN_UNUSED_RESULT OUString replaceAll(
3025  OUString const & from, OUString const & to, sal_Int32 fromIndex = 0) const
3026  {
3027  rtl_uString * s = NULL;
3028  rtl_uString_newReplaceAllFromIndex(&s, pData, from.pData, to.pData, fromIndex);
3029  return OUString(s, SAL_NO_ACQUIRE);
3030  }
3031 #endif
3032 
3046 #if defined LIBO_INTERNAL_ONLY
3047  template<typename T> [[nodiscard]]
3048  typename libreoffice_internal::ConstCharArrayDetector<T, OUString >::Type replaceAll(
3049  T & from, std::u16string_view to) const
3050  {
3051  assert(libreoffice_internal::ConstCharArrayDetector<T>::isValid(from));
3052  rtl_uString * s = nullptr;
3053  rtl_uString_newReplaceAllAsciiLUtf16L(
3054  &s, pData, libreoffice_internal::ConstCharArrayDetector<T>::toPointer(from),
3055  libreoffice_internal::ConstCharArrayDetector<T>::length, to.data(), to.size());
3056  return OUString(s, SAL_NO_ACQUIRE);
3057  }
3058 #else
3059  template< typename T >
3060  SAL_WARN_UNUSED_RESULT typename libreoffice_internal::ConstCharArrayDetector< T, OUString >::Type replaceAll( T& from, OUString const & to) const
3061  {
3062  assert(libreoffice_internal::ConstCharArrayDetector<T>::isValid(from));
3063  rtl_uString * s = NULL;
3064  rtl_uString_newReplaceAllAsciiL(
3065  &s, pData,
3066  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(from),
3067  libreoffice_internal::ConstCharArrayDetector<T>::length, to.pData);
3068  return OUString(s, SAL_NO_ACQUIRE);
3069  }
3070 #endif
3071 
3085 #if defined LIBO_INTERNAL_ONLY
3086  template<typename T> [[nodiscard]]
3087  typename libreoffice_internal::ConstCharArrayDetector<T, OUString >::Type replaceAll(
3088  std::u16string_view from, T & to) const
3089  {
3090  assert(libreoffice_internal::ConstCharArrayDetector<T>::isValid(to));
3091  rtl_uString * s = nullptr;
3092  rtl_uString_newReplaceAllUtf16LAsciiL(
3093  &s, pData, from.data(), from.size(),
3094  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(to),
3095  libreoffice_internal::ConstCharArrayDetector<T>::length);
3096  return OUString(s, SAL_NO_ACQUIRE);
3097  }
3098 #else
3099  template< typename T >
3100  SAL_WARN_UNUSED_RESULT typename libreoffice_internal::ConstCharArrayDetector< T, OUString >::Type replaceAll( OUString const & from, T& to) const
3101  {
3102  assert(libreoffice_internal::ConstCharArrayDetector<T>::isValid(to));
3103  rtl_uString * s = NULL;
3104  rtl_uString_newReplaceAllToAsciiL(
3105  &s, pData, from.pData,
3106  libreoffice_internal::ConstCharArrayDetector<T>::toPointer(to),
3107  libreoffice_internal::ConstCharArrayDetector<T>::length);
3108  return OUString(s, SAL_NO_ACQUIRE);
3109  }
3110 #endif
3111 
3125  template< typename T1, typename T2 >
3126  SAL_WARN_UNUSED_RESULT typename libreoffice_internal::ConstCharArrayDetector< T1, typename libreoffice_internal::ConstCharArrayDetector< T2, OUString >::Type >::Type
3127  replaceAll( T1& from, T2& to ) const
3128  {
3129  assert(libreoffice_internal::ConstCharArrayDetector<T1>::isValid(from));
3130  assert(libreoffice_internal::ConstCharArrayDetector<T2>::isValid(to));
3131  rtl_uString * s = NULL;
3132  rtl_uString_newReplaceAllAsciiLAsciiL(
3133  &s, pData,
3134  libreoffice_internal::ConstCharArrayDetector<T1>::toPointer(from),
3135  libreoffice_internal::ConstCharArrayDetector<T1>::length,
3136  libreoffice_internal::ConstCharArrayDetector<T2>::toPointer(to),
3137  libreoffice_internal::ConstCharArrayDetector<T2>::length);
3138  return OUString(s, SAL_NO_ACQUIRE);
3139  }
3140 
3151  SAL_WARN_UNUSED_RESULT OUString toAsciiLowerCase() const
3152  {
3153  rtl_uString* pNew = NULL;
3154  rtl_uString_newToAsciiLowerCase( &pNew, pData );
3155  return OUString( pNew, SAL_NO_ACQUIRE );
3156  }
3157 
3168  SAL_WARN_UNUSED_RESULT OUString toAsciiUpperCase() const
3169  {
3170  rtl_uString* pNew = NULL;
3171  rtl_uString_newToAsciiUpperCase( &pNew, pData );
3172  return OUString( pNew, SAL_NO_ACQUIRE );
3173  }
3174 
3188  SAL_WARN_UNUSED_RESULT OUString trim() const
3189  {
3190  rtl_uString* pNew = NULL;
3191  rtl_uString_newTrim( &pNew, pData );
3192  return OUString( pNew, SAL_NO_ACQUIRE );
3193  }
3194 
3219  OUString getToken( sal_Int32 token, sal_Unicode cTok, sal_Int32& index ) const
3220  {
3221  rtl_uString * pNew = NULL;
3222  index = rtl_uString_getToken( &pNew, pData, token, cTok, index );
3223  return OUString( pNew, SAL_NO_ACQUIRE );
3224  }
3225 
3239  OUString getToken(sal_Int32 count, sal_Unicode separator) const {
3240  sal_Int32 n = 0;
3241  return getToken(count, separator, n);
3242  }
3243 
3252  bool toBoolean() const
3253  {
3254  return rtl_ustr_toBoolean( pData->buffer );
3255  }
3256 
3263  sal_Unicode toChar() const
3264  {
3265  return pData->buffer[0];
3266  }
3267 
3278  sal_Int32 toInt32( sal_Int16 radix = 10 ) const
3279  {
3280  return rtl_ustr_toInt32( pData->buffer, radix );
3281  }
3282 
3295  sal_uInt32 toUInt32( sal_Int16 radix = 10 ) const
3296  {
3297  return rtl_ustr_toUInt32( pData->buffer, radix );
3298  }
3299 
3310  sal_Int64 toInt64( sal_Int16 radix = 10 ) const
3311  {
3312  return rtl_ustr_toInt64( pData->buffer, radix );
3313  }
3314 
3327  sal_uInt64 toUInt64( sal_Int16 radix = 10 ) const
3328  {
3329  return rtl_ustr_toUInt64( pData->buffer, radix );
3330  }
3331 
3340  float toFloat() const
3341  {
3342  return rtl_ustr_toFloat( pData->buffer );
3343  }
3344 
3353  double toDouble() const
3354  {
3355  return rtl_ustr_toDouble( pData->buffer );
3356  }
3357 
3358 
3374  OUString intern() const
3375  {
3376  rtl_uString * pNew = NULL;
3377  rtl_uString_intern( &pNew, pData );
3378  if (pNew == NULL) {
3379  throw std::bad_alloc();
3380  }
3381  return OUString( pNew, SAL_NO_ACQUIRE );
3382  }
3383 
3409  static OUString intern( const char * value, sal_Int32 length,
3410  rtl_TextEncoding encoding,
3411  sal_uInt32 convertFlags = OSTRING_TO_OUSTRING_CVTFLAGS,
3412  sal_uInt32 *pInfo = NULL )
3413  {
3414  rtl_uString * pNew = NULL;
3415  rtl_uString_internConvert( &pNew, value, length, encoding,
3416  convertFlags, pInfo );
3417  if (pNew == NULL) {
3418  throw std::bad_alloc();
3419  }
3420  return OUString( pNew, SAL_NO_ACQUIRE );
3421  }
3422 
3447  bool convertToString(OString * pTarget, rtl_TextEncoding nEncoding,
3448  sal_uInt32 nFlags) const
3449  {
3450  return rtl_convertUStringToString(&pTarget->pData, pData->buffer,
3451  pData->length, nEncoding, nFlags);
3452  }
3453 
3505  sal_uInt32 iterateCodePoints(
3506  sal_Int32 * indexUtf16, sal_Int32 incrementCodePoints = 1) const
3507  {
3508  return rtl_uString_iterateCodePoints(
3509  pData, indexUtf16, incrementCodePoints);
3510  }
3511 
3521 #if defined LIBO_INTERNAL_ONLY
3522  static OUString fromUtf8(std::string_view rSource)
3523  {
3524  OUString aTarget;
3525  bool bSuccess = rtl_convertStringToUString(&aTarget.pData,
3526  rSource.data(),
3527  rSource.length(),
3528  RTL_TEXTENCODING_UTF8,
3529  RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_ERROR|RTL_TEXTTOUNICODE_FLAGS_MBUNDEFINED_ERROR|RTL_TEXTTOUNICODE_FLAGS_INVALID_ERROR);
3530  (void) bSuccess;
3531  assert(bSuccess);
3532  return aTarget;
3533  }
3534 #else
3535  static OUString fromUtf8(const OString& rSource)
3536  {
3537  OUString aTarget;
3538  bool bSuccess = rtl_convertStringToUString(&aTarget.pData,
3539  rSource.getStr(),
3540  rSource.getLength(),
3541  RTL_TEXTENCODING_UTF8,
3542  RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_ERROR|RTL_TEXTTOUNICODE_FLAGS_MBUNDEFINED_ERROR|RTL_TEXTTOUNICODE_FLAGS_INVALID_ERROR);
3543  (void) bSuccess;
3544  assert(bSuccess);
3545  return aTarget;
3546  }
3547 #endif
3548 
3559  OString toUtf8() const
3560  {
3561  OString aTarget;
3562  bool bSuccess = rtl_convertUStringToString(&aTarget.pData,
3563  getStr(),
3564  getLength(),
3565  RTL_TEXTENCODING_UTF8,
3566  RTL_UNICODETOTEXT_FLAGS_UNDEFINED_ERROR|RTL_UNICODETOTEXT_FLAGS_INVALID_ERROR);
3567  (void) bSuccess;
3568  assert(bSuccess);
3569  return aTarget;
3570  }
3571 
3572 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
3573 
3574  static auto number( int i, sal_Int16 radix = 10 )
3575  {
3576  return OUStringNumber<RTL_USTR_MAX_VALUEOFINT32>(rtl_ustr_valueOfInt32, i, radix);
3577  }
3578  static auto number( long long ll, sal_Int16 radix = 10 )
3579  {
3580  return OUStringNumber<RTL_USTR_MAX_VALUEOFINT64>(rtl_ustr_valueOfInt64, ll, radix);
3581  }
3582  static auto number( unsigned long long ll, sal_Int16 radix = 10 )
3583  {
3584  return OUStringNumber<RTL_USTR_MAX_VALUEOFUINT64>(rtl_ustr_valueOfUInt64, ll, radix);
3585  }
3586  static auto number( unsigned int i, sal_Int16 radix = 10 )
3587  {
3588  return number( static_cast< unsigned long long >( i ), radix );
3589  }
3590  static auto number( long i, sal_Int16 radix = 10)
3591  {
3592  return number( static_cast< long long >( i ), radix );
3593  }
3594  static auto number( unsigned long i, sal_Int16 radix = 10 )
3595  {
3596  return number( static_cast< unsigned long long >( i ), radix );
3597  }
3598 #else
3609  static OUString number( int i, sal_Int16 radix = 10 )
3610  {
3611  sal_Unicode aBuf[RTL_USTR_MAX_VALUEOFINT32];
3612  return OUString(aBuf, rtl_ustr_valueOfInt32(aBuf, i, radix));
3613  }
3616  static OUString number( unsigned int i, sal_Int16 radix = 10 )
3617  {
3618  return number( static_cast< unsigned long long >( i ), radix );
3619  }
3622  static OUString number( long i, sal_Int16 radix = 10)
3623  {
3624  return number( static_cast< long long >( i ), radix );
3625  }
3628  static OUString number( unsigned long i, sal_Int16 radix = 10 )
3629  {
3630  return number( static_cast< unsigned long long >( i ), radix );
3631  }
3634  static OUString number( long long ll, sal_Int16 radix = 10 )
3635  {
3636  sal_Unicode aBuf[RTL_USTR_MAX_VALUEOFINT64];
3637  return OUString(aBuf, rtl_ustr_valueOfInt64(aBuf, ll, radix));
3638  }
3641  static OUString number( unsigned long long ll, sal_Int16 radix = 10 )
3642  {
3643  sal_Unicode aBuf[RTL_USTR_MAX_VALUEOFUINT64];
3644  return OUString(aBuf, rtl_ustr_valueOfUInt64(aBuf, ll, radix));
3645  }
3646 #endif
3647 
3657  static OUString number( float f )
3658  {
3659  rtl_uString* pNew = NULL;
3660  // Same as rtl::str::valueOfFP, used for rtl_ustr_valueOfFloat
3661  rtl_math_doubleToUString(&pNew, NULL, 0, f, rtl_math_StringFormat_G,
3662  RTL_USTR_MAX_VALUEOFFLOAT - SAL_N_ELEMENTS("-x.E-xxx") + 1, '.',
3663  NULL, 0, true);
3664  if (pNew == NULL)
3665  throw std::bad_alloc();
3666 
3667  return OUString(pNew, SAL_NO_ACQUIRE);
3668  }
3669 
3679  static OUString number( double d )
3680  {
3681  rtl_uString* pNew = NULL;
3682  // Same as rtl::str::valueOfFP, used for rtl_ustr_valueOfDouble
3683  rtl_math_doubleToUString(&pNew, NULL, 0, d, rtl_math_StringFormat_G,
3684  RTL_USTR_MAX_VALUEOFDOUBLE - SAL_N_ELEMENTS("-x.E-xxx") + 1, '.',
3685  NULL, 0, true);
3686  if (pNew == NULL)
3687  throw std::bad_alloc();
3688 
3689  return OUString(pNew, SAL_NO_ACQUIRE);
3690  }
3691 
3692 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
3693  static auto boolean(bool b)
3694  {
3695  return OUStringNumber<RTL_USTR_MAX_VALUEOFBOOLEAN>(rtl_ustr_valueOfBoolean, b);
3696  }
3697 #else
3709  SAL_DEPRECATED("use boolean()") static OUString valueOf( sal_Bool b )
3710  {
3711  return boolean(b);
3712  }
3713 
3725  static OUString boolean( bool b )
3726  {
3727  sal_Unicode aBuf[RTL_USTR_MAX_VALUEOFBOOLEAN];
3728  return OUString(aBuf, rtl_ustr_valueOfBoolean(aBuf, b));
3729  }
3730 #endif
3731 
3739  SAL_DEPRECATED("convert to OUString or use directly") static OUString valueOf( sal_Unicode c )
3740  {
3741  return OUString( &c, 1 );
3742  }
3743 
3754  SAL_DEPRECATED("use number()") static OUString valueOf( sal_Int32 i, sal_Int16 radix = 10 )
3755  {
3756  return number( i, radix );
3757  }
3758 
3769  SAL_DEPRECATED("use number()") static OUString valueOf( sal_Int64 ll, sal_Int16 radix = 10 )
3770  {
3771  return number( ll, radix );
3772  }
3773 
3783  SAL_DEPRECATED("use number()") static OUString valueOf( float f )
3784  {
3785  return number(f);
3786  }
3787 
3797  SAL_DEPRECATED("use number()") static OUString valueOf( double d )
3798  {
3799  return number(d);
3800  }
3801 
3817  static OUString createFromAscii( const char * value )
3818  {
3819  rtl_uString* pNew = NULL;
3820  rtl_uString_newFromAscii( &pNew, value );
3821  return OUString( pNew, SAL_NO_ACQUIRE );
3822  }
3823 
3824 #if defined LIBO_INTERNAL_ONLY
3825  static OUString createFromAscii(std::string_view value) {
3826  rtl_uString * p = nullptr;
3827  rtl_uString_newFromLiteral(&p, value.data(), value.size(), 0); //TODO: check for overflow
3828  return OUString(p, SAL_NO_ACQUIRE);
3829  }
3830  #endif
3831 
3832 #if defined LIBO_INTERNAL_ONLY
3833  operator std::u16string_view() const { return {getStr(), sal_uInt32(getLength())}; }
3834 #endif
3835 
3836 #if defined LIBO_INTERNAL_ONLY
3837  // A wrapper for the first expression in an
3838  //
3839  // OUString::Concat(e1) + e2 + ...
3840  //
3841  // concatenation chain, when neither of the first two e1, e2 is one of our rtl string-related
3842  // classes (so something like
3843  //
3844  // OUString s = "a" + (b ? std::u16string_view(u"c") : std::u16string_view(u"dd"));
3845  //
3846  // would not compile):
3847  template<typename T> [[nodiscard]] static
3848  OUStringConcat<OUStringConcatMarker, T>
3849  Concat(T const & value) { return OUStringConcat<OUStringConcatMarker, T>(value); }
3850 
3851  // This overload is needed so that an argument of type 'char const[N]' ends up as
3852  // 'OUStringConcat<rtl::OUStringConcatMarker, char const[N]>' rather than as
3853  // 'OUStringConcat<rtl::OUStringConcatMarker, char[N]>':
3854  template<typename T, std::size_t N> [[nodiscard]] static
3855  OUStringConcat<OUStringConcatMarker, T[N]>
3856  Concat(T (& value)[N]) { return OUStringConcat<OUStringConcatMarker, T[N]>(value); }
3857 #endif
3858 
3859 private:
3860  OUString & internalAppend( rtl_uString* pOtherData )
3861  {
3862  rtl_uString* pNewData = NULL;
3863  rtl_uString_newConcat( &pNewData, pData, pOtherData );
3864  if (pNewData == NULL) {
3865  throw std::bad_alloc();
3866  }
3867  rtl_uString_assign(&pData, pNewData);
3868  rtl_uString_release(pNewData);
3869  return *this;
3870  }
3871 
3872 #if defined LIBO_INTERNAL_ONLY
3873  static constexpr auto empty = OUStringLiteral(u""); // [-loplugin:ostr]
3874 #endif
3875 };
3876 
3877 #if defined LIBO_INTERNAL_ONLY
3878 // Prevent the operator ==/!= overloads with 'sal_Unicode const *' parameter from
3879 // being selected for nonsensical code like
3880 //
3881 // if (ouIdAttr == nullptr)
3882 //
3883 void operator ==(OUString const &, std::nullptr_t) = delete;
3884 void operator ==(std::nullptr_t, OUString const &) = delete;
3885 void operator !=(OUString const &, std::nullptr_t) = delete;
3886 void operator !=(std::nullptr_t, OUString const &) = delete;
3887 #endif
3888 
3889 #if defined LIBO_INTERNAL_ONLY && !defined RTL_STRING_UNITTEST
3890 inline bool operator ==(OUString const & lhs, StringConcatenation<char16_t> const & rhs)
3891 { return lhs == std::u16string_view(rhs); }
3892 inline bool operator !=(OUString const & lhs, StringConcatenation<char16_t> const & rhs)
3893 { return lhs != std::u16string_view(rhs); }
3894 inline bool operator ==(StringConcatenation<char16_t> const & lhs, OUString const & rhs)
3895 { return std::u16string_view(lhs) == rhs; }
3896 inline bool operator !=(StringConcatenation<char16_t> const & lhs, OUString const & rhs)
3897 { return std::u16string_view(lhs) != rhs; }
3898 #endif
3899 
3900 #if defined LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
3902 
3906 template<>
3907 struct ToStringHelper< OUString >
3908 {
3909  static std::size_t length( const OUString& s ) { return s.getLength(); }
3910  sal_Unicode* operator() ( sal_Unicode* buffer, const OUString& s ) const { return addDataHelper( buffer, s.getStr(), s.getLength()); }
3911 };
3912 
3916 template<std::size_t N>
3917 struct ToStringHelper< OUStringLiteral<N> >
3918 {
3919  static std::size_t length( const OUStringLiteral<N>& str ) { return str.getLength(); }
3920  sal_Unicode* operator()( sal_Unicode* buffer, const OUStringLiteral<N>& str ) const { return addDataHelper( buffer, str.getStr(), str.getLength() ); }
3921 };
3922 
3926 template< typename charT, typename traits, typename T1, typename T2 >
3927 inline std::basic_ostream<charT, traits> & operator <<(
3928  std::basic_ostream<charT, traits> & stream, OUStringConcat< T1, T2 >&& concat)
3929 {
3930  return stream << OUString( std::move(concat) );
3931 }
3932 
3934 #endif
3935 
3941 struct OUStringHash
3942 {
3952  size_t operator()(const OUString& rString) const
3953  { return static_cast<size_t>(rString.hashCode()); }
3954 };
3955 
3956 /* ======================================================================= */
3957 
3975 #if defined LIBO_INTERNAL_ONLY
3976 inline OUString OStringToOUString( std::string_view rStr,
3977  rtl_TextEncoding encoding,
3978  sal_uInt32 convertFlags = OSTRING_TO_OUSTRING_CVTFLAGS )
3979 {
3980  return OUString( rStr.data(), rStr.length(), encoding, convertFlags );
3981 }
3982 #else
3983 inline OUString OStringToOUString( const OString & rStr,
3984  rtl_TextEncoding encoding,
3985  sal_uInt32 convertFlags = OSTRING_TO_OUSTRING_CVTFLAGS )
3986 {
3987  return OUString( rStr.getStr(), rStr.getLength(), encoding, convertFlags );
3988 }
3989 #endif
3990 
4008 #if defined LIBO_INTERNAL_ONLY
4009 inline OString OUStringToOString( std::u16string_view rUnicode,
4010  rtl_TextEncoding encoding,
4011  sal_uInt32 convertFlags = OUSTRING_TO_OSTRING_CVTFLAGS )
4012 {
4013  return OString( rUnicode.data(), rUnicode.length(), encoding, convertFlags );
4014 }
4015 #else
4016 inline OString OUStringToOString( const OUString & rUnicode,
4017  rtl_TextEncoding encoding,
4018  sal_uInt32 convertFlags = OUSTRING_TO_OSTRING_CVTFLAGS )
4019 {
4020  return OString( rUnicode.getStr(), rUnicode.getLength(), encoding, convertFlags );
4021 }
4022 #endif
4023 
4024 /* ======================================================================= */
4025 
4034 template< typename charT, typename traits >
4035 inline std::basic_ostream<charT, traits> & operator <<(
4036  std::basic_ostream<charT, traits> & stream, OUString const & rString)
4037 {
4038  return stream <<
4039  OUStringToOString(rString, RTL_TEXTENCODING_UTF8);
4040  // best effort; potentially loses data due to conversion failures
4041  // (stray surrogate halves) and embedded null characters
4042 }
4043 
4044 } // namespace
4045 
4046 #ifdef RTL_STRING_UNITTEST
4047 namespace rtl
4048 {
4049 typedef rtlunittest::OUString OUString;
4050 }
4051 #endif
4052 
4053 // In internal code, allow to use classes like OUString without having to
4054 // explicitly refer to the rtl namespace, which is kind of superfluous given
4055 // that OUString itself is namespaced by its OU prefix:
4056 #if defined LIBO_INTERNAL_ONLY && !defined RTL_STRING_UNITTEST
4057 using ::rtl::OUString;
4058 using ::rtl::OUStringHash;
4059 using ::rtl::OStringToOUString;
4060 using ::rtl::OUStringToOString;
4061 using ::rtl::OUStringLiteral;
4062 using ::rtl::OUStringChar;
4063 using ::rtl::Concat2View;
4064 using RepeatedUChar = ::rtl::RepeatedChar_t<sal_Unicode>;
4065 #endif
4066 
4067 #if defined LIBO_INTERNAL_ONLY
4068 
4069 template<
4070 #if defined RTL_STRING_UNITTEST
4071  rtlunittest::
4072 #endif
4073  OUStringLiteral L>
4074 constexpr
4075 #if defined RTL_STRING_UNITTEST
4076  rtlunittest::
4077 #endif
4078  OUString
4079 operator ""_ustr() { return L; }
4080 
4081 #endif
4082 
4084 
4089 #if defined LIBO_INTERNAL_ONLY
4090 namespace std {
4091 
4092 template<>
4093 struct hash<::rtl::OUString>
4094 {
4095  std::size_t operator()(::rtl::OUString const & s) const
4096  {
4097  if constexpr (sizeof(std::size_t) == 8)
4098  {
4099  // return a hash that uses the full 64-bit range instead of a 32-bit value
4100  size_t n = s.getLength();
4101  for (sal_Int32 i = 0, len = s.getLength(); i < len; ++i)
4102  n = 37 * n + s[i];
4103  return n;
4104  }
4105  else
4106  return std::size_t(s.hashCode());
4107  }
4108 };
4109 
4110 }
4111 
4118 static inline constexpr ::rtl::OUString EMPTY_OUSTRING = u""_ustr;
4119 
4120 #endif
4122 
4123 #endif /* _RTL_USTRING_HXX */
4124 
4125 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
SAL_N_ELEMENTS
#define SAL_N_ELEMENTS(arr)
Definition: macros.h:51
SAL_DEPRECATED
#define SAL_DEPRECATED(message)
Use as follows: SAL_DEPRECATED("Don't use, it's evil.") void doit(int nPara);.
Definition: types.h:492
__sal_NoAcquire
__sal_NoAcquire
Definition: types.h:371
SAL_NO_ACQUIRE
@ SAL_NO_ACQUIRE
definition of a no acquire enum for ctors
Definition: types.h:374
sal_Bool
unsigned char sal_Bool
Definition: types.h:38
SAL_CONSTEXPR
#define SAL_CONSTEXPR
C++11 "constexpr" feature.
Definition: types.h:422
sal_Unicode
sal_uInt16 sal_Unicode
Definition: types.h:123
SAL_WARN_UNUSED_RESULT
#define SAL_WARN_UNUSED_RESULT
Use this as markup for functions and methods whose return value must be used.
Definition: types.h:288
SAL_WARN_UNUSED
#define SAL_WARN_UNUSED
Annotate classes where a compiler should warn if an instance is unused.
Definition: types.h:611
rtl_math_doubleToUString
SAL_DLLPUBLIC void rtl_math_doubleToUString(rtl_uString **pResult, sal_Int32 *pResultCapacity, sal_Int32 nResultOffset, double fValue, enum rtl_math_StringFormat eFormat, sal_Int32 nDecPlaces, sal_Unicode cDecSeparator, sal_Int32 const *pGroups, sal_Unicode cGroupSeparator, sal_Bool bEraseTrailingDecZeros) SAL_THROW_EXTERN_C()
Conversions analogous to sprintf() using internal rounding.
rtl_math_StringFormat_G
@ rtl_math_StringFormat_G
Like sprintf() G, 'F' or 'E' format is used depending on which one is more compact.
Definition: math.h:53
rtl_convertUStringToString
SAL_DLLPUBLIC sal_Bool rtl_convertUStringToString(rtl_String **pTarget, sal_Unicode const *pSource, sal_Int32 nLength, rtl_TextEncoding nEncoding, sal_uInt32 nFlags) SAL_THROW_EXTERN_C()
Converts a Unicode string to a byte string, signalling failure.
OUSTRING_TO_OSTRING_CVTFLAGS
#define OUSTRING_TO_OSTRING_CVTFLAGS
Definition: string.h:1350
RTL_UNICODETOTEXT_FLAGS_INVALID_ERROR
#define RTL_UNICODETOTEXT_FLAGS_INVALID_ERROR
Definition: textcvt.h:151
RTL_TEXTTOUNICODE_FLAGS_INVALID_ERROR
#define RTL_TEXTTOUNICODE_FLAGS_INVALID_ERROR
Definition: textcvt.h:75
RTL_TEXTTOUNICODE_FLAGS_MBUNDEFINED_ERROR
#define RTL_TEXTTOUNICODE_FLAGS_MBUNDEFINED_ERROR
Definition: textcvt.h:72
RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_ERROR
#define RTL_TEXTTOUNICODE_FLAGS_UNDEFINED_ERROR
Definition: textcvt.h:68
RTL_UNICODETOTEXT_FLAGS_UNDEFINED_ERROR
#define RTL_UNICODETOTEXT_FLAGS_UNDEFINED_ERROR
Definition: textcvt.h:145
RTL_TEXTENCODING_UTF8
#define RTL_TEXTENCODING_UTF8
Definition: textenc.h:117
rtl_TextEncoding
sal_uInt16 rtl_TextEncoding
The various supported text encodings.
Definition: textenc.h:37
rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths
SAL_DLLPUBLIC sal_Int32 rtl_ustr_ascii_compareIgnoreAsciiCase_WithLengths(sal_Unicode const *first, sal_Int32 firstLen, char const *second, sal_Int32 secondLen) SAL_THROW_EXTERN_C()
Compare two strings, ignoring the case of ASCII characters.
rtl_uString_assign
SAL_DLLPUBLIC void rtl_uString_assign(rtl_uString **str, rtl_uString *rightValue) SAL_THROW_EXTERN_C()
Assign a new value to a string.
rtl_uString_newReplaceFirstUtf16LUtf16L
SAL_DLLPUBLIC void rtl_uString_newReplaceFirstUtf16LUtf16L(rtl_uString **newStr, rtl_uString *str, sal_Unicode const *from, sal_Int32 fromLength, sal_Unicode const *to, sal_Int32 toLength, sal_Int32 *index) SAL_THROW_EXTERN_C()
Create a new string by replacing the first occurrence of a given substring with another substring.
rtl_ustr_toFloat
SAL_DLLPUBLIC float rtl_ustr_toFloat(const sal_Unicode *str) SAL_THROW_EXTERN_C()
Interpret a string as a float.
rtl_ustr_ascii_shortenedCompare_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_ascii_shortenedCompare_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const char *second, sal_Int32 shortenedLen) SAL_THROW_EXTERN_C()
Compare two strings with a maximum count of characters.
rtl_uString_new
SAL_DLLPUBLIC void rtl_uString_new(rtl_uString **newStr) SAL_THROW_EXTERN_C()
Allocate a new string containing no characters.
OSTRING_TO_OUSTRING_CVTFLAGS
#define OSTRING_TO_OUSTRING_CVTFLAGS
Definition: ustring.h:2180
RTL_USTR_MAX_VALUEOFFLOAT
#define RTL_USTR_MAX_VALUEOFFLOAT
Definition: ustring.h:1026
rtl_ustr_compare_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_compare_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Unicode *second, sal_Int32 secondLen) SAL_THROW_EXTERN_C()
Compare two strings.
rtl_uString_newConcatUtf16L
SAL_DLLPUBLIC void rtl_uString_newConcatUtf16L(rtl_uString **newString, rtl_uString *left, sal_Unicode const *right, sal_Int32 rightLength)
Create a new string that is the concatenation of two other strings.
rtl_uString_newReplaceAllAsciiL
SAL_DLLPUBLIC void rtl_uString_newReplaceAllAsciiL(rtl_uString **newStr, rtl_uString *str, char const *from, sal_Int32 fromLength, rtl_uString const *to) SAL_THROW_EXTERN_C()
Create a new string by replacing all occurrences of a given substring with another substring.
rtl_uString_newReplaceAllFromIndex
SAL_DLLPUBLIC void rtl_uString_newReplaceAllFromIndex(rtl_uString **newStr, rtl_uString *str, rtl_uString const *from, rtl_uString const *to, sal_Int32 fromIndex) SAL_THROW_EXTERN_C()
Create a new string by replacing all occurrences of a given substring with another substring.
rtl_ustr_ascii_shortenedCompareIgnoreAsciiCase_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_ascii_shortenedCompareIgnoreAsciiCase_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const char *second, sal_Int32 shortenedLen) SAL_THROW_EXTERN_C()
Compare two strings with a maximum count of characters, ignoring the case of ASCII characters.
rtl_uString_getToken
SAL_DLLPUBLIC sal_Int32 rtl_uString_getToken(rtl_uString **newStr, rtl_uString *str, sal_Int32 token, sal_Unicode cTok, sal_Int32 idx) SAL_THROW_EXTERN_C()
Create a new string by extracting a single token from another string.
RTL_USTR_MAX_VALUEOFDOUBLE
#define RTL_USTR_MAX_VALUEOFDOUBLE
Definition: ustring.h:1045
rtl_uString_newFromStr_WithLength
SAL_DLLPUBLIC void rtl_uString_newFromStr_WithLength(rtl_uString **newStr, const sal_Unicode *value, sal_Int32 len) SAL_THROW_EXTERN_C()
Allocate a new string that contains a copy of a character array.
rtl_ustr_asciil_reverseEquals_WithLength
SAL_DLLPUBLIC sal_Bool rtl_ustr_asciil_reverseEquals_WithLength(const sal_Unicode *first, const char *second, sal_Int32 len) SAL_THROW_EXTERN_C()
Compare two strings from back to front for equality.
rtl_uString_newFromLiteral
SAL_DLLPUBLIC void rtl_uString_newFromLiteral(rtl_uString **newStr, const char *value, sal_Int32 len, sal_Int32 allocExtra) SAL_THROW_EXTERN_C()
rtl_uString_newReplaceAllAsciiLUtf16L
SAL_DLLPUBLIC void rtl_uString_newReplaceAllAsciiLUtf16L(rtl_uString **newStr, rtl_uString *str, char const *from, sal_Int32 fromLength, sal_Unicode const *to, sal_Int32 toLength) SAL_THROW_EXTERN_C()
Create a new string by replacing all occurrences of a given substring with another substring.
rtl_ustr_valueOfBoolean
SAL_DLLPUBLIC sal_Int32 rtl_ustr_valueOfBoolean(sal_Unicode *str, sal_Bool b) SAL_THROW_EXTERN_C()
Create the string representation of a boolean.
rtl_ustr_toDouble
SAL_DLLPUBLIC double rtl_ustr_toDouble(const sal_Unicode *str) SAL_THROW_EXTERN_C()
Interpret a string as a double.
rtl_uString_newReplaceFirstUtf16LAsciiL
SAL_DLLPUBLIC void rtl_uString_newReplaceFirstUtf16LAsciiL(rtl_uString **newStr, rtl_uString *str, sal_Unicode const *from, sal_Int32 fromLength, char const *to, sal_Int32 toLength, sal_Int32 *index) SAL_THROW_EXTERN_C()
Create a new string by replacing the first occurrence of a given substring with another substring.
rtl_uString_newReplaceFirstToAsciiL
SAL_DLLPUBLIC void rtl_uString_newReplaceFirstToAsciiL(rtl_uString **newStr, rtl_uString *str, rtl_uString const *from, char const *to, sal_Int32 toLength, sal_Int32 *index) SAL_THROW_EXTERN_C()
Create a new string by replacing the first occurrence of a given substring with another substring.
rtl_uString_newConcat
SAL_DLLPUBLIC void rtl_uString_newConcat(rtl_uString **newStr, rtl_uString *left, rtl_uString *right) SAL_THROW_EXTERN_C()
Create a new string that is the concatenation of two other strings.
RTL_USTR_MAX_VALUEOFINT64
#define RTL_USTR_MAX_VALUEOFINT64
Definition: ustring.h:984
rtl_ustr_ascii_compareIgnoreAsciiCase_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_ascii_compareIgnoreAsciiCase_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const char *second) SAL_THROW_EXTERN_C()
Compare two strings, ignoring the case of ASCII characters.
rtl_uString_alloc
SAL_DLLPUBLIC rtl_uString * rtl_uString_alloc(sal_Int32 nLen) SAL_THROW_EXTERN_C()
Allocate a new string containing space for a given number of characters.
rtl_ustr_indexOfStr_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_indexOfStr_WithLength(const sal_Unicode *str, sal_Int32 len, const sal_Unicode *subStr, sal_Int32 subLen) SAL_THROW_EXTERN_C()
Search for the first occurrence of a substring within a string.
rtl_uString_internConvert
SAL_DLLPUBLIC void rtl_uString_internConvert(rtl_uString **newStr, const char *str, sal_Int32 len, rtl_TextEncoding encoding, sal_uInt32 convertFlags, sal_uInt32 *pInfo) SAL_THROW_EXTERN_C()
Return a canonical representation for a string.
rtl_uString_acquire
SAL_DLLPUBLIC void rtl_uString_acquire(rtl_uString *str) SAL_THROW_EXTERN_C() SAL_HOT
Increment the reference count of a string.
rtl_ustr_toInt64
SAL_DLLPUBLIC sal_Int64 rtl_ustr_toInt64(const sal_Unicode *str, sal_Int16 radix) SAL_THROW_EXTERN_C()
Interpret a string as a long integer.
rtl_uString_newReplaceStrAt
SAL_DLLPUBLIC void rtl_uString_newReplaceStrAt(rtl_uString **newStr, rtl_uString *str, sal_Int32 idx, sal_Int32 count, rtl_uString *subStr) SAL_THROW_EXTERN_C()
Create a new string by replacing a substring of another string.
RTL_USTR_MAX_VALUEOFUINT64
#define RTL_USTR_MAX_VALUEOFUINT64
Definition: ustring.h:1007
rtl_convertStringToUString
SAL_DLLPUBLIC sal_Bool rtl_convertStringToUString(rtl_uString **target, char const *source, sal_Int32 length, rtl_TextEncoding encoding, sal_uInt32 flags) SAL_THROW_EXTERN_C()
Converts a byte string to a Unicode string, signalling failure.
rtl_uString_newReplaceAllToAsciiL
SAL_DLLPUBLIC void rtl_uString_newReplaceAllToAsciiL(rtl_uString **newStr, rtl_uString *str, rtl_uString const *from, char const *to, sal_Int32 toLength) SAL_THROW_EXTERN_C()
Create a new string by replacing all occurrences of a given substring with another substring.
rtl_uString_iterateCodePoints
SAL_DLLPUBLIC sal_uInt32 rtl_uString_iterateCodePoints(rtl_uString const *string, sal_Int32 *indexUtf16, sal_Int32 incrementCodePoints)
Iterate through a string based on code points instead of UTF-16 code units.
rtl_uString_newToAsciiLowerCase
SAL_DLLPUBLIC void rtl_uString_newToAsciiLowerCase(rtl_uString **newStr, rtl_uString *str) SAL_THROW_EXTERN_C()
Create a new string by converting all ASCII uppercase letters to lowercase within another string.
rtl_uString_ensureCapacity
SAL_DLLPUBLIC void rtl_uString_ensureCapacity(rtl_uString **str, sal_Int32 size) SAL_THROW_EXTERN_C()
Ensure a string has enough space for a given number of characters.
rtl_uString_release
SAL_DLLPUBLIC void rtl_uString_release(rtl_uString *str) SAL_THROW_EXTERN_C() SAL_HOT
Decrement the reference count of a string.
rtl_ustr_getLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_getLength(const sal_Unicode *str) SAL_THROW_EXTERN_C()
Return the length of a string.
rtl_uString_newFromAscii
SAL_DLLPUBLIC void rtl_uString_newFromAscii(rtl_uString **newStr, const char *value) SAL_THROW_EXTERN_C()
Allocate a new string that contains a copy of a character array.
rtl_ustr_valueOfInt64
SAL_DLLPUBLIC sal_Int32 rtl_ustr_valueOfInt64(sal_Unicode *str, sal_Int64 l, sal_Int16 radix) SAL_THROW_EXTERN_C()
Create the string representation of a long integer.
rtl_ustr_lastIndexOfAscii_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_lastIndexOfAscii_WithLength(sal_Unicode const *str, sal_Int32 len, char const *subStr, sal_Int32 subLen) SAL_THROW_EXTERN_C()
Search for the last occurrence of an ASCII substring within a string.
rtl_uString_newReplaceFirstAsciiL
SAL_DLLPUBLIC void rtl_uString_newReplaceFirstAsciiL(rtl_uString **newStr, rtl_uString *str, char const *from, sal_Int32 fromLength, rtl_uString const *to, sal_Int32 *index) SAL_THROW_EXTERN_C()
Create a new string by replacing the first occurrence of a given substring with another substring.
rtl_ustr_indexOfAscii_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_indexOfAscii_WithLength(sal_Unicode const *str, sal_Int32 len, char const *subStr, sal_Int32 subLen) SAL_THROW_EXTERN_C()
Search for the first occurrence of an ASCII substring within a string.
rtl_ustr_toUInt64
SAL_DLLPUBLIC sal_uInt64 rtl_ustr_toUInt64(const sal_Unicode *str, sal_Int16 radix) SAL_THROW_EXTERN_C()
Interpret a string as an unsigned long integer.
rtl_uString_newReplaceAllUtf16LAsciiL
SAL_DLLPUBLIC void rtl_uString_newReplaceAllUtf16LAsciiL(rtl_uString **newStr, rtl_uString *str, sal_Unicode const *from, sal_Int32 fromLength, char const *to, sal_Int32 toLength) SAL_THROW_EXTERN_C()
Create a new string by replacing all occurrences of a given substring with another substring.
rtl_ustr_shortenedCompareIgnoreAsciiCase_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_shortenedCompareIgnoreAsciiCase_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Unicode *second, sal_Int32 secondLen, sal_Int32 shortenedLen) SAL_THROW_EXTERN_C()
Compare two strings with a maximum count of characters, ignoring the case of ASCII characters.
rtl_uString_newTrim
SAL_DLLPUBLIC void rtl_uString_newTrim(rtl_uString **newStr, rtl_uString *str) SAL_THROW_EXTERN_C()
Create a new string by removing white space from both ends of another string.
rtl_ustr_lastIndexOfChar_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_lastIndexOfChar_WithLength(const sal_Unicode *str, sal_Int32 len, sal_Unicode ch) SAL_THROW_EXTERN_C()
Search for the last occurrence of a character within a string.
rtl_uString_newReplaceFirstAsciiLAsciiL
SAL_DLLPUBLIC void rtl_uString_newReplaceFirstAsciiLAsciiL(rtl_uString **newStr, rtl_uString *str, char const *from, sal_Int32 fromLength, char const *to, sal_Int32 toLength, sal_Int32 *index) SAL_THROW_EXTERN_C()
Create a new string by replacing the first occurrence of a given substring with another substring.
rtl_ustr_toUInt32
SAL_DLLPUBLIC sal_uInt32 rtl_ustr_toUInt32(const sal_Unicode *str, sal_Int16 radix) SAL_THROW_EXTERN_C()
Interpret a string as an unsigned integer.
rtl_uString_intern
SAL_DLLPUBLIC void rtl_uString_intern(rtl_uString **newStr, rtl_uString *str) SAL_THROW_EXTERN_C()
Return a canonical representation for a string.
rtl_string2UString
SAL_DLLPUBLIC void rtl_string2UString(rtl_uString **newStr, const char *str, sal_Int32 len, rtl_TextEncoding encoding, sal_uInt32 convertFlags) SAL_THROW_EXTERN_C()
Create a new Unicode string by converting a byte string, using a specific text encoding.
rtl_uString_newFromStr
SAL_DLLPUBLIC void rtl_uString_newFromStr(rtl_uString **newStr, const sal_Unicode *value) SAL_THROW_EXTERN_C()
Allocate a new string that contains a copy of a character array.
rtl_ustr_asciil_reverseCompare_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_asciil_reverseCompare_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const char *second, sal_Int32 secondLen) SAL_THROW_EXTERN_C()
Compare two strings from back to front.
rtl_ustr_ascii_compare_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_ascii_compare_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const char *second) SAL_THROW_EXTERN_C()
Compare two strings.
RTL_USTR_MAX_VALUEOFBOOLEAN
#define RTL_USTR_MAX_VALUEOFBOOLEAN
Definition: ustring.h:919
rtl_ustr_toInt32
SAL_DLLPUBLIC sal_Int32 rtl_ustr_toInt32(const sal_Unicode *str, sal_Int16 radix) SAL_THROW_EXTERN_C()
Interpret a string as an integer.
rtl_uString_newReplaceAllAsciiLAsciiL
SAL_DLLPUBLIC void rtl_uString_newReplaceAllAsciiLAsciiL(rtl_uString **newStr, rtl_uString *str, char const *from, sal_Int32 fromLength, char const *to, sal_Int32 toLength) SAL_THROW_EXTERN_C()
Create a new string by replacing all occurrences of a given substring with another substring.
rtl_ustr_valueOfUInt64
SAL_DLLPUBLIC sal_Int32 rtl_ustr_valueOfUInt64(sal_Unicode *str, sal_uInt64 l, sal_Int16 radix) SAL_THROW_EXTERN_C()
Create the string representation of an unsigned long integer.
rtl_uString_newFromCodePoints
SAL_DLLPUBLIC void rtl_uString_newFromCodePoints(rtl_uString **newString, sal_uInt32 const *codePoints, sal_Int32 codePointCount) SAL_THROW_EXTERN_C()
Allocate a new string from an array of Unicode code points.
rtl_ustr_compareIgnoreAsciiCase_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_compareIgnoreAsciiCase_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Unicode *second, sal_Int32 secondLen) SAL_THROW_EXTERN_C()
Compare two strings, ignoring the case of ASCII characters.
rtl_ustr_reverseCompare_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_reverseCompare_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Unicode *second, sal_Int32 secondLen) SAL_THROW_EXTERN_C()
Compare two strings from back to front.
rtl_ustr_shortenedCompare_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_shortenedCompare_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Unicode *second, sal_Int32 secondLen, sal_Int32 shortenedLen) SAL_THROW_EXTERN_C()
Compare two strings with a maximum count of characters.
rtl_ustr_valueOfInt32
SAL_DLLPUBLIC sal_Int32 rtl_ustr_valueOfInt32(sal_Unicode *str, sal_Int32 i, sal_Int16 radix) SAL_THROW_EXTERN_C()
Create the string representation of an integer.
rtl_ustr_toBoolean
SAL_DLLPUBLIC sal_Bool rtl_ustr_toBoolean(const sal_Unicode *str) SAL_THROW_EXTERN_C()
Interpret a string as a boolean.
rtl_uString_newReplace
SAL_DLLPUBLIC void rtl_uString_newReplace(rtl_uString **newStr, rtl_uString *str, sal_Unicode oldChar, sal_Unicode newChar) SAL_THROW_EXTERN_C()
Create a new string by replacing all occurrences of a single character within another string.
rtl_ustr_hashCode_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_hashCode_WithLength(const sal_Unicode *str, sal_Int32 len) SAL_THROW_EXTERN_C()
Return a hash code for a string.
rtl_uString_newReplaceFirst
SAL_DLLPUBLIC void rtl_uString_newReplaceFirst(rtl_uString **newStr, rtl_uString *str, rtl_uString const *from, rtl_uString const *to, sal_Int32 *index) SAL_THROW_EXTERN_C()
Create a new string by replacing the first occurrence of a given substring with another substring.
rtl_uString_newReplaceFirstAsciiLUtf16L
SAL_DLLPUBLIC void rtl_uString_newReplaceFirstAsciiLUtf16L(rtl_uString **newStr, rtl_uString *str, char const *from, sal_Int32 fromLength, sal_Unicode const *to, sal_Int32 toLength, sal_Int32 *index) SAL_THROW_EXTERN_C()
Create a new string by replacing the first occurrence of a given substring with another substring.
rtl_uString_newToAsciiUpperCase
SAL_DLLPUBLIC void rtl_uString_newToAsciiUpperCase(rtl_uString **newStr, rtl_uString *str) SAL_THROW_EXTERN_C()
Create a new string by converting all ASCII lowercase letters to uppercase within another string.
rtl_ustr_lastIndexOfStr_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_lastIndexOfStr_WithLength(const sal_Unicode *str, sal_Int32 len, const sal_Unicode *subStr, sal_Int32 subLen) SAL_THROW_EXTERN_C()
Search for the last occurrence of a substring within a string.
rtl_ustr_indexOfChar_WithLength
SAL_DLLPUBLIC sal_Int32 rtl_ustr_indexOfChar_WithLength(const sal_Unicode *str, sal_Int32 len, sal_Unicode ch) SAL_THROW_EXTERN_C()
Search for the first occurrence of a character within a string.
rtl_uString_newFromSubString
SAL_DLLPUBLIC void rtl_uString_newFromSubString(rtl_uString **newStr, const rtl_uString *from, sal_Int32 beginIndex, sal_Int32 count) SAL_THROW_EXTERN_C()
Allocate a new string that is a substring of this string.
rtl_uString_newConcatAsciiL
SAL_DLLPUBLIC void rtl_uString_newConcatAsciiL(rtl_uString **newString, rtl_uString *left, char const *right, sal_Int32 rightLength)
Create a new string that is the concatenation of two other strings.
RTL_USTR_MAX_VALUEOFINT32
#define RTL_USTR_MAX_VALUEOFINT32
Definition: ustring.h:961
oslInterlockedCount
sal_Int32 oslInterlockedCount
Definition: interlck.h:44
salhelper::operator<
bool operator<(const TTimeValue &rTimeA, const TTimeValue &rTimeB)
Definition: timer.hxx:93
salhelper::operator>
bool operator>(const TTimeValue &rTimeA, const TTimeValue &rTimeB)
Definition: timer.hxx:103
salhelper::operator==
bool operator==(const TTimeValue &rTimeA, const TTimeValue &rTimeB)
Definition: timer.hxx:113
rtl
Definition: bootstrap.hxx:34
rtl::OStringToOUString
OUString OStringToOUString(const OString &rStr, rtl_TextEncoding encoding, sal_uInt32 convertFlags=OSTRING_TO_OUSTRING_CVTFLAGS)
Convert an OString to an OUString, using a specific text encoding.
Definition: ustring.hxx:3983
rtl::OUStringToOString
OString OUStringToOString(const OUString &rUnicode, rtl_TextEncoding encoding, sal_uInt32 convertFlags=OUSTRING_TO_OSTRING_CVTFLAGS)
Convert an OUString to an OString, using a specific text encoding.
Definition: ustring.hxx:4016
rtl::operator<<
std::basic_ostream< charT, traits > & operator<<(std::basic_ostream< charT, traits > &stream, OString const &rString)
Support for rtl::OString in std::ostream (and thus in CPPUNIT_ASSERT or SAL_INFO macros,...
Definition: string.hxx:2826
com::sun::star::uno::operator!=
bool operator!=(const Any &rAny, const C &value)
Template inequality operator: compares set value of left side any to right side value.
Definition: Any.hxx:660
rtl::OString
This String class provide base functionality for C++ like 8-Bit character array handling.
Definition: string.hxx:189
rtl::OString::getStr
const char * getStr() const SAL_RETURNS_NONNULL
Returns a pointer to the characters of this string.
Definition: string.hxx:689
rtl::OString::getLength
sal_Int32 getLength() const
Returns the length of this string.
Definition: string.hxx:663
rtl::libreoffice_internal::Dummy
Definition: stringutils.hxx:178
rtl::libreoffice_internal::CharPtrDetector
Definition: stringutils.hxx:181
rtl::OUStringBuffer
A string buffer implements a mutable sequence of characters.
Definition: ustrbuf.hxx:73
rtl::OUString
This String class provides base functionality for C++ like Unicode character array handling.
Definition: ustring.hxx:168
rtl::OUString::number
static OUString number(int i, sal_Int16 radix=10)
Returns the string representation of the integer argument.
Definition: ustring.hxx:3609
rtl::OUString::intern
OUString intern() const
Return a canonical representation for a string.
Definition: ustring.hxx:3374
rtl::OUString::indexOf
libreoffice_internal::ConstCharArrayDetector< T, sal_Int32 >::Type indexOf(T &literal, sal_Int32 fromIndex=0) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:2516
rtl::OUString::startsWith
bool startsWith(sal_Unicode ch) const
Check whether this string starts with a given character.
Definition: ustring.hxx:1626
rtl::OUString::startsWith
bool startsWith(sal_Unicode ch, OUString *rest) const
Check whether this string starts with a given character.
Definition: ustring.hxx:1643
rtl::OUString::replaceFirst
SAL_WARN_UNUSED_RESULT libreoffice_internal::ConstCharArrayDetector< T1, typename libreoffice_internal::ConstCharArrayDetector< T2, OUString >::Type >::Type replaceFirst(T1 &from, T2 &to, sal_Int32 *index=NULL) const
Returns a new string resulting from replacing the first occurrence of a given substring with another ...
Definition: ustring.hxx:2983
rtl::OUString::endsWith
bool endsWith(OUString const &str, OUString *rest=NULL) const
Check whether this string ends with a given substring.
Definition: ustring.hxx:1874
rtl::OUString::endsWithIgnoreAsciiCaseAsciiL
bool endsWithIgnoreAsciiCaseAsciiL(char const *asciiStr, sal_Int32 asciiStrLength) const
Check whether this string ends with a given ASCII string, ignoring the case of ASCII letters.
Definition: ustring.hxx:2222
rtl::OUString::toAsciiLowerCase
SAL_WARN_UNUSED_RESULT OUString toAsciiLowerCase() const
Converts from this string all ASCII uppercase characters (65-90) to ASCII lowercase characters (97-12...
Definition: ustring.hxx:3151
rtl::OUString::replaceAll
SAL_WARN_UNUSED_RESULT libreoffice_internal::ConstCharArrayDetector< T, OUString >::Type replaceAll(T &from, OUString const &to) const
Returns a new string resulting from replacing all occurrences of a given substring with another subst...
Definition: ustring.hxx:3060
rtl::OUString::equalsIgnoreAsciiCase
bool equalsIgnoreAsciiCase(const OUString &str) const
Perform an ASCII lowercase comparison of two strings.
Definition: ustring.hxx:1001
rtl::OUString::endsWithAsciiL
bool endsWithAsciiL(char const *asciiStr, sal_Int32 asciiStrLength) const
Check whether this string ends with a given ASCII string.
Definition: ustring.hxx:2037
rtl::OUString::OUString
OUString(const OUString &str)
New string from OUString.
Definition: ustring.hxx:197
rtl::OUString::iterateCodePoints
sal_uInt32 iterateCodePoints(sal_Int32 *indexUtf16, sal_Int32 incrementCodePoints=1) const
Iterate through this string based on code points instead of UTF-16 code units.
Definition: ustring.hxx:3505
rtl::OUString::fromUtf8
static OUString fromUtf8(const OString &rSource)
Convert an OString to an OUString, assuming that the OString is UTF-8-encoded.
Definition: ustring.hxx:3535
rtl::OUString::match
libreoffice_internal::ConstCharArrayDetector< T, bool >::Type match(T &literal, sal_Int32 fromIndex=0) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:1099
rtl::OUString::toInt32
sal_Int32 toInt32(sal_Int16 radix=10) const
Returns the int32 value from this string.
Definition: ustring.hxx:3278
rtl::OUString::clear
void clear()
Clears the string, i.e, makes a zero-character string.
Definition: ustring.hxx:806
rtl::OUString::equalsIgnoreAsciiCaseAsciiL
bool equalsIgnoreAsciiCaseAsciiL(const char *asciiStr, sal_Int32 asciiStrLength) const
Perform an ASCII lowercase comparison of two strings.
Definition: ustring.hxx:1372
rtl::OUString::number
static OUString number(unsigned long long ll, sal_Int16 radix=10)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:3641
rtl::OUString::indexOfAsciiL
sal_Int32 indexOfAsciiL(char const *str, sal_Int32 len, sal_Int32 fromIndex=0) const
Returns the index within this string of the first occurrence of the specified ASCII substring,...
Definition: ustring.hxx:2551
rtl::OUString::~OUString
~OUString()
Release the string data.
Definition: ustring.hxx:532
rtl::OUString::compareTo
sal_Int32 compareTo(const OUString &str, sal_Int32 maxLength) const
Compares two strings with a maximum count of characters.
Definition: ustring.hxx:906
rtl::OUString::lastIndexOfAsciiL
sal_Int32 lastIndexOfAsciiL(char const *str, sal_Int32 len) const
Returns the index within this string of the last occurrence of the specified ASCII substring.
Definition: ustring.hxx:2660
rtl::OUString::indexOf
sal_Int32 indexOf(sal_Unicode ch, sal_Int32 fromIndex=0) const
Returns the index within this string of the first occurrence of the specified character,...
Definition: ustring.hxx:2440
rtl::OUString::replaceAll
SAL_WARN_UNUSED_RESULT libreoffice_internal::ConstCharArrayDetector< T, OUString >::Type replaceAll(OUString const &from, T &to) const
Returns a new string resulting from replacing all occurrences of a given substring with another subst...
Definition: ustring.hxx:3100
rtl::OUString::number
static OUString number(long long ll, sal_Int16 radix=10)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:3634
rtl::OUString::matchAsciiL
bool matchAsciiL(const char *asciiStr, sal_Int32 asciiStrLength, sal_Int32 fromIndex=0) const
Match against a substring appearing in this string.
Definition: ustring.hxx:1400
rtl::OUString::replaceAll
SAL_WARN_UNUSED_RESULT OUString replaceAll(OUString const &from, OUString const &to, sal_Int32 fromIndex=0) const
Returns a new string resulting from replacing all occurrences of a given substring with another subst...
Definition: ustring.hxx:3024
rtl::OUString::operator=
libreoffice_internal::ConstCharArrayDetector< T, OUString & >::Type operator=(T &literal)
Assign a new string from an 8-Bit string literal that is expected to contain only characters in the A...
Definition: ustring.hxx:617
rtl::OUString::toFloat
float toFloat() const
Returns the float value from this string.
Definition: ustring.hxx:3340
rtl::OUString::number
static OUString number(unsigned long i, sal_Int16 radix=10)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:3628
rtl::OUString::replaceAll
SAL_WARN_UNUSED_RESULT libreoffice_internal::ConstCharArrayDetector< T1, typename libreoffice_internal::ConstCharArrayDetector< T2, OUString >::Type >::Type replaceAll(T1 &from, T2 &to) const
Returns a new string resulting from replacing all occurrences of a given substring with another subst...
Definition: ustring.hxx:3127
rtl::OUString::createFromAscii
static OUString createFromAscii(const char *value)
Returns an OUString copied without conversion from an ASCII character string.
Definition: ustring.hxx:3817
rtl::OUString::replaceFirst
SAL_WARN_UNUSED_RESULT libreoffice_internal::ConstCharArrayDetector< T, OUString >::Type replaceFirst(T &from, OUString const &to, sal_Int32 *index=NULL) const
Returns a new string resulting from replacing the first occurrence of a given substring with another ...
Definition: ustring.hxx:2899
rtl::OUString::replace
SAL_WARN_UNUSED_RESULT OUString replace(sal_Unicode oldChar, sal_Unicode newChar) const
Returns a new string resulting from replacing all occurrences of oldChar in this string with newChar.
Definition: ustring.hxx:2817
rtl::OUString::hashCode
sal_Int32 hashCode() const
Returns a hashcode for this string.
Definition: ustring.hxx:2422
rtl::OUString::reverseCompareTo
libreoffice_internal::ConstCharArrayDetector< T, sal_Int32 >::Type reverseCompareTo(T &literal) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:944
rtl::OUString::operator==
friend libreoffice_internal::ConstCharArrayDetector< T, bool >::Type operator==(T &literal, const OUString &rString)
Compare string to an ASCII string literal.
Definition: ustring.hxx:2327
rtl::OUString::operator==
friend libreoffice_internal::ConstCharArrayDetector< T, bool >::Type operator==(const OUString &rString, T &literal)
Compare string to an ASCII string literal.
Definition: ustring.hxx:2311
rtl::OUString::number
static OUString number(long i, sal_Int16 radix=10)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:3622
rtl::OUString::equalsIgnoreAsciiCase
libreoffice_internal::ConstCharArrayDetector< T, bool >::Type equalsIgnoreAsciiCase(T &literal) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:1046
rtl::OUString::getStr
const sal_Unicode * getStr() const SAL_RETURNS_NONNULL
Returns a pointer to the Unicode character buffer for this string.
Definition: ustring.hxx:841
rtl::OUString::toUInt64
sal_uInt64 toUInt64(sal_Int16 radix=10) const
Returns the uint64 value from this string.
Definition: ustring.hxx:3327
rtl::OUString::matchIgnoreAsciiCaseAsciiL
bool matchIgnoreAsciiCaseAsciiL(const char *asciiStr, sal_Int32 asciiStrLength, sal_Int32 fromIndex=0) const
Match against a substring appearing in this string, ignoring the case of ASCII letters.
Definition: ustring.hxx:1438
rtl::OUString::operator+=
OUString & operator+=(const OUString &str)
Append a string to this string.
Definition: ustring.hxx:690
rtl::OUString::startsWithIgnoreAsciiCase
libreoffice_internal::ConstCharArrayDetector< T, bool >::Type startsWithIgnoreAsciiCase(T &literal, OUString *rest=NULL) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:1794
rtl::OUString::toUtf8
OString toUtf8() const
Convert this string to an OString, assuming that the string can be UTF-8-encoded successfully.
Definition: ustring.hxx:3559
rtl::OUString::reverseCompareToAsciiL
sal_Int32 reverseCompareToAsciiL(const char *asciiStr, sal_Int32 asciiStrLength) const
Compares two strings in reverse order.
Definition: ustring.hxx:1234
rtl::OUString::equalsAsciiL
bool equalsAsciiL(const char *asciiStr, sal_Int32 asciiStrLength) const
Perform a comparison of two strings.
Definition: ustring.hxx:1277
rtl::OUString::number
static OUString number(unsigned int i, sal_Int16 radix=10)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:3616
rtl::OUString::endsWith
bool endsWith(sal_Unicode ch) const
Check whether this string ends with a given character.
Definition: ustring.hxx:1893
rtl::OUString::convertToString
bool convertToString(OString *pTarget, rtl_TextEncoding nEncoding, sal_uInt32 nFlags) const
Converts to an OString, signalling failure.
Definition: ustring.hxx:3447
rtl::OUString::operator=
OUString & operator=(const OUString &str)
Assign a new string.
Definition: ustring.hxx:582
rtl::OUString::startsWith
libreoffice_internal::ConstCharArrayDetector< T, bool >::Type startsWith(T &literal, OUString *rest=NULL) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:1596
rtl::OUString::OUString
OUString(rtl_uString *str)
New string from OUString data.
Definition: ustring.hxx:245
rtl::OUString::OUString
OUString(const sal_Unicode *value, sal_Int32 length)
New string from a Unicode character buffer array.
Definition: ustring.hxx:331
rtl::OUString::endsWithIgnoreAsciiCase
bool endsWithIgnoreAsciiCase(OUString const &str, OUString *rest=NULL) const
Check whether this string ends with a given string, ignoring the case of ASCII letters.
Definition: ustring.hxx:2126
rtl::OUString::compareTo
sal_Int32 compareTo(const OUString &str) const
Compares two strings.
Definition: ustring.hxx:877
rtl::OUString::operator!=
friend libreoffice_internal::ConstCharArrayDetector< T, bool >::Type operator!=(const OUString &rString, T &literal)
Compare string to an ASCII string literal.
Definition: ustring.hxx:2343
rtl::OUString::startsWith
bool startsWith(OUString const &str, OUString *rest=NULL) const
Check whether this string starts with a given substring.
Definition: ustring.hxx:1526
rtl::OUString::lastIndexOf
sal_Int32 lastIndexOf(sal_Unicode ch) const
Returns the index within this string of the last occurrence of the specified character,...
Definition: ustring.hxx:2456
rtl::OUString::compareToIgnoreAsciiCaseAscii
sal_Int32 compareToIgnoreAsciiCaseAscii(const char *asciiStr) const
Compares two ASCII strings ignoring case.
Definition: ustring.hxx:1336
rtl::OUString::endsWith
bool endsWith(sal_Unicode ch, OUString *rest) const
Check whether this string ends with a given character.
Definition: ustring.hxx:1910
rtl::OUString::replaceFirst
SAL_WARN_UNUSED_RESULT libreoffice_internal::ConstCharArrayDetector< T, OUString >::Type replaceFirst(OUString const &from, T &to, sal_Int32 *index=NULL) const
Returns a new string resulting from replacing the first occurrence of a given substring with another ...
Definition: ustring.hxx:2948
rtl::OUString::OUString
OUString(sal_Unicode value)
New string from a single Unicode character.
Definition: ustring.hxx:274
rtl::OUString::replaceFirst
SAL_WARN_UNUSED_RESULT OUString replaceFirst(OUString const &from, OUString const &to, sal_Int32 *index=NULL) const
Returns a new string resulting from replacing the first occurrence of a given substring with another ...
Definition: ustring.hxx:2854
rtl::OUString::toInt64
sal_Int64 toInt64(sal_Int16 radix=10) const
Returns the int64 value from this string.
Definition: ustring.hxx:3310
rtl::OUString::toUInt32
sal_uInt32 toUInt32(sal_Int16 radix=10) const
Returns the uint32 value from this string.
Definition: ustring.hxx:3295
rtl::OUString::startsWithIgnoreAsciiCase
bool startsWithIgnoreAsciiCase(OUString const &str, OUString *rest=NULL) const
Check whether this string starts with a given string, ignoring the case of ASCII letters.
Definition: ustring.hxx:1718
rtl::OUString::lastIndexOf
sal_Int32 lastIndexOf(const OUString &str, sal_Int32 fromIndex) const
Returns the index within this string of the last occurrence of the specified substring,...
Definition: ustring.hxx:2618
rtl::OUString::toDouble
double toDouble() const
Returns the double value from this string.
Definition: ustring.hxx:3353
rtl::OUString::equalsAscii
bool equalsAscii(const char *asciiStr) const
Perform a comparison of two strings.
Definition: ustring.hxx:1255
rtl::OUString::matchIgnoreAsciiCase
libreoffice_internal::ConstCharArrayDetector< T, bool >::Type matchIgnoreAsciiCase(T &literal, sal_Int32 fromIndex=0) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:1156
rtl::OUString::getToken
OUString getToken(sal_Int32 token, sal_Unicode cTok, sal_Int32 &index) const
Returns a token in the string.
Definition: ustring.hxx:3219
rtl::OUString::getLength
sal_Int32 getLength() const
Returns the length of this string.
Definition: ustring.hxx:819
rtl::OUString::equalsIgnoreAsciiCaseAscii
bool equalsIgnoreAsciiCaseAscii(const char *asciiStr) const
Perform an ASCII lowercase comparison of two strings.
Definition: ustring.hxx:1304
rtl::OUString::OUString
OUString()
New string containing no characters.
Definition: ustring.hxx:180
rtl::OUString::unacquired
static OUString const & unacquired(rtl_uString *const *ppHandle)
Provides an OUString const & passing a storage pointer of an rtl_uString * handle.
Definition: ustring.hxx:558
rtl::OUString::OUString
OUString(const sal_Unicode *value)
New string from a Unicode character buffer array.
Definition: ustring.hxx:315
rtl::OUString::OUString
OUString(const char *value, sal_Int32 length, rtl_TextEncoding encoding, sal_uInt32 convertFlags=OSTRING_TO_OUSTRING_CVTFLAGS)
New string from an 8-Bit character buffer array.
Definition: ustring.hxx:451
rtl::OUString::number
static OUString number(float f)
Returns the string representation of the float argument.
Definition: ustring.hxx:3657
rtl::OUString::isEmpty
bool isEmpty() const
Checks if a string is empty.
Definition: ustring.hxx:829
rtl::OUString::compareToIgnoreAsciiCase
sal_Int32 compareToIgnoreAsciiCase(const OUString &str) const
Perform an ASCII lowercase comparison of two strings.
Definition: ustring.hxx:1033
rtl::OUString::OUString
OUString(sal_uInt32 const *codePoints, sal_Int32 codePointCount)
Create a new string from an array of Unicode code points.
Definition: ustring.hxx:478
rtl::OUString::endsWith
libreoffice_internal::ConstCharArrayDetector< T, bool >::Type endsWith(T &literal, OUString *rest=NULL) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:2003
rtl::OUString::toChar
sal_Unicode toChar() const
Returns the first character from this string.
Definition: ustring.hxx:3263
rtl::OUString::getToken
OUString getToken(sal_Int32 count, sal_Unicode separator) const
Returns a token from the string.
Definition: ustring.hxx:3239
rtl::OUString::boolean
static OUString boolean(bool b)
Returns the string representation of the boolean argument.
Definition: ustring.hxx:3725
rtl::OUString::lastIndexOf
libreoffice_internal::ConstCharArrayDetector< T, sal_Int32 >::Type lastIndexOf(T &literal) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:2631
rtl::OUString::copy
SAL_WARN_UNUSED_RESULT OUString copy(sal_Int32 beginIndex, sal_Int32 count) const
Returns a new string that is a substring of this string.
Definition: ustring.hxx:2693
rtl::OUString::endsWithIgnoreAsciiCase
libreoffice_internal::ConstCharArrayDetector< T, bool >::Type endsWithIgnoreAsciiCase(T &literal, OUString *rest=NULL) const
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustring.hxx:2187
rtl::OUString::OUString
OUString(rtl_uString *str, __sal_NoAcquire)
New OUString from OUString data without acquiring it.
Definition: ustring.hxx:266
rtl::OUString::lastIndexOf
sal_Int32 lastIndexOf(sal_Unicode ch, sal_Int32 fromIndex) const
Returns the index within this string of the last occurrence of the specified character,...
Definition: ustring.hxx:2473
rtl::OUString::trim
SAL_WARN_UNUSED_RESULT OUString trim() const
Returns a new string resulting from removing white space from both ends of the string.
Definition: ustring.hxx:3188
rtl::OUString::toAsciiUpperCase
SAL_WARN_UNUSED_RESULT OUString toAsciiUpperCase() const
Converts from this string all ASCII lowercase characters (97-122) to ASCII uppercase characters (65-9...
Definition: ustring.hxx:3168
rtl::OUString::concat
SAL_WARN_UNUSED_RESULT OUString concat(const OUString &str) const
Concatenates the specified string to the end of this string.
Definition: ustring.hxx:2749
rtl::OUString::replaceAt
SAL_WARN_UNUSED_RESULT OUString replaceAt(sal_Int32 index, sal_Int32 count, const OUString &newStr) const
Returns a new string resulting from replacing n = count characters from position index in this string...
Definition: ustring.hxx:2777
rtl::OUString::match
bool match(const OUString &str, sal_Int32 fromIndex=0) const
Match against a substring appearing in this string.
Definition: ustring.hxx:1085
rtl::OUString::matchIgnoreAsciiCase
bool matchIgnoreAsciiCase(const OUString &str, sal_Int32 fromIndex=0) const
Match against a substring appearing in this string, ignoring the case of ASCII letters.
Definition: ustring.hxx:1141
rtl::OUString::compareToAscii
sal_Int32 compareToAscii(const char *asciiStr) const
Compares two strings.
Definition: ustring.hxx:1181
rtl::OUString::OUString
OUString(T &literal, typename libreoffice_internal::ConstCharArrayDetector< T, libreoffice_internal::Dummy >::Type=libreoffice_internal::Dummy())
New string from an 8-Bit string literal that is expected to contain only characters in the ASCII set ...
Definition: ustring.hxx:353
rtl::OUString::reverseCompareTo
sal_Int32 reverseCompareTo(const OUString &str) const
Compares two strings in reverse order.
Definition: ustring.hxx:931
rtl::OUString::number
static OUString number(double d)
Returns the string representation of the double argument.
Definition: ustring.hxx:3679
rtl::OUString::operator+
friend OUString operator+(const OUString &rStr1, const OUString &rStr2)
Definition: ustring.hxx:2758
rtl::OUString::copy
SAL_WARN_UNUSED_RESULT OUString copy(sal_Int32 beginIndex) const
Returns a new string that is a substring of this string.
Definition: ustring.hxx:2676
rtl::OUString::operator!=
friend libreoffice_internal::ConstCharArrayDetector< T, bool >::Type operator!=(T &literal, const OUString &rString)
Compare string to an ASCII string literal.
Definition: ustring.hxx:2359
rtl::OUString::equals
bool equals(const OUString &str) const
Perform a comparison of two strings.
Definition: ustring.hxx:965
rtl::OUString::lastIndexOf
sal_Int32 lastIndexOf(const OUString &str) const
Returns the index within this string of the last occurrence of the specified substring,...
Definition: ustring.hxx:2589
rtl::OUString::toBoolean
bool toBoolean() const
Returns the Boolean value from this string.
Definition: ustring.hxx:3252
rtl::OUString::indexOf
sal_Int32 indexOf(const OUString &str, sal_Int32 fromIndex=0) const
Returns the index within this string of the first occurrence of the specified substring,...
Definition: ustring.hxx:2501
rtl::OUString::intern
static OUString intern(const char *value, sal_Int32 length, rtl_TextEncoding encoding, sal_uInt32 convertFlags=OSTRING_TO_OUSTRING_CVTFLAGS, sal_uInt32 *pInfo=NULL)
Return a canonical representation for a converted string.
Definition: ustring.hxx:3409
rtl::OUStringHash
A helper to use OUStrings with hash maps.
Definition: ustring.hxx:3942
rtl::OUStringHash::operator()
size_t operator()(const OUString &rString) const
Compute a hash code for a string.
Definition: ustring.hxx:3952
Generated by doxygen 1.9.1