20 #ifndef _RTL_USTRING_HXX_
21 #define _RTL_USTRING_HXX_
36 #ifdef RTL_FAST_STRING
40 #if defined EXCEPTIONS_OFF
51 #ifdef RTL_STRING_UNITTEST
52 #define rtl rtlunittest
58 #ifdef RTL_STRING_UNITTEST
95 class DO_NOT_ACQUIRE{};
196 template<
typename T >
205 #ifdef RTL_STRING_UNITTEST
206 rtl_string_unittest_const_literal =
true;
210 #ifdef RTL_STRING_UNITTEST
215 template<
typename T >
220 rtl_string_unittest_invalid_conversion =
true;
226 template<
typename T >
227 OUString(
const T&,
typename internal::ExceptCharArrayDetector< T >::Type = internal::Dummy() )
231 rtl_string_unittest_invalid_conversion =
true;
256 #if defined EXCEPTIONS_OFF
259 throw std::bad_alloc();
281 sal_uInt32
const * codePoints, sal_Int32 codePointCount):
286 #if defined EXCEPTIONS_OFF
289 throw std::bad_alloc();
294 #ifdef RTL_FAST_STRING
299 template<
typename T1,
typename T2 >
300 OUString(
const OUStringConcat< T1, T2 >& c )
302 const sal_Int32 l = c.length();
307 pData->length = end - pData->buffer;
334 {
return *
reinterpret_cast< OUString const *
>( ppHandle ); }
359 template<
typename T >
381 #ifdef RTL_FAST_STRING
386 template<
typename T1,
typename T2 >
387 OUString& operator+=(
const OUStringConcat< T1, T2 >& c )
389 const int l = c.length();
393 sal_Unicode* end = c.addData( pData->buffer + pData->length );
395 pData->length = end - pData->buffer;
420 return pData->length == 0;
442 assert(index >= 0 && index <= getLength());
447 return getStr()[index];
465 str.pData->buffer, str.pData->length );
486 str.pData->buffer, str.pData->length, maxLength );
504 str.pData->buffer, str.pData->length );
512 template<
typename T >
533 if ( pData->length != str.pData->length )
535 if ( pData == str.pData )
538 str.pData->buffer, str.pData->length ) == 0;
557 if ( pData->length != str.pData->length )
559 if ( pData == str.pData )
562 str.pData->buffer, str.pData->length ) == 0;
583 str.pData->buffer, str.pData->length );
592 template<
typename T >
628 template<
typename T >
658 str.
pData->length ) == 0;
666 template<
typename T >
718 "replace s1.compareToAscii(s2, strlen(s2)) == 0 with s1.startsWith(s2)")
719 sal_Int32 compareToAscii( const
sal_Char * asciiStr, sal_Int32 maxLength ) const
SAL_THROW(())
722 asciiStr, maxLength );
744 sal_Int32 reverseCompareToAsciiL(
const sal_Char * asciiStr, sal_Int32 asciiStrLength )
const SAL_THROW(())
747 asciiStr, asciiStrLength );
790 if ( pData->length != asciiStrLength )
794 pData->buffer, asciiStr, asciiStrLength );
838 sal_Int32 compareToIgnoreAsciiCaseAscii(
const sal_Char * asciiStr )
const SAL_THROW(())
865 if ( pData->length != asciiStrLength )
895 asciiStr, asciiStrLength ) == 0;
902 #if SAL_TYPES_SIZEOFLONG == 8
930 sal_Bool matchIgnoreAsciiCaseAsciiL(
const sal_Char* asciiStr, sal_Int32 asciiStrLength, sal_Int32 fromIndex = 0 ) const
SAL_THROW(())
933 asciiStr, asciiStrLength ) == 0;
940 #if SAL_TYPES_SIZEOFLONG == 8
955 bool startsWith(OUString
const & str)
const {
956 return match(str, 0);
964 template<
typename T >
965 typename internal::ConstCharArrayDetector< T, bool >::Type startsWith( T& literal )
const
967 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
968 return internal::ConstCharArrayDetector< T, void >::size - 1 <= pData->length
970 internal::ConstCharArrayDetector< T, void >::size - 1);
988 return matchIgnoreAsciiCase(str, 0);
996 template<
typename T >
997 typename internal::ConstCharArrayDetector< T, bool >::Type startsWithIgnoreAsciiCase( T& literal )
const SAL_THROW(())
999 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1002 internal::ConstCharArrayDetector< T, void >::size - 1, literal,
1003 internal::ConstCharArrayDetector< T, void >::size - 1)
1017 bool endsWith(OUString
const & str)
const {
1018 return str.getLength() <= getLength()
1019 && match(str, getLength() - str.getLength());
1027 template<
typename T >
1028 typename internal::ConstCharArrayDetector< T, bool >::Type endsWith( T& literal )
const
1030 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1031 return internal::ConstCharArrayDetector< T, void >::size - 1 <= pData->length
1033 pData->buffer + pData->length - ( internal::ConstCharArrayDetector< T, void >::size - 1 ), literal,
1034 internal::ConstCharArrayDetector< T, void >::size - 1);
1048 inline bool endsWithAsciiL(
char const * asciiStr, sal_Int32 asciiStrLength)
1051 return asciiStrLength <= pData->length
1053 pData->buffer + pData->length - asciiStrLength, asciiStr,
1072 return str.getLength() <= getLength()
1073 && matchIgnoreAsciiCase(str, getLength() - str.getLength());
1081 template<
typename T >
1082 typename internal::ConstCharArrayDetector< T, bool >::Type endsWithIgnoreAsciiCase( T& literal )
const SAL_THROW(())
1084 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1085 return internal::ConstCharArrayDetector< T, void >::size - 1 <= pData->length
1087 pData->buffer + pData->length - ( internal::ConstCharArrayDetector< T, void >::size - 1 ),
1088 internal::ConstCharArrayDetector< T, void >::size - 1, literal,
1089 internal::ConstCharArrayDetector< T, void >::size - 1)
1103 inline bool endsWithIgnoreAsciiCaseAsciiL(
1104 char const * asciiStr, sal_Int32 asciiStrLength)
const
1106 return asciiStrLength <= pData->length
1108 pData->buffer + pData->length - asciiStrLength,
1109 asciiStrLength, asciiStr, asciiStrLength)
1114 {
return rStr1.equals(rStr2); }
1116 {
return rStr1.compareTo( pStr2 ) == 0; }
1118 {
return OUString( pStr1 ).compareTo( rStr2 ) == 0; }
1128 {
return rStr1.compareTo( rStr2 ) < 0; }
1130 {
return rStr1.compareTo( rStr2 ) > 0; }
1131 friend sal_Bool operator <= (
const OUString& rStr1,
const OUString& rStr2 )
SAL_THROW(())
1132 {
return rStr1.compareTo( rStr2 ) <= 0; }
1133 friend sal_Bool operator >= (
const OUString& rStr1,
const OUString& rStr2 )
SAL_THROW(())
1134 {
return rStr1.compareTo( rStr2 ) >= 0; }
1143 template<
typename T >
1144 friend inline typename internal::ConstCharArrayDetector< T, bool >::Type
operator==(
const OUString&
string, T& literal )
1146 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1147 return string.equalsAsciiL( literal, internal::ConstCharArrayDetector< T, void >::size - 1 );
1156 template<
typename T >
1157 friend inline typename internal::ConstCharArrayDetector< T, bool >::Type
operator==( T& literal,
const OUString&
string )
1159 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1160 return string.equalsAsciiL( literal, internal::ConstCharArrayDetector< T, void >::size - 1 );
1169 template<
typename T >
1170 friend inline typename internal::ConstCharArrayDetector< T, bool >::Type
operator!=(
const OUString&
string, T& literal )
1172 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1173 return !
string.equalsAsciiL( literal, internal::ConstCharArrayDetector< T, void >::size - 1 );
1182 template<
typename T >
1183 friend inline typename internal::ConstCharArrayDetector< T, bool >::Type
operator!=( T& literal,
const OUString&
string )
1185 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1186 return !
string.equalsAsciiL( literal, internal::ConstCharArrayDetector< T, void >::size - 1 );
1196 sal_Int32 hashCode() const
SAL_THROW(())
1217 return (ret < 0 ? ret : ret+fromIndex);
1266 sal_Int32 indexOf(
const OUString & str, sal_Int32 fromIndex = 0 ) const
SAL_THROW(())
1269 str.pData->buffer, str.pData->length );
1270 return (ret < 0 ? ret : ret+fromIndex);
1278 template<
typename T >
1279 typename internal::ConstCharArrayDetector< T, sal_Int32 >::Type indexOf( T& literal, sal_Int32 fromIndex = 0 ) const
SAL_THROW(())
1281 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1283 pData->buffer + fromIndex, pData->length - fromIndex, literal,
1284 internal::ConstCharArrayDetector< T, void >::size - 1);
1285 return ret < 0 ? ret : ret + fromIndex;
1311 sal_Int32 indexOfAsciiL(
1312 char const * str, sal_Int32 len, sal_Int32 fromIndex = 0) const
1316 pData->buffer + fromIndex, pData->length - fromIndex, str, len);
1317 return ret < 0 ? ret : ret + fromIndex;
1324 #if SAL_TYPES_SIZEOFLONG == 8
1343 sal_Int32 lastIndexOf(
const OUString & str )
const SAL_THROW(())
1346 str.pData->buffer, str.pData->length );
1366 sal_Int32 lastIndexOf(
const OUString & str, sal_Int32 fromIndex )
const SAL_THROW(())
1369 str.pData->buffer, str.pData->length );
1377 template<
typename T >
1378 typename internal::ConstCharArrayDetector< T, sal_Int32 >::Type lastIndexOf( T& literal )
const SAL_THROW(())
1380 assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1382 pData->buffer, pData->length, literal, internal::ConstCharArrayDetector< T, void >::size - 1);
1404 sal_Int32 lastIndexOfAsciiL(
char const * str, sal_Int32 len)
const
1408 pData->buffer, pData->length, str, len);
1423 rtl_uString *pNew = 0;
1425 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
1442 rtl_uString *pNew = 0;
1444 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
1457 rtl_uString* pNew = 0;
1459 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
1462 #ifndef RTL_FAST_STRING
1463 friend OUString operator+(
const OUString& rStr1,
const OUString& rStr2 )
SAL_THROW(())
1465 return rStr1.concat( rStr2 );
1484 rtl_uString* pNew = 0;
1486 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
1504 rtl_uString* pNew = 0;
1506 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
1528 OUString
const & from, OUString
const & to, sal_Int32 * index = 0)
const
1530 rtl_uString * s = 0;
1533 &s, pData, from.pData, to.pData, index == 0 ? &i : index);
1555 template<
typename T >
1556 SAL_WARN_UNUSED_RESULT typename internal::ConstCharArrayDetector< T, OUString >::Type replaceFirst( T& from, OUString
const & to,
1557 sal_Int32 * index = 0)
const
1559 rtl_uString * s = 0;
1561 assert( strlen( from ) == internal::ConstCharArrayDetector< T >::size - 1 );
1563 &s, pData, from, internal::ConstCharArrayDetector< T, void >::size - 1, to.pData, index == 0 ? &i : index);
1585 template<
typename T1,
typename T2 >
1586 SAL_WARN_UNUSED_RESULT typename internal::ConstCharArrayDetector< T1, typename internal::ConstCharArrayDetector< T2, OUString >::Type >::Type
1587 replaceFirst( T1& from, T2& to, sal_Int32 * index = 0)
const
1589 rtl_uString * s = 0;
1591 assert( strlen( from ) == internal::ConstCharArrayDetector< T1 >::size - 1 );
1592 assert( strlen( to ) == internal::ConstCharArrayDetector< T2 >::size - 1 );
1594 &s, pData, from, internal::ConstCharArrayDetector< T1, void >::size - 1, to,
1595 internal::ConstCharArrayDetector< T2, void >::size - 1, index == 0 ? &i : index);
1615 OUString
const & from, OUString
const & to, sal_Int32 fromIndex = 0)
const
1617 rtl_uString * s = 0;
1635 template<
typename T >
1636 SAL_WARN_UNUSED_RESULT typename internal::ConstCharArrayDetector< T, OUString >::Type replaceAll( T& from, OUString
const & to)
const
1638 rtl_uString * s = 0;
1639 assert( strlen( from ) == internal::ConstCharArrayDetector< T >::size - 1 );
1657 template<
typename T1,
typename T2 >
1658 SAL_WARN_UNUSED_RESULT typename internal::ConstCharArrayDetector< T1, typename internal::ConstCharArrayDetector< T2, OUString >::Type >::Type
1659 replaceAll( T1& from, T2& to )
const
1661 rtl_uString * s = 0;
1662 assert( strlen( from ) == internal::ConstCharArrayDetector< T1 >::size - 1 );
1663 assert( strlen( to ) == internal::ConstCharArrayDetector< T2 >::size - 1 );
1665 &s, pData, from, internal::ConstCharArrayDetector< T1, void >::size - 1,
1666 to, internal::ConstCharArrayDetector< T2, void >::size - 1);
1682 rtl_uString* pNew = 0;
1684 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
1699 rtl_uString* pNew = 0;
1701 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
1717 rtl_uString* pNew = 0;
1719 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
1748 rtl_uString * pNew = 0;
1750 return OUString( pNew, (DO_NOT_ACQUIRE *)0 );
1766 OUString getToken(sal_Int32 count,
sal_Unicode separator)
const {
1768 return getToken(count, separator, n);
1792 return pData->buffer[0];
1804 sal_Int32 toInt32( sal_Int16 radix = 10 ) const
SAL_THROW(())
1818 sal_Int64 toInt64( sal_Int16 radix = 10 ) const
SAL_THROW(())
1835 sal_uInt64 toUInt64( sal_Int16 radix = 10 ) const
SAL_THROW(())
1882 OUString intern()
const
1884 rtl_uString * pNew = 0;
1887 #if defined EXCEPTIONS_OFF
1890 throw std::bad_alloc();
1893 return OUString( pNew, (DO_NOT_ACQUIRE *)0 );
1921 static OUString intern(
const sal_Char * value, sal_Int32 length,
1924 sal_uInt32 *pInfo = NULL )
1926 rtl_uString * pNew = 0;
1928 convertFlags, pInfo );
1930 #if defined EXCEPTIONS_OFF
1933 throw std::bad_alloc();
1936 return OUString( pNew, (DO_NOT_ACQUIRE *)0 );
1964 sal_uInt32 nFlags)
const
1967 pData->length, nEncoding, nFlags);
2021 inline sal_uInt32 iterateCodePoints(
2022 sal_Int32 * indexUtf16, sal_Int32 incrementCodePoints = 1)
const
2025 pData, indexUtf16, incrementCodePoints);
2038 static OUString number(
int i, sal_Int16 radix = 10 )
2041 rtl_uString* pNewData = 0;
2043 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2047 static OUString number(
unsigned int i, sal_Int16 radix = 10 )
2049 return number( static_cast< unsigned long long >( i ), radix );
2053 static OUString number(
long i, sal_Int16 radix = 10)
2055 return number( static_cast< long long >( i ), radix );
2059 static OUString number(
unsigned long i, sal_Int16 radix = 10 )
2061 return number( static_cast< unsigned long long >( i ), radix );
2065 static OUString number(
long long ll, sal_Int16 radix = 10 )
2068 rtl_uString* pNewData = 0;
2070 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2074 static OUString number(
unsigned long long ll, sal_Int16 radix = 10 )
2077 rtl_uString* pNewData = 0;
2079 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2091 static OUString number(
float f )
2094 rtl_uString* pNewData = 0;
2096 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2108 static OUString number(
double d )
2111 rtl_uString* pNewData = 0;
2113 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2143 static OUString boolean(
bool b )
SAL_THROW(())
2146 rtl_uString* pNewData = 0;
2148 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2160 return OUString( &c, 1 );
2175 return number( i, radix );
2190 return number( ll, radix );
2238 rtl_uString* pNew = 0;
2240 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
2246 #ifdef RTL_FAST_STRING
2258 OUStringLiteral(
const char (&str)[ N ] ) : size( N - 1 ), data( str ) { assert( strlen( str ) == N - 1 ); }
2267 struct ToStringHelper< OUString >
2269 static int length(
const OUString& s ) {
return s.getLength(); }
2270 static sal_Unicode* addData(
sal_Unicode* buffer,
const OUString& s ) {
return addDataHelper( buffer, s.getStr(), s.getLength()); }
2271 static const bool allowOStringConcat =
false;
2272 static const bool allowOUStringConcat =
true;
2283 static const bool allowOStringConcat =
false;
2284 static const bool allowOUStringConcat =
true;
2290 template<
typename charT,
typename traits,
typename T1,
typename T2 >
2291 inline std::basic_ostream<charT, traits> &
operator <<(
2292 std::basic_ostream<charT, traits> & stream,
const OUStringConcat< T1, T2 >& concat)
2294 return stream << OUString( concat );
2318 {
return (
size_t)rString.hashCode(); }
2381 template<
typename charT,
typename traits >
2383 std::basic_ostream<charT, traits> & stream,
OUString const &
string)
2393 #ifdef RTL_STRING_UNITTEST
2396 typedef rtlunittest::OUString OUString;
2405 using ::rtl::OUString;
2406 using ::rtl::OUStringHash;
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.
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.
#define RTL_STR_MAX_VALUEOFINT64
Definition: string.h:650
OUString(sal_Unicode value)
New string from a single Unicode character.
Definition: ustring.hxx:150
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.
SAL_DLLPUBLIC void rtl_uString_newFromAscii(rtl_uString **newStr, const sal_Char *value) SAL_THROW_EXTERN_C()
Allocate a new string that contains a copy of a character array.
#define SAL_UNUSED_PARAMETER
Annotate unused but required C++ function parameters.
Definition: types.h:540
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.
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.
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.
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.
sal_Bool equals(const OUString &str) const
Perform a comparison of two strings.
Definition: ustring.hxx:531
SAL_DLLPUBLIC void rtl_uString_acquire(rtl_uString *str) SAL_THROW_EXTERN_C()
Increment the reference count of a string.
SAL_DLLPUBLIC sal_Int32 rtl_ustr_valueOfDouble(sal_Unicode *str, double d) SAL_THROW_EXTERN_C()
Create the string representation of a double.
sal_uInt16 rtl_TextEncoding
The various supported text encodings.
Definition: textenc.h:39
sal_Int32 compareToIgnoreAsciiCase(const OUString &str) const
Perform a ASCII lowercase comparison of two strings.
Definition: ustring.hxx:580
sal_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:654
OUString OUStringLiteral
Definition: ustring.hxx:2298
sal_uInt16 sal_Unicode
Definition: types.h:134
#define OUSTRING_TO_OSTRING_CVTFLAGS
Definition: string.h:1303
A helper to use OUStrings with hash maps.
Definition: ustring.hxx:2306
SAL_DLLPUBLIC sal_Int32 rtl_ustr_valueOfFloat(sal_Unicode *str, float f) SAL_THROW_EXTERN_C()
Create the string representation of a float.
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.
~OUString()
Release the string data.
Definition: ustring.hxx:317
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.
#define RTL_USTR_MAX_VALUEOFFLOAT
Definition: ustring.h:1022
sal_Bool operator<(const TTimeValue &rTimeA, const TTimeValue &rTimeB)
Definition: timer.hxx:98
sal_Bool equalsIgnoreAsciiCase(const OUString &str) const
Perform a ASCII lowercase comparison of two strings.
Definition: ustring.hxx:555
OUString(rtl_uString *str)
New string from OUString data.
Definition: ustring.hxx:128
const sal_Char * getStr() const
Returns a pointer to the characters of this string.
Definition: string.hxx:367
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...
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.
#define RTL_USTR_MAX_VALUEOFBOOLEAN
Definition: ustring.h:915
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...
#define SAL_DEPRECATED(message)
Use as follows: SAL_DEPRECATED("Dont use, its evil.") void doit(int nPara);.
Definition: types.h:477
definition of a no acquire enum for ctors
Definition: types.h:374
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:513
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.
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.
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.
Definition: stringutils.hxx:110
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...
sal_Int32 getLength() const
Returns the length of this string.
Definition: string.hxx:341
#define RTL_USTR_MAX_VALUEOFDOUBLE
Definition: ustring.h:1041
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.
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.
SAL_DLLPUBLIC sal_Int32 rtl_ustr_ascii_compareIgnoreAsciiCase_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Char *second) SAL_THROW_EXTERN_C()
Compare two strings, ignoring the case of ASCII characters.
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...
SAL_DLLPUBLIC sal_Int32 rtl_ustr_valueOfBoolean(sal_Unicode *str, sal_Bool b) SAL_THROW_EXTERN_C()
Create the string representation of a boolean.
sal_Int32 compareTo(const OUString &str) const
Compares two strings.
Definition: ustring.hxx:462
sal_Int32 getLength() const
Returns the length of this string.
Definition: ustring.hxx:408
SAL_DLLPUBLIC sal_Int32 rtl_ustr_toInt32(const sal_Unicode *str, sal_Int16 radix) SAL_THROW_EXTERN_C()
Interpret a string as an integer.
sal_Bool match(const OUString &str, sal_Int32 fromIndex=0) const
Match against a substring appearing in this string.
Definition: ustring.hxx:617
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.
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:2340
SAL_DLLPUBLIC void rtl_uString_release(rtl_uString *str) SAL_THROW_EXTERN_C()
Decrement the reference count of a string.
pData
Definition: ustring.hxx:200
OUString(const sal_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:249
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.
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...
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.
sal_Bool operator==(const TTimeValue &rTimeA, const TTimeValue &rTimeB)
Definition: timer.hxx:118
size_t operator()(const OUString &rString) const
Compute a hash code for a string.
Definition: ustring.hxx:2317
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...
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:2364
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...
SAL_DLLPUBLIC double rtl_ustr_toDouble(const sal_Unicode *str) SAL_THROW_EXTERN_C()
Interpret a string as a double.
sal_Bool operator>(const TTimeValue &rTimeA, const TTimeValue &rTimeB)
Definition: timer.hxx:108
#define OSTRING_TO_OUSTRING_CVTFLAGS
Definition: ustring.h:1796
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.
OUString(const OUString &str)
New string from OUString.
Definition: ustring.hxx:117
char sal_Char
Definition: types.h:122
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:593
SAL_DLLPUBLIC sal_Int32 rtl_ustr_ascii_compare_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Char *second) SAL_THROW_EXTERN_C()
Compare two strings.
unsigned char sal_Bool
Definition: types.h:37
#define sal_False
Definition: types.h:38
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:629
SAL_DLLPUBLIC sal_Int32 rtl_ustr_ascii_shortenedCompareIgnoreAsciiCase_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Char *second, sal_Int32 shortenedLen) SAL_THROW_EXTERN_C()
Compare two strings with a maximum count of characters, ignoring the case of ASCII characters...
OUString(rtl_uString *str, __sal_NoAcquire)
New OUString from OUString data without acquiring it.
Definition: ustring.hxx:142
#define RTL_TEXTENCODING_UTF8
Definition: textenc.h:121
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...
#define SAL_WARN_UNUSED
Annotate classes where a compiler should warn if an instance is unused.
Definition: types.h:561
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.
SAL_DLLPUBLIC void rtl_uString_intern(rtl_uString **newStr, rtl_uString *str) SAL_THROW_EXTERN_C()
Return a canonical representation for a string.
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.
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...
SAL_DLLPUBLIC sal_Int32 rtl_ustr_ascii_shortenedCompare_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Char *second, sal_Int32 shortenedLen) SAL_THROW_EXTERN_C()
Compare two strings with a maximum count of characters.
sal_Int32 compareTo(const OUString &str, sal_Int32 maxLength) const
Compares two strings with a maximum count of characters.
Definition: ustring.hxx:483
SAL_DLLPUBLIC void rtl_uString_newFromLiteral(rtl_uString **newStr, const sal_Char *value, sal_Int32 len, sal_Int32 allocExtra) SAL_THROW_EXTERN_C()
__sal_NoAcquire
Definition: types.h:370
SAL_DLLPUBLIC float rtl_ustr_toFloat(const sal_Unicode *str) SAL_THROW_EXTERN_C()
Interpret a string as a float.
SAL_DLLPUBLIC void rtl_uString_internConvert(rtl_uString **newStr, const sal_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.
#define SAL_WARN_UNUSED_RESULT
Use this as markup for functions and methods whose return value must be checked.
Definition: types.h:303
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.
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.
#define SAL_DEPRECATED_INTERNAL(message)
This macro is used to tag interfaces that are deprecated for both internal and external API users...
Definition: types.h:492
SAL_DLLPUBLIC void rtl_uString_assign(rtl_uString **str, rtl_uString *rightValue) SAL_THROW_EXTERN_C()
Assign a new value to a string.
This String class provides base functionality for C++ like Unicode character array handling...
Definition: ustring.hxx:87
sal_Int32 compareToAscii(const sal_Char *asciiStr) const
Compares two strings.
Definition: ustring.hxx:690
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...
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.
static OUString const & unacquired(rtl_uString *const *ppHandle)
Provides an OUString const & passing a storage pointer of an rtl_uString * handle.
Definition: ustring.hxx:333
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.
sal_Int32 reverseCompareTo(const OUString &str) const
Compares two strings in reverse order.
Definition: ustring.hxx:501
OUString(const sal_Unicode *value, sal_Int32 length)
New string from a Unicode character buffer array.
Definition: ustring.hxx:175
#define RTL_USTR_MAX_VALUEOFINT32
Definition: ustring.h:957
SAL_DLLPUBLIC void rtl_uString_new(rtl_uString **newStr) SAL_THROW_EXTERN_C()
Allocate a new string containing no characters.
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.
std::basic_ostream< charT, traits > & operator<<(std::basic_ostream< charT, traits > &stream, OString const &string)
Support for rtl::OString in std::ostream (and thus in CPPUNIT_ASSERT or SAL_INFO macros, for example).
Definition: string.hxx:1696
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.
bool isEmpty() const
Checks if a string is empty.
Definition: ustring.hxx:418
sal_Bool operator!=(const Any &rAny, const C &value)
Template unequality operator: compares set value of left side any to right side value.
Definition: Any.hxx:558
SAL_DLLPUBLIC sal_Bool rtl_ustr_asciil_reverseEquals_WithLength(const sal_Unicode *first, const sal_Char *second, sal_Int32 len) SAL_THROW_EXTERN_C()
Compare two strings from back to front for equality.
OUString(sal_uInt32 const *codePoints, sal_Int32 codePointCount)
Create a new string from an array of Unicode code points.
Definition: ustring.hxx:280
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.
This String class provide base functionality for C++ like 8-Bit character array handling.
Definition: string.hxx:90
Definition: stringutils.hxx:67
OUString()
New string containing no characters.
Definition: ustring.hxx:106
#define SAL_THROW(exc)
Definition of function throw clause macros.
Definition: types.h:356
#define RTL_STR_MAX_VALUEOFUINT64
Definition: string.h:673
SAL_DLLPUBLIC void rtl_string2UString(rtl_uString **newStr, const sal_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.
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:360
OUString(const sal_Unicode *value)
New string from a Unicode character buffer array.
Definition: ustring.hxx:161
const sal_Unicode * getStr() const
Returns a pointer to the Unicode character buffer for this string.
Definition: ustring.hxx:430
SAL_DLLPUBLIC sal_Bool rtl_ustr_toBoolean(const sal_Unicode *str) SAL_THROW_EXTERN_C()
Interpret a string as a boolean.
SAL_DLLPUBLIC sal_Int32 rtl_ustr_asciil_reverseCompare_WithLength(const sal_Unicode *first, sal_Int32 firstLen, const sal_Char *second, sal_Int32 secondLen) SAL_THROW_EXTERN_C()
Compare two strings from back to front.
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:667
OUString & operator=(const OUString &str)
Assign a new string.
Definition: ustring.hxx:341
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.
#define sal_True
Definition: types.h:39
OUString & operator+=(const OUString &str)
Append a string to this string.
Definition: ustring.hxx:375