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;
333 static inline OUString const & unacquired( rtl_uString *
const * ppHandle )
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 >
620 str.pData->buffer, str.pData->length, str.pData->length ) == 0;
628 template<
typename T >
657 str.pData->buffer, str.pData->length,
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];
1805 sal_Int32 toInt32( sal_Int16 radix = 10 ) const
SAL_THROW(())
1820 sal_Int64 toInt64( sal_Int16 radix = 10 ) const
SAL_THROW(())
1837 sal_uInt64 toUInt64( sal_Int16 radix = 10 ) const
SAL_THROW(())
1884 OUString intern()
const
1886 rtl_uString * pNew = 0;
1889 #if defined EXCEPTIONS_OFF
1892 throw std::bad_alloc();
1895 return OUString( pNew, (DO_NOT_ACQUIRE *)0 );
1923 static OUString intern(
const sal_Char * value, sal_Int32 length,
1926 sal_uInt32 *pInfo = NULL )
1928 rtl_uString * pNew = 0;
1930 convertFlags, pInfo );
1932 #if defined EXCEPTIONS_OFF
1935 throw std::bad_alloc();
1938 return OUString( pNew, (DO_NOT_ACQUIRE *)0 );
1966 sal_uInt32 nFlags)
const
1969 pData->length, nEncoding, nFlags);
2023 inline sal_uInt32 iterateCodePoints(
2024 sal_Int32 * indexUtf16, sal_Int32 incrementCodePoints = 1)
const
2027 pData, indexUtf16, incrementCodePoints);
2040 static OUString number(
int i, sal_Int16 radix = 10 )
2043 rtl_uString* pNewData = 0;
2045 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2049 static OUString number(
unsigned int i, sal_Int16 radix = 10 )
2051 return number( static_cast< unsigned long long >( i ), radix );
2055 static OUString number(
long i, sal_Int16 radix = 10)
2057 return number( static_cast< long long >( i ), radix );
2061 static OUString number(
unsigned long i, sal_Int16 radix = 10 )
2063 return number( static_cast< unsigned long long >( i ), radix );
2067 static OUString number(
long long ll, sal_Int16 radix = 10 )
2070 rtl_uString* pNewData = 0;
2072 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2076 static OUString number(
unsigned long long ll, sal_Int16 radix = 10 )
2079 rtl_uString* pNewData = 0;
2081 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2093 static OUString number(
float f )
2096 rtl_uString* pNewData = 0;
2098 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2110 static OUString number(
double d )
2113 rtl_uString* pNewData = 0;
2115 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2145 static OUString boolean(
bool b )
SAL_THROW(())
2148 rtl_uString* pNewData = 0;
2150 return OUString( pNewData, (DO_NOT_ACQUIRE*)0 );
2162 return OUString( &c, 1 );
2177 return number( i, radix );
2192 return number( ll, radix );
2240 rtl_uString* pNew = 0;
2242 return OUString( pNew, (DO_NOT_ACQUIRE*)0 );
2248 #ifdef RTL_FAST_STRING
2260 OUStringLiteral(
const char (&str)[ N ] ) : size( N - 1 ), data( str ) { assert( strlen( str ) == N - 1 ); }
2269 struct ToStringHelper< OUString >
2271 static int length(
const OUString& s ) {
return s.getLength(); }
2272 static sal_Unicode* addData(
sal_Unicode* buffer,
const OUString& s ) {
return addDataHelper( buffer, s.getStr(), s.getLength()); }
2273 static const bool allowOStringConcat =
false;
2274 static const bool allowOUStringConcat =
true;
2285 static const bool allowOStringConcat =
false;
2286 static const bool allowOUStringConcat =
true;
2292 template<
typename charT,
typename traits,
typename T1,
typename T2 >
2293 inline std::basic_ostream<charT, traits> &
operator <<(
2294 std::basic_ostream<charT, traits> & stream,
const OUStringConcat< T1, T2 >& concat)
2296 return stream << OUString( concat );
2320 {
return (
size_t)rString.hashCode(); }
2383 template<
typename charT,
typename traits >
2385 std::basic_ostream<charT, traits> & stream,
OUString const &
string)
2395 #ifdef RTL_STRING_UNITTEST
2398 typedef rtlunittest::OUString OUString;
2407 using ::rtl::OUString;
2408 using ::rtl::OUStringHash;