LibreOffice
LibreOffice 4.3 SDK C/C++ API Reference
ustrbuf.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 #ifndef INCLUDED_RTL_USTRBUF_HXX
21 #define INCLUDED_RTL_USTRBUF_HXX
22 
23 #include <sal/config.h>
24 
25 #include <cassert>
26 #include <string.h>
27 
28 #include <osl/diagnose.h>
29 #include <rtl/ustrbuf.h>
30 #include <rtl/ustring.hxx>
31 #include <rtl/stringutils.hxx>
32 #include <sal/types.h>
33 
34 #ifdef RTL_FAST_STRING
35 #include <rtl/stringconcat.hxx>
36 #endif
37 
38 // The unittest uses slightly different code to help check that the proper
39 // calls are made. The class is put into a different namespace to make
40 // sure the compiler generates a different (if generating also non-inline)
41 // copy of the function and does not merge them together. The class
42 // is "brought" into the proper rtl namespace by a typedef below.
43 #ifdef RTL_STRING_UNITTEST
44 #define rtl rtlunittest
45 #endif
46 
47 namespace rtl
48 {
49 
50 #ifdef RTL_STRING_UNITTEST
51 #undef rtl
52 #endif
53 
93 {
94 public:
100  : pData(NULL)
101  , nCapacity( 16 )
102  {
103  rtl_uString_new_WithLength( &pData, nCapacity );
104  }
105 
113  : pData(NULL)
114  , nCapacity( value.nCapacity )
115  {
116  rtl_uStringbuffer_newFromStringBuffer( &pData, value.nCapacity, value.pData );
117  }
118 
125  explicit OUStringBuffer(int length)
126  : pData(NULL)
127  , nCapacity( length )
128  {
129  rtl_uString_new_WithLength( &pData, length );
130  }
131 
142  OUStringBuffer(const OUString& value)
143  : pData(NULL)
144  , nCapacity( value.getLength() + 16 )
145  {
146  rtl_uStringbuffer_newFromStr_WithLength( &pData, value.getStr(), value.getLength() );
147  }
148 
149  template< typename T >
151  : pData(NULL)
152  , nCapacity( internal::ConstCharArrayDetector< T, void >::size - 1 + 16 )
153  {
154  assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
156 #ifdef RTL_STRING_UNITTEST
157  rtl_string_unittest_const_literal = true;
158 #endif
159  }
160 
161 #ifdef RTL_STRING_UNITTEST
162 
166  template< typename T >
168  {
169  pData = 0;
170  nCapacity = 10;
171  rtl_uString_newFromLiteral( &pData, "!!br0ken!!", 10, 0 ); // set to garbage
172  rtl_string_unittest_invalid_conversion = true;
173  }
178  template< typename T >
179  OUStringBuffer( const T&, typename internal::ExceptCharArrayDetector< T >::Type = internal::Dummy() )
180  {
181  pData = 0;
182  nCapacity = 10;
183  rtl_uString_newFromLiteral( &pData, "!!br0ken!!", 10, 0 ); // set to garbage
184  rtl_string_unittest_invalid_conversion = true;
185  }
186 #endif
187 
188 #ifdef RTL_FAST_STRING
189 
193  template< typename T1, typename T2 >
194  OUStringBuffer( const OUStringConcat< T1, T2 >& c )
195  {
196  const sal_Int32 l = c.length();
197  nCapacity = l + 16;
198  pData = rtl_uString_alloc( nCapacity );
199  sal_Unicode* end = c.addData( pData->buffer );
200  *end = '\0';
201  pData->length = end - pData->buffer;
202  // TODO realloc in case pData->>length is noticeably smaller than l ?
203  }
204 #endif
205 
207  OUStringBuffer& operator = ( const OUStringBuffer& value )
208  {
209  if (this != &value)
210  {
212  value.nCapacity,
213  value.pData);
214  nCapacity = value.nCapacity;
215  }
216  return *this;
217  }
218 
223  {
224  rtl_uString_release( pData );
225  }
226 
236  {
237  return OUString(
238  rtl_uStringBuffer_makeStringAndClear( &pData, &nCapacity ),
239  SAL_NO_ACQUIRE );
240  }
241 
247  sal_Int32 getLength() const
248  {
249  return pData->length;
250  }
251 
260  bool isEmpty() const SAL_THROW(())
261  {
262  return pData->length == 0;
263  }
264 
275  sal_Int32 getCapacity() const
276  {
277  return nCapacity;
278  }
279 
291  void ensureCapacity(sal_Int32 minimumCapacity)
292  {
293  rtl_uStringbuffer_ensureCapacity( &pData, &nCapacity, minimumCapacity );
294  }
295 
314  void setLength(sal_Int32 newLength)
315  {
316  assert(newLength >= 0);
317  // Avoid modifications if pData points to const empty string:
318  if( newLength != pData->length )
319  {
320  if( newLength > nCapacity )
321  rtl_uStringbuffer_ensureCapacity(&pData, &nCapacity, newLength);
322  else
323  pData->buffer[newLength] = 0;
324  pData->length = newLength;
325  }
326  }
327 
341  SAL_DEPRECATED("use rtl::OUStringBuffer::operator [] instead")
342  sal_Unicode charAt( sal_Int32 index ) const
343  {
344  assert(index >= 0 && index < pData->length);
345  return pData->buffer[ index ];
346  }
347 
358  SAL_DEPRECATED("use rtl::OUStringBuffer::operator [] instead")
359  OUStringBuffer & setCharAt(sal_Int32 index, sal_Unicode ch)
360  {
361  assert(index >= 0 && index < pData->length);
362  pData->buffer[ index ] = ch;
363  return *this;
364  }
365 
369  const sal_Unicode* getStr() const { return pData->buffer; }
370 
380  sal_Unicode & operator [](sal_Int32 index)
381  {
382  assert(index >= 0 && index < pData->length);
383  return pData->buffer[index];
384  }
385 
395  const sal_Unicode & operator [](sal_Int32 index) const
396  {
397  assert(index >= 0 && index < pData->length);
398  return pData->buffer[index];
399  }
400 
405  const OUString toString() const
406  {
407  return OUString(pData->buffer, pData->length);
408  }
409 
421  {
422  return append( str.getStr(), str.getLength() );
423  }
424 
438  {
439  if(!str.isEmpty())
440  {
441  append( str.getStr(), str.getLength() );
442  }
443  return *this;
444  }
445 
458  {
459  return append( str, rtl_ustr_getLength( str ) );
460  }
461 
475  OUStringBuffer & append( const sal_Unicode * str, sal_Int32 len)
476  {
477  // insert behind the last character
478  rtl_uStringbuffer_insert( &pData, &nCapacity, getLength(), str, len );
479  return *this;
480  }
481 
487  template< typename T >
489  {
490  assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
491  rtl_uStringbuffer_insert_ascii( &pData, &nCapacity, getLength(), literal,
493  return *this;
494  }
495 
496 #ifdef RTL_FAST_STRING
497 
501  template< typename T1, typename T2 >
502  OUStringBuffer& append( const OUStringConcat< T1, T2 >& c )
503  {
504  const int l = c.length();
505  if( l == 0 )
506  return *this;
507  rtl_uStringbuffer_ensureCapacity( &pData, &nCapacity, pData->length + l );
508  sal_Unicode* end = c.addData( pData->buffer + pData->length );
509  *end = '\0';
510  pData->length = end - pData->buffer;
511  return *this;
512  }
513 #endif
514 
532  {
533  return appendAscii( str, rtl_str_getLength( str ) );
534  }
535 
554  OUStringBuffer & appendAscii( const sal_Char * str, sal_Int32 len)
555  {
556  rtl_uStringbuffer_insert_ascii( &pData, &nCapacity, getLength(), str, len );
557  return *this;
558  }
559 
574  {
576  return append( sz, rtl_ustr_valueOfBoolean( sz, b ) );
577  }
578 
580  // Pointer can be automatically converted to bool, which is unwanted here.
581  // Explicitly delete all pointer append() overloads to prevent this
582  // (except for char* and sal_Unicode* overloads, which are handled elsewhere).
583  template< typename T >
584  typename internal::Enable< void,
586  append( T* ) SAL_DELETED_FUNCTION;
588 
589  // This overload is needed because OUString has a ctor from rtl_uString*, but
590  // the bool overload above would be preferred to the conversion.
594  OUStringBuffer & append(rtl_uString* str)
595  {
596  return append( OUString( str ));
597  }
598 
611  {
613  return append( sz, rtl_ustr_valueOfBoolean( sz, b ) );
614  }
615 
629  {
630  assert(static_cast< unsigned char >(c) <= 0x7F);
631  return append(sal_Unicode(c));
632  }
633 
645  {
646  return append( &c, 1 );
647  }
648 
661  OUStringBuffer & append(sal_Int32 i, sal_Int16 radix = 10 )
662  {
664  return append( sz, rtl_ustr_valueOfInt32( sz, i, radix ) );
665  }
666 
679  OUStringBuffer & append(sal_Int64 l, sal_Int16 radix = 10 )
680  {
682  return append( sz, rtl_ustr_valueOfInt64( sz, l, radix ) );
683  }
684 
697  {
699  return append( sz, rtl_ustr_valueOfFloat( sz, f ) );
700  }
701 
713  OUStringBuffer & append(double d)
714  {
716  return append( sz, rtl_ustr_valueOfDouble( sz, d ) );
717  }
718 
732  OUStringBuffer & appendUtf32(sal_uInt32 c) {
733  return insertUtf32(getLength(), c);
734  }
735 
751  OUStringBuffer & insert(sal_Int32 offset, const OUString & str)
752  {
753  return insert( offset, str.getStr(), str.getLength() );
754  }
755 
773  OUStringBuffer & insert( sal_Int32 offset, const sal_Unicode * str )
774  {
775  return insert( offset, str, rtl_ustr_getLength( str ) );
776  }
777 
796  OUStringBuffer & insert( sal_Int32 offset, const sal_Unicode * str, sal_Int32 len)
797  {
798  // insert behind the last character
799  rtl_uStringbuffer_insert( &pData, &nCapacity, offset, str, len );
800  return *this;
801  }
802 
808  template< typename T >
810  {
811  assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
812  rtl_uStringbuffer_insert_ascii( &pData, &nCapacity, offset, literal,
814  return *this;
815  }
816 
834  OUStringBuffer & insert(sal_Int32 offset, sal_Bool b)
835  {
837  return insert( offset, sz, rtl_ustr_valueOfBoolean( sz, b ) );
838  }
839 
859  OUStringBuffer & insert(sal_Int32 offset, bool b)
860  {
862  return insert( offset, sz, rtl_ustr_valueOfBoolean( sz, b ) );
863  }
864 
883  OUStringBuffer & insert(sal_Int32 offset, char c)
884  {
885  sal_Unicode u = c;
886  return insert( offset, &u, 1 );
887  }
888 
905  OUStringBuffer & insert(sal_Int32 offset, sal_Unicode c)
906  {
907  return insert( offset, &c, 1 );
908  }
909 
929  OUStringBuffer & insert(sal_Int32 offset, sal_Int32 i, sal_Int16 radix = 10 )
930  {
932  return insert( offset, sz, rtl_ustr_valueOfInt32( sz, i, radix ) );
933  }
934 
954  OUStringBuffer & insert(sal_Int32 offset, sal_Int64 l, sal_Int16 radix = 10 )
955  {
957  return insert( offset, sz, rtl_ustr_valueOfInt64( sz, l, radix ) );
958  }
959 
978  OUStringBuffer insert(sal_Int32 offset, float f)
979  {
981  return insert( offset, sz, rtl_ustr_valueOfFloat( sz, f ) );
982  }
983 
1002  OUStringBuffer & insert(sal_Int32 offset, double d)
1003  {
1005  return insert( offset, sz, rtl_ustr_valueOfDouble( sz, d ) );
1006  }
1007 
1023  OUStringBuffer & insertUtf32(sal_Int32 offset, sal_uInt32 c) {
1024  rtl_uStringbuffer_insertUtf32(&pData, &nCapacity, offset, c);
1025  return *this;
1026  }
1027 
1040  OUStringBuffer & remove( sal_Int32 start, sal_Int32 len )
1041  {
1042  rtl_uStringbuffer_remove( &pData, start, len );
1043  return *this;
1044  }
1045 
1056  OUStringBuffer & truncate( sal_Int32 start = 0 )
1057  {
1058  rtl_uStringbuffer_remove( &pData, start, getLength() - start );
1059  return *this;
1060  }
1061 
1073  {
1074  sal_Int32 index = 0;
1075  while((index = indexOf(oldChar, index)) >= 0)
1076  {
1077  pData->buffer[ index ] = newChar;
1078  }
1079  return *this;
1080  }
1081 
1097  inline void accessInternals(rtl_uString *** pInternalData,
1098  sal_Int32 ** pInternalCapacity)
1099  {
1100  *pInternalData = &pData;
1101  *pInternalCapacity = &nCapacity;
1102  }
1103 
1104 
1120  sal_Int32 indexOf( sal_Unicode ch, sal_Int32 fromIndex = 0 ) const SAL_THROW(())
1121  {
1122  sal_Int32 ret = rtl_ustr_indexOfChar_WithLength( pData->buffer+fromIndex, pData->length-fromIndex, ch );
1123  return (ret < 0 ? ret : ret+fromIndex);
1124  }
1125 
1137  sal_Int32 lastIndexOf( sal_Unicode ch ) const SAL_THROW(())
1138  {
1139  return rtl_ustr_lastIndexOfChar_WithLength( pData->buffer, pData->length, ch );
1140  }
1141 
1156  sal_Int32 lastIndexOf( sal_Unicode ch, sal_Int32 fromIndex ) const SAL_THROW(())
1157  {
1158  return rtl_ustr_lastIndexOfChar_WithLength( pData->buffer, fromIndex, ch );
1159  }
1160 
1178  sal_Int32 indexOf( const OUString & str, sal_Int32 fromIndex = 0 ) const SAL_THROW(())
1179  {
1180  sal_Int32 ret = rtl_ustr_indexOfStr_WithLength( pData->buffer+fromIndex, pData->length-fromIndex,
1181  str.pData->buffer, str.pData->length );
1182  return (ret < 0 ? ret : ret+fromIndex);
1183  }
1184 
1191  template< typename T >
1192  typename internal::ConstCharArrayDetector< T, sal_Int32 >::Type indexOf( T& literal, sal_Int32 fromIndex = 0 ) const SAL_THROW(())
1193  {
1194  assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1195  sal_Int32 ret = rtl_ustr_indexOfAscii_WithLength(
1196  pData->buffer + fromIndex, pData->length - fromIndex, literal,
1198  return ret < 0 ? ret : ret + fromIndex;
1199  }
1200 
1218  sal_Int32 lastIndexOf( const OUString & str ) const SAL_THROW(())
1219  {
1220  return rtl_ustr_lastIndexOfStr_WithLength( pData->buffer, pData->length,
1221  str.pData->buffer, str.pData->length );
1222  }
1223 
1243  sal_Int32 lastIndexOf( const OUString & str, sal_Int32 fromIndex ) const SAL_THROW(())
1244  {
1245  return rtl_ustr_lastIndexOfStr_WithLength( pData->buffer, fromIndex,
1246  str.pData->buffer, str.pData->length );
1247  }
1248 
1254  template< typename T >
1256  {
1257  assert( strlen( literal ) == internal::ConstCharArrayDetector< T >::size - 1 );
1259  pData->buffer, pData->length, literal, internal::ConstCharArrayDetector< T, void >::size - 1);
1260  }
1261 
1271  sal_Int32 stripStart(sal_Unicode c = (sal_Unicode)' ')
1272  {
1273  sal_Int32 index;
1274  for(index = 0; index < getLength() ; index++)
1275  {
1276  if(pData->buffer[ index ] != c)
1277  {
1278  break;
1279  }
1280  }
1281  if(index)
1282  {
1283  remove(0, index);
1284  }
1285  return index;
1286  }
1287 
1297  sal_Int32 stripEnd(sal_Unicode c = (sal_Unicode)' ')
1298  {
1299  sal_Int32 result = getLength();
1300  sal_Int32 index;
1301  for(index = getLength(); index > 0 ; index--)
1302  {
1303  if(pData->buffer[ index - 1 ] != c)
1304  {
1305  break;
1306  }
1307  }
1308  if(index < getLength())
1309  {
1310  truncate(index);
1311  }
1312  return result - getLength();
1313  }
1323  sal_Int32 strip(sal_Unicode c = (sal_Unicode)' ')
1324  {
1325  return stripStart(c) + stripEnd(c);
1326  }
1338  OUStringBuffer copy( sal_Int32 beginIndex ) const SAL_THROW(())
1339  {
1340  assert(beginIndex >= 0 && beginIndex <= getLength());
1341  return copy( beginIndex, getLength() - beginIndex );
1342  }
1343 
1357  OUStringBuffer copy( sal_Int32 beginIndex, sal_Int32 count ) const SAL_THROW(())
1358  {
1359  assert(beginIndex >= 0 && beginIndex <= getLength());
1360  assert(count >= 0 && count <= getLength() - beginIndex);
1361  rtl_uString *pNew = 0;
1362  rtl_uStringbuffer_newFromStr_WithLength( &pNew, getStr() + beginIndex, count );
1363  return OUStringBuffer( pNew, count + 16 );
1364  }
1365 
1366 #ifdef LIBO_INTERNAL_ONLY
1367  // This is to complement the RTL_FAST_STRING operator+, which allows any combination of valid operands,
1368  // even two buffers. It's intentional it returns OUString, just like the operator+ would in the fast variant.
1369 #ifndef RTL_FAST_STRING
1370 
1374  friend OUString operator+( const OUStringBuffer& str1, const OUStringBuffer& str2 ) SAL_THROW(())
1375  {
1376  return OUString( str1.pData ).concat( str2.pData );
1377  }
1378 #endif
1379 #endif
1380 
1381 private:
1382  OUStringBuffer( rtl_uString * value, const sal_Int32 capacity )
1383  {
1384  pData = value;
1385  nCapacity = capacity;
1386  }
1387 
1391  rtl_uString * pData;
1392 
1396  sal_Int32 nCapacity;
1397 };
1398 
1399 #ifdef RTL_FAST_STRING
1400 
1403 template<>
1404 struct ToStringHelper< OUStringBuffer >
1405  {
1406  static int length( const OUStringBuffer& s ) { return s.getLength(); }
1407  static sal_Unicode* addData( sal_Unicode* buffer, const OUStringBuffer& s ) { return addDataHelper( buffer, s.getStr(), s.getLength()); }
1408  static const bool allowOStringConcat = false;
1409  static const bool allowOUStringConcat = true;
1410  };
1411 #endif
1412 
1413 }
1414 
1415 #ifdef RTL_STRING_UNITTEST
1416 namespace rtl
1417 {
1418 typedef rtlunittest::OUStringBuffer OUStringBuffer;
1419 }
1420 #endif
1421 
1422 #ifdef RTL_USING
1423 using ::rtl::OUStringBuffer;
1424 #endif
1425 
1426 #endif // INCLUDED_RTL_USTRBUF_HXX
1427 
1428 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
SAL_DLLPUBLIC void rtl_uStringbuffer_insertUtf32(rtl_uString **pThis, sal_Int32 *capacity, sal_Int32 offset, sal_uInt32 c) SAL_THROW_EXTERN_C()
Inserts a single UTF-32 character into this string buffer.
SAL_DLLPUBLIC void rtl_uString_release(rtl_uString *str) SAL_THROW_EXTERN_C()
Decrement the reference count of a string.
internal::ConstCharArrayDetector< T, sal_Int32 >::Type lastIndexOf(T &literal) const SAL_THROW(())
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustrbuf.hxx:1255
OUStringBuffer & replace(sal_Unicode oldChar, sal_Unicode newChar)
Replace all occurrences of oldChar in this string buffer with newChar.
Definition: ustrbuf.hxx:1072
SAL_DLLPUBLIC void rtl_uStringbuffer_newFromStr_WithLength(rtl_uString **newStr, const sal_Unicode *value, sal_Int32 count)
Allocates a new String that contains characters from the character array argument.
#define SAL_DEPRECATED(message)
Use as follows: SAL_DEPRECATED("Dont use, its evil.") void doit(int nPara);.
Definition: types.h:491
const OUString toString() const
Return a OUString instance reflecting the current content of this OUStringBuffer. ...
Definition: ustrbuf.hxx:405
OUStringBuffer & insert(sal_Int32 offset, const sal_Unicode *str)
Inserts the string representation of the char array argument into this string buffer.
Definition: ustrbuf.hxx:773
OUStringBuffer copy(sal_Int32 beginIndex) const SAL_THROW(())
Returns a new string buffer that is a substring of this string.
Definition: ustrbuf.hxx:1338
OUStringBuffer & insert(sal_Int32 offset, double d)
Inserts the string representation of the double argument into this string buffer. ...
Definition: ustrbuf.hxx:1002
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_Int32 lastIndexOf(sal_Unicode ch, sal_Int32 fromIndex) const SAL_THROW(())
Returns the index within this string of the last occurrence of the specified character, searching backward starting before the specified index.
Definition: ustrbuf.hxx:1156
OUStringBuffer & insert(sal_Int32 offset, bool b)
Inserts the string representation of the bool argument into this string buffer.
Definition: ustrbuf.hxx:859
unsigned char sal_Bool
Definition: types.h:46
OUStringBuffer(const OUString &value)
Constructs a string buffer so that it represents the same sequence of characters as the string argume...
Definition: ustrbuf.hxx:142
sal_Int32 strip(sal_Unicode c=(sal_Unicode)' ')
Strip the given character from the both end of the buffer.
Definition: ustrbuf.hxx:1323
SAL_DLLPUBLIC sal_Int32 rtl_ustr_valueOfBoolean(sal_Unicode *str, sal_Bool b) SAL_THROW_EXTERN_C()
Create the string representation of a boolean.
OUStringBuffer & insert(sal_Int32 offset, const sal_Unicode *str, sal_Int32 len)
Inserts the string representation of the char array argument into this string buffer.
Definition: ustrbuf.hxx:796
Definition: bootstrap.hxx:24
Definition: stringutils.hxx:67
sal_Int32 indexOf(const OUString &str, sal_Int32 fromIndex=0) const SAL_THROW(())
Returns the index within this string of the first occurrence of the specified substring, starting at the specified index.
Definition: ustrbuf.hxx:1178
internal::ConstCharArrayDetector< T, OUStringBuffer & >::Type insert(sal_Int32 offset, T &literal)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustrbuf.hxx:809
#define RTL_USTR_MAX_VALUEOFINT64
Definition: ustring.h:1003
definition of a no acquire enum for ctors
Definition: types.h:388
OUStringBuffer(T &literal, typename internal::ConstCharArrayDetector< T, internal::Dummy >::Type=internal::Dummy())
Definition: ustrbuf.hxx:150
#define RTL_USTR_MAX_VALUEOFINT32
Definition: ustring.h:957
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.
bool isEmpty() const SAL_THROW(())
Checks if a string buffer is empty.
Definition: ustrbuf.hxx:260
OUStringBuffer insert(sal_Int32 offset, float f)
Inserts the string representation of the float argument into this string buffer.
Definition: ustrbuf.hxx:978
OUStringBuffer & appendUtf32(sal_uInt32 c)
Appends a single UTF-32 character to this string buffer.
Definition: ustrbuf.hxx:732
const sal_Unicode * getStr() const SAL_THROW(())
Returns a pointer to the Unicode character buffer for this string.
Definition: ustring.hxx:408
OUStringBuffer & truncate(sal_Int32 start=0)
Removes the tail of a string buffer start at the indicate position.
Definition: ustrbuf.hxx:1056
~OUStringBuffer()
Release the string data.
Definition: ustrbuf.hxx:222
void setLength(sal_Int32 newLength)
Sets the length of this String buffer.
Definition: ustrbuf.hxx:314
sal_Int32 lastIndexOf(const OUString &str, sal_Int32 fromIndex) const SAL_THROW(())
Returns the index within this string of the last occurrence of the specified substring, searching backward starting before the specified index.
Definition: ustrbuf.hxx:1243
OUStringBuffer & insertUtf32(sal_Int32 offset, sal_uInt32 c)
Inserts a single UTF-32 character into this string buffer.
Definition: ustrbuf.hxx:1023
OUString makeStringAndClear()
Fill the string data in the new string and clear the buffer.
Definition: ustrbuf.hxx:235
OUStringBuffer & append(const OUString &str)
Appends the string to this string buffer.
Definition: ustrbuf.hxx:420
sal_Int32 indexOf(sal_Unicode ch, sal_Int32 fromIndex=0) const SAL_THROW(())
Returns the index within this string of the first occurrence of the specified character, starting the search at the specified index.
Definition: ustrbuf.hxx:1120
SAL_DLLPUBLIC sal_Int32 rtl_ustr_getLength(const sal_Unicode *str) SAL_THROW_EXTERN_C()
Return the length of a string.
OUStringBuffer & append(const sal_Unicode *str, sal_Int32 len)
Appends the string representation of the char array argument to this string buffer.
Definition: ustrbuf.hxx:475
OUStringBuffer & append(sal_Int64 l, sal_Int16 radix=10)
Appends the string representation of the long argument to this string buffer.
Definition: ustrbuf.hxx:679
SAL_DLLPUBLIC void rtl_uStringbuffer_insert(rtl_uString **This, sal_Int32 *capacity, sal_Int32 offset, const sal_Unicode *str, sal_Int32 len)
Inserts the string representation of the str array argument into this string buffer.
sal_Int32 getCapacity() const
Returns the current capacity of the String buffer.
Definition: ustrbuf.hxx:275
SAL_DLLPUBLIC void rtl_uStringbuffer_insert_ascii(rtl_uString **This, sal_Int32 *capacity, sal_Int32 offset, const sal_Char *str, sal_Int32 len)
Inserts the 8-Bit ASCII string representation of the str array argument into this string buffer...
char sal_Char
A legacy synonym for char.
Definition: types.h:128
SAL_DLLPUBLIC sal_Int32 rtl_uStringbuffer_newFromStringBuffer(rtl_uString **newStr, sal_Int32 capacity, rtl_uString *oldStr)
Allocates a new String that contains the same sequence of characters as the string argument...
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.
OUStringBuffer & insert(sal_Int32 offset, sal_Int64 l, sal_Int16 radix=10)
Inserts the string representation of the long argument into this string buffer.
Definition: ustrbuf.hxx:954
OUStringBuffer & append(bool b)
Appends the string representation of the bool argument to the string buffer.
Definition: ustrbuf.hxx:573
OUStringBuffer(int length)
Constructs a string buffer with no characters in it and an initial capacity specified by the length a...
Definition: ustrbuf.hxx:125
OUStringBuffer & append(const sal_Unicode *str)
Appends the string representation of the char array argument to this string buffer.
Definition: ustrbuf.hxx:457
internal::ConstCharArrayDetector< T, OUStringBuffer & >::Type append(T &literal)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustrbuf.hxx:488
OUStringBuffer copy(sal_Int32 beginIndex, sal_Int32 count) const SAL_THROW(())
Returns a new string buffer that is a substring of this string.
Definition: ustrbuf.hxx:1357
sal_Int32 getLength() const
Returns the length (character count) of this string buffer.
Definition: ustrbuf.hxx:247
Definition: stringutils.hxx:170
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.
OUStringBuffer & append(sal_Unicode c)
Appends the string representation of the char argument to this string buffer.
Definition: ustrbuf.hxx:644
SAL_WARN_UNUSED_RESULT OUString concat(const OUString &str) const SAL_THROW(())
Concatenates the specified string to the end of this string.
Definition: ustring.hxx:1495
OUStringBuffer & append(sal_Bool b)
Appends the string representation of the sal_Bool argument to the string buffer.
Definition: ustrbuf.hxx:610
Definition: stringutils.hxx:151
Definition: stringutils.hxx:110
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.
#define SAL_THROW(x)
Exception specification documentation.
Definition: types.h:361
SAL_DLLPUBLIC void rtl_uString_new_WithLength(rtl_uString **newStr, sal_Int32 nLen) SAL_THROW_EXTERN_C()
Allocate a new string containing space for a given number of characters.
OUStringBuffer & append(sal_Int32 i, sal_Int16 radix=10)
Appends the string representation of the sal_Int32 argument to this string buffer.
Definition: ustrbuf.hxx:661
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.
OUStringBuffer()
Constructs a string buffer with no characters in it and an initial capacity of 16 characters...
Definition: ustrbuf.hxx:99
A string buffer implements a mutable sequence of characters.
Definition: ustrbuf.hxx:92
OUStringBuffer & append(const OUStringBuffer &str)
Appends the content of a stringbuffer to this string buffer.
Definition: ustrbuf.hxx:437
sal_Int32 lastIndexOf(const OUString &str) const SAL_THROW(())
Returns the index within this string of the last occurrence of the specified substring, searching backward starting at the end.
Definition: ustrbuf.hxx:1218
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.
OUStringBuffer & append(float f)
Appends the string representation of the float argument to this string buffer.
Definition: ustrbuf.hxx:696
Definition: stringutils.hxx:69
void ensureCapacity(sal_Int32 minimumCapacity)
Ensures that the capacity of the buffer is at least equal to the specified minimum.
Definition: ustrbuf.hxx:291
SAL_DLLPUBLIC sal_Int32 rtl_str_getLength(const sal_Char *str) SAL_THROW_EXTERN_C()
Return the length of a string.
const sal_Unicode * getStr() const
Return a null terminated unicode character array.
Definition: ustrbuf.hxx:369
#define RTL_USTR_MAX_VALUEOFDOUBLE
Definition: ustring.h:1041
#define RTL_USTR_MAX_VALUEOFFLOAT
Definition: ustring.h:1022
#define SAL_DELETED_FUNCTION
short-circuit extra-verbose API namespaces
Definition: types.h:410
sal_Int32 getLength() const SAL_THROW(())
Returns the length of this string.
Definition: ustring.hxx:386
#define RTL_USTR_MAX_VALUEOFBOOLEAN
Definition: ustring.h:915
#define SAL_WARN_UNUSED
Annotate classes where a compiler should warn if an instance is unused.
Definition: types.h:603
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.
OUStringBuffer & insert(sal_Int32 offset, sal_Int32 i, sal_Int16 radix=10)
Inserts the string representation of the second sal_Int32 argument into this string buffer...
Definition: ustrbuf.hxx:929
SAL_DLLPUBLIC sal_Int32 rtl_ustr_valueOfDouble(sal_Unicode *str, double d) SAL_THROW_EXTERN_C()
Create the string representation of a double.
sal_Int32 stripStart(sal_Unicode c=(sal_Unicode)' ')
Strip the given character from the start of the buffer.
Definition: ustrbuf.hxx:1271
This String class provides base functionality for C++ like Unicode character array handling...
Definition: ustring.hxx:82
OUStringBuffer & insert(sal_Int32 offset, sal_Bool b)
Inserts the string representation of the sal_Bool argument into this string buffer.
Definition: ustrbuf.hxx:834
SAL_DLLPUBLIC void rtl_uString_newFromLiteral(rtl_uString **newStr, const sal_Char *value, sal_Int32 len, sal_Int32 allocExtra) SAL_THROW_EXTERN_C()
sal_uInt16 sal_Unicode
Definition: types.h:150
sal_Int32 stripEnd(sal_Unicode c=(sal_Unicode)' ')
Strip the given character from the end of the buffer.
Definition: ustrbuf.hxx:1297
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_Int32 lastIndexOf(sal_Unicode ch) const SAL_THROW(())
Returns the index within this string of the last occurrence of the specified character, searching backward starting at the end.
Definition: ustrbuf.hxx:1137
SAL_DLLPUBLIC rtl_uString * rtl_uStringBuffer_makeStringAndClear(rtl_uString **ppThis, sal_Int32 *nCapacity)
Returns an immutable rtl_uString object, while clearing the string buffer.
OUStringBuffer(const OUStringBuffer &value)
Allocates a new string buffer that contains the same sequence of characters as the string buffer argu...
Definition: ustrbuf.hxx:112
OUStringBuffer & append(char c)
Appends the string representation of the ASCII char argument to this string buffer.
Definition: ustrbuf.hxx:628
OUStringBuffer & append(double d)
Appends the string representation of the double argument to this string buffer.
Definition: ustrbuf.hxx:713
OUStringBuffer & appendAscii(const sal_Char *str, sal_Int32 len)
Appends a 8-Bit ASCII character string to this string buffer.
Definition: ustrbuf.hxx:554
SAL_DLLPUBLIC void rtl_uStringbuffer_remove(rtl_uString **This, sal_Int32 start, sal_Int32 len)
Removes the characters in a substring of this sequence.
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_uStringbuffer_ensureCapacity(rtl_uString **This, sal_Int32 *capacity, sal_Int32 minimumCapacity)
Ensures that the capacity of the buffer is at least equal to the specified minimum.
internal::ConstCharArrayDetector< T, sal_Int32 >::Type indexOf(T &literal, sal_Int32 fromIndex=0) const SAL_THROW(())
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition: ustrbuf.hxx:1192
OUStringBuffer & insert(sal_Int32 offset, const OUString &str)
Inserts the string into this string buffer.
Definition: ustrbuf.hxx:751
OUStringBuffer & insert(sal_Int32 offset, sal_Unicode c)
Inserts the string representation of the char argument into this string buffer.
Definition: ustrbuf.hxx:905
OUStringBuffer & insert(sal_Int32 offset, char c)
Inserts the string representation of the char argument into this string buffer.
Definition: ustrbuf.hxx:883
OUStringBuffer & appendAscii(const sal_Char *str)
Appends a 8-Bit ASCII character string to this string buffer.
Definition: ustrbuf.hxx:531
void accessInternals(rtl_uString ***pInternalData, sal_Int32 **pInternalCapacity)
Allows access to the internal data of this OUStringBuffer, for effective manipulation.
Definition: ustrbuf.hxx:1097