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 >
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];
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;