LibreOffice: rtl/strbuf.hxx Source File

LibreOffice LibreOffice 7.6 SDK C/C++ API Reference

Loading...
Searching...
No Matches
strbuf.hxx
Go to the documentation of this file.
1/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2/*
3 * This file is part of the LibreOffice project.
4 *
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8 *
9 * This file incorporates work covered by the following license notice:
10 *
11 * Licensed to the Apache Software Foundation (ASF) under one or more
12 * contributor license agreements. See the NOTICE file distributed
13 * with this work for additional information regarding copyright
14 * ownership. The ASF licenses this file to you under the Apache
15 * License, Version 2.0 (the "License"); you may not use this file
16 * except in compliance with the License. You may obtain a copy of
17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18 */
19
20/*
21 * This file is part of LibreOffice published API.
22 */
23
24#pragma once
25
26#include "sal/config.h"
27
28#include <cassert>
29#include <cstring>
30#include <limits>
31
32#include "rtl/strbuf.h"
33#include "rtl/string.hxx"
34#include "rtl/stringutils.hxx"
35
36#ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
37#include "rtl/stringconcat.hxx"
38#include <string_view>
39#include <type_traits>
40#endif
41
42#ifdef RTL_STRING_UNITTEST
43extern bool rtl_string_unittest_const_literal;
44extern bool rtl_string_unittest_const_literal_function;
45#endif
46
47// The unittest uses slightly different code to help check that the proper
48// calls are made. The class is put into a different namespace to make
49// sure the compiler generates a different (if generating also non-inline)
50// copy of the function and does not merge them together. The class
51// is "brought" into the proper rtl namespace by a typedef below.
52#ifdef RTL_STRING_UNITTEST
53#define rtl rtlunittest
54#endif
55
56namespace rtl
57{
58
60#ifdef RTL_STRING_UNITTEST
61#undef rtl
62// helper macro to make functions appear more readable
63#define RTL_STRING_CONST_FUNCTION rtl_string_unittest_const_literal_function = true;
64#else
65#define RTL_STRING_CONST_FUNCTION
66#endif
68
71 class SAL_WARN_UNUSED OStringBuffer
72{
73public:
78 OStringBuffer()
79 : pData(NULL)
80 , nCapacity( 16 )
81 {
82 rtl_string_new_WithLength( &pData, nCapacity );
83 }
84
91 OStringBuffer( const OStringBuffer & value )
92 : pData(NULL)
93 , nCapacity( value.nCapacity )
94 {
95 rtl_stringbuffer_newFromStringBuffer( &pData, value.nCapacity, value.pData );
96 }
97
104 explicit OStringBuffer(sal_Int32 length)
105 : pData(NULL)
106 , nCapacity( length )
107 {
108 rtl_string_new_WithLength( &pData, length );
109 }
110#if defined LIBO_INTERNAL_ONLY
111 template<typename T>
112 explicit OStringBuffer(T length, std::enable_if_t<std::is_integral_v<T>, int> = 0)
113 : OStringBuffer(static_cast<sal_Int32>(length))
114 {
115 assert(
116 length >= 0
117 && static_cast<std::make_unsigned_t<T>>(length)
118 <= static_cast<std::make_unsigned_t<sal_Int32>>(
119 std::numeric_limits<sal_Int32>::max()));
120 }
121 // avoid (obvious) bugs
122 explicit OStringBuffer(bool) = delete;
123 explicit OStringBuffer(char) = delete;
124 explicit OStringBuffer(wchar_t) = delete;
125#if defined __cpp_char8_t
126 explicit OStringBuffer(char8_t) = delete;
127#endif
128 explicit OStringBuffer(char16_t) = delete;
129 explicit OStringBuffer(char32_t) = delete;
130#endif
131
142#if defined LIBO_INTERNAL_ONLY
143 OStringBuffer(std::string_view sv)
144 : pData(nullptr)
145 , nCapacity( sv.length() + 16 )
146 {
147 if (sv.size() > sal_uInt32(std::numeric_limits<sal_Int32>::max())) {
148 throw std::bad_alloc();
149 }
150 rtl_stringbuffer_newFromStr_WithLength( &pData, sv.data(), sv.length() );
151 }
152#else
153 OStringBuffer(const OString& value)
154 : pData(NULL)
155 , nCapacity( value.getLength() + 16 )
156 {
157 rtl_stringbuffer_newFromStr_WithLength( &pData, value.getStr(), value.getLength() );
158 }
159#endif
160
165 template< typename T >
166 OStringBuffer( const T& value, typename libreoffice_internal::CharPtrDetector< T, libreoffice_internal::Dummy >::Type = libreoffice_internal::Dummy())
167 : pData(NULL)
168 {
169 sal_Int32 length = rtl_str_getLength( value );
170 nCapacity = length + 16;
171 rtl_stringbuffer_newFromStr_WithLength( &pData, value, length );
172 }
173
174 template< typename T >
175 OStringBuffer( T& value, typename libreoffice_internal::NonConstCharArrayDetector< T, libreoffice_internal::Dummy >::Type = libreoffice_internal::Dummy())
176 : pData(NULL)
177 {
178 sal_Int32 length = rtl_str_getLength( value );
179 nCapacity = length + 16;
180 rtl_stringbuffer_newFromStr_WithLength( &pData, value, length );
181 }
182
183#if __cplusplus > 202002L // C++23 P2266R3 "Simpler implicit move"
184 template< typename T >
185 OStringBuffer( T&& value, typename libreoffice_internal::NonConstCharArrayDetector< T, libreoffice_internal::Dummy >::Type = libreoffice_internal::Dummy())
186 : pData(NULL)
187 {
188 sal_Int32 length = rtl_str_getLength( value );
189 nCapacity = length + 16;
190 rtl_stringbuffer_newFromStr_WithLength( &pData, value, length );
191 }
192#endif
193
205 template< typename T >
206 OStringBuffer( T& literal, typename libreoffice_internal::ConstCharArrayDetector< T, libreoffice_internal::Dummy >::Type = libreoffice_internal::Dummy())
207 : pData(NULL)
208 , nCapacity( libreoffice_internal::ConstCharArrayDetector<T>::length + 16 )
209 {
210 assert(
211 libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
212 rtl_string_newFromLiteral(
213 &pData,
214 libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
215 libreoffice_internal::ConstCharArrayDetector<T>::length, 16);
216#ifdef RTL_STRING_UNITTEST
217 rtl_string_unittest_const_literal = true;
218#endif
219 }
220
233 OStringBuffer(const char * value, sal_Int32 length)
234 : pData(NULL)
235 , nCapacity( length + 16 )
236 {
237 rtl_stringbuffer_newFromStr_WithLength( &pData, value, length );
238 }
239
240#ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
245 template< typename T1, typename T2 >
246 OStringBuffer( OStringConcat< T1, T2 >&& c )
247 {
248 const sal_Int32 l = c.length();
249 nCapacity = l + 16;
250 pData = rtl_string_alloc( nCapacity );
251 char* end = c.addData( pData->buffer );
252 *end = '\0';
253 pData->length = l;
254 }
255
260 template< std::size_t N >
261 OStringBuffer( OStringNumber< N >&& n )
262 : OStringBuffer( n.buf, n.length)
263 {}
264#endif
265
266#if defined LIBO_INTERNAL_ONLY
267 operator std::string_view() const { return {getStr(), sal_uInt32(getLength())}; }
268#endif
269
272 OStringBuffer& operator = ( const OStringBuffer& value )
273 {
274 if (this != &value)
275 {
276 rtl_stringbuffer_newFromStringBuffer(&pData,
277 value.nCapacity,
278 value.pData);
279 nCapacity = value.nCapacity;
280 }
281 return *this;
282 }
283
288#if defined LIBO_INTERNAL_ONLY
289 OStringBuffer & operator =(std::string_view string) {
290 sal_Int32 n = string.length();
291 if (n >= nCapacity) {
292 ensureCapacity(n + 16); //TODO: check for overflow
293 }
294 std::memcpy(pData->buffer, string.data(), n);
295 pData->buffer[n] = '\0';
296 pData->length = n;
297 return *this;
298 }
299#else
300 OStringBuffer & operator =(OString const & string) {
301 sal_Int32 n = string.getLength();
302 if (n >= nCapacity) {
303 ensureCapacity(n + 16); //TODO: check for overflow
304 }
305 std::memcpy(pData->buffer, string.pData->buffer, n + 1);
306 pData->length = n;
307 return *this;
308 }
309#endif
310
315 template<typename T>
316 typename
317 libreoffice_internal::ConstCharArrayDetector<T, OStringBuffer &>::Type
318 operator =(T & literal) {
319 assert(
320 libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
321 sal_Int32 const n
322 = libreoffice_internal::ConstCharArrayDetector<T>::length;
323 if (n >= nCapacity) {
324 ensureCapacity(n + 16); //TODO: check for overflow
325 }
326 std::memcpy(
327 pData->buffer,
328 libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
329 n + 1);
330 pData->length = n;
331 return *this;
332 }
333
334#if defined LIBO_INTERNAL_ONLY
336 template<typename T1, typename T2>
337 OStringBuffer & operator =(OStringConcat<T1, T2> && concat) {
338 sal_Int32 const n = concat.length();
339 if (n >= nCapacity) {
340 ensureCapacity(n + 16); //TODO: check for overflow
341 }
342 *concat.addData(pData->buffer) = 0;
343 pData->length = n;
344 return *this;
345 }
346
348 template<std::size_t N>
349 OStringBuffer & operator =(OStringNumber<N> && n)
350 {
351 return operator =(std::string_view(n));
352 }
353#endif
354
358 ~OStringBuffer()
359 {
360 rtl_string_release( pData );
361 }
362
371 SAL_WARN_UNUSED_RESULT OString makeStringAndClear()
372 {
373 OString aRet( pData );
374 rtl_string_new(&pData);
375 nCapacity = 0;
376 return aRet;
377 }
378
384 sal_Int32 getLength() const
385 {
386 return pData->length;
387 }
388
397 bool isEmpty() const
398 {
399 return pData->length == 0;
400 }
401
412 sal_Int32 getCapacity() const
413 {
414 return nCapacity;
415 }
416
428 void ensureCapacity(sal_Int32 minimumCapacity)
429 {
430 rtl_stringbuffer_ensureCapacity( &pData, &nCapacity, minimumCapacity );
431 }
432
451 void setLength(sal_Int32 newLength)
452 {
453 assert(newLength >= 0);
454 // Avoid modifications if pData points to const empty string:
455 if( newLength != pData->length )
456 {
457 if( newLength > nCapacity )
458 rtl_stringbuffer_ensureCapacity(&pData, &nCapacity, newLength);
459 else
460 pData->buffer[newLength] = '\0';
461 pData->length = newLength;
462 }
463 }
464
478 SAL_DEPRECATED("use rtl::OStringBuffer::operator [] instead")
479 char charAt( sal_Int32 index )
480 {
481 assert(index >= 0 && index < pData->length);
482 return pData->buffer[ index ];
483 }
484
495 SAL_DEPRECATED("use rtl::OStringBuffer::operator [] instead")
496 OStringBuffer & setCharAt(sal_Int32 index, char ch)
497 {
498 assert(index >= 0 && index < pData->length);
499 pData->buffer[ index ] = ch;
500 return *this;
501 }
502
506 const char* getStr() const SAL_RETURNS_NONNULL { return pData->buffer; }
507
517 char & operator [](sal_Int32 index)
518 {
519 assert(index >= 0 && index < pData->length);
520 return pData->buffer[index];
521 }
522
527 OString toString() const
528 {
529 return OString(pData->buffer, pData->length);
530 }
531
532#if !defined LIBO_INTERNAL_ONLY
543 OStringBuffer & append(const OString &str)
544 {
545 return insert(getLength(), str);
546 }
547#endif
548
560 template< typename T >
561 typename libreoffice_internal::CharPtrDetector< T, OStringBuffer& >::Type append( const T& str )
562 {
563 return insert(getLength(), str);
564 }
565
566 template< typename T >
567 typename libreoffice_internal::NonConstCharArrayDetector< T, OStringBuffer& >::Type append( T& str )
568 {
569 return insert(getLength(), str);
570 }
571
577 template< typename T >
578 typename libreoffice_internal::ConstCharArrayDetector< T, OStringBuffer& >::Type append( T& literal )
579 {
580 return insert(getLength(), literal);
581 }
582
596 OStringBuffer & append( const char * str, sal_Int32 len)
597 {
598 return insert(getLength(), str, len);
599 }
600
601#ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
606 template< typename T1, typename T2 >
607 OStringBuffer& append( OStringConcat< T1, T2 >&& c )
608 {
609 sal_Int32 l = c.length();
610 if (l != 0)
611 c.addData(appendUninitialized(l));
612 return *this;
613 }
614
619 OStringBuffer& append( std::string_view s )
620 {
621 return insert(getLength(), s);
622 }
623
624#endif
625
637 OStringBuffer & append(sal_Bool b)
638 {
639 return insert(getLength(), b);
640 }
641
655 OStringBuffer & append(bool b)
656 {
657 return insert(getLength(), b);
658 }
659
661 // Pointer can be automatically converted to bool, which is unwanted here.
662 // Explicitly delete all pointer append() overloads to prevent this
663 // (except for char* overload, which is handled elsewhere).
664 template< typename T >
665 typename libreoffice_internal::Enable< void,
666 !libreoffice_internal::CharPtrDetector< T* >::ok >::Type
667 append( T* ) SAL_DELETED_FUNCTION;
669
680 OStringBuffer & append(char c)
681 {
682 return insert(getLength(), c);
683 }
684
697 OStringBuffer & append(sal_Int32 i, sal_Int16 radix = 10 )
698 {
699 return insert(getLength(), i, radix);
700 }
701
714 OStringBuffer & append(sal_Int64 l, sal_Int16 radix = 10 )
715 {
716 return insert(getLength(), l, radix);
717 }
718
730 OStringBuffer & append(float f)
731 {
732 return insert(getLength(), f);
733 }
734
746 OStringBuffer & append(double d)
747 {
748 return insert(getLength(), d);
749 }
750
766 char * appendUninitialized(sal_Int32 length) SAL_RETURNS_NONNULL {
767 sal_Int32 n = getLength();
768 rtl_stringbuffer_insert(&pData, &nCapacity, n, NULL, length);
769 return pData->buffer + n;
770 }
771
787#if defined LIBO_INTERNAL_ONLY
788 OStringBuffer & insert(sal_Int32 offset, std::string_view str)
789 {
790 return insert( offset, str.data(), str.length() );
791 }
792#else
793 OStringBuffer & insert(sal_Int32 offset, const OString & str)
794 {
795 return insert( offset, str.getStr(), str.getLength() );
796 }
797#endif
798
816 template< typename T >
817 typename libreoffice_internal::CharPtrDetector< T, OStringBuffer& >::Type insert( sal_Int32 offset, const T& str )
818 {
819 return insert( offset, str, rtl_str_getLength( str ) );
820 }
821
822 template< typename T >
823 typename libreoffice_internal::NonConstCharArrayDetector< T, OStringBuffer& >::Type insert( sal_Int32 offset, T& str )
824 {
825 return insert( offset, str, rtl_str_getLength( str ) );
826 }
827
833 template< typename T >
834 typename libreoffice_internal::ConstCharArrayDetector< T, OStringBuffer& >::Type insert( sal_Int32 offset, T& literal )
835 {
836 RTL_STRING_CONST_FUNCTION
837 assert(
838 libreoffice_internal::ConstCharArrayDetector<T>::isValid(literal));
839 return insert(
840 offset,
841 libreoffice_internal::ConstCharArrayDetector<T>::toPointer(literal),
842 libreoffice_internal::ConstCharArrayDetector<T>::length);
843 }
844
863 OStringBuffer & insert( sal_Int32 offset, const char * str, sal_Int32 len)
864 {
865 assert( len == 0 || str != NULL ); // cannot assert that in rtl_stringbuffer_insert
866 rtl_stringbuffer_insert( &pData, &nCapacity, offset, str, len );
867 return *this;
868 }
869
887 OStringBuffer & insert(sal_Int32 offset, sal_Bool b)
888 {
889 char sz[RTL_STR_MAX_VALUEOFBOOLEAN];
890 return insert( offset, sz, rtl_str_valueOfBoolean( sz, b ) );
891 }
892
912 OStringBuffer & insert(sal_Int32 offset, bool b)
913 {
914 char sz[RTL_STR_MAX_VALUEOFBOOLEAN];
915 return insert( offset, sz, rtl_str_valueOfBoolean( sz, b ) );
916 }
917
934 OStringBuffer & insert(sal_Int32 offset, char c)
935 {
936 return insert( offset, &c, 1 );
937 }
938
957 OStringBuffer & insert(sal_Int32 offset, sal_Int32 i, sal_Int16 radix = 10 )
958 {
959 char sz[RTL_STR_MAX_VALUEOFINT32];
960 return insert( offset, sz, rtl_str_valueOfInt32( sz, i, radix ) );
961 }
962
981 OStringBuffer & insert(sal_Int32 offset, sal_Int64 l, sal_Int16 radix = 10 )
982 {
983 char sz[RTL_STR_MAX_VALUEOFINT64];
984 return insert( offset, sz, rtl_str_valueOfInt64( sz, l, radix ) );
985 }
986
1004 OStringBuffer & insert(sal_Int32 offset, float f)
1005 {
1006 // Same as rtl::str::valueOfFP, used for rtl_str_valueOfFloat
1007 rtl_math_doubleToString(&pData, &nCapacity, offset, f, rtl_math_StringFormat_G,
1008 RTL_STR_MAX_VALUEOFFLOAT - SAL_N_ELEMENTS("-x.E-xxx") + 1, '.',
1009 NULL, 0, true);
1010 return *this;
1011 }
1012
1030 OStringBuffer & insert(sal_Int32 offset, double d)
1031 {
1032 // Same as rtl::str::valueOfFP, used for rtl_str_valueOfDouble
1033 rtl_math_doubleToString(&pData, &nCapacity, offset, d, rtl_math_StringFormat_G,
1034 RTL_STR_MAX_VALUEOFDOUBLE - SAL_N_ELEMENTS("-x.E-xxx") + 1, '.',
1035 NULL, 0, true);
1036 return *this;
1037 }
1038
1051 OStringBuffer & remove( sal_Int32 start, sal_Int32 len )
1052 {
1053 rtl_stringbuffer_remove( &pData, start, len );
1054 return *this;
1055 }
1056
1074 void accessInternals(
1075 rtl_String *** pInternalData, sal_Int32 ** pInternalCapacity)
1076 {
1077 *pInternalData = &pData;
1078 *pInternalCapacity = &nCapacity;
1079 }
1080
1081private:
1085 rtl_String * pData;
1086
1090 sal_Int32 nCapacity;
1091};
1092
1093#if defined LIBO_INTERNAL_ONLY
1094template<> struct ToStringHelper<OStringBuffer> {
1095 static std::size_t length(OStringBuffer const & s) { return s.getLength(); }
1096
1097 char * operator()(char * buffer, OStringBuffer const & s) const SAL_RETURNS_NONNULL
1098 { return addDataHelper(buffer, s.getStr(), s.getLength()); }
1099};
1100#endif
1101
1102}
1103
1104#ifdef RTL_STRING_UNITTEST
1105namespace rtl
1106{
1107typedef rtlunittest::OStringBuffer OStringBuffer;
1108}
1109#undef RTL_STRING_CONST_FUNCTION
1110#endif
1111
1112#if defined LIBO_INTERNAL_ONLY && !defined RTL_STRING_UNITTEST
1113using ::rtl::OStringBuffer;
1114#endif
1115
1116/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
SAL_N_ELEMENTS
#define SAL_N_ELEMENTS(arr)
Definition macros.h:51
config.h
SAL_DEPRECATED
#define SAL_DEPRECATED(message)
Use as follows: SAL_DEPRECATED("Don't use, it's evil.") void doit(int nPara);.
Definition types.h:474
SAL_DELETED_FUNCTION
#define SAL_DELETED_FUNCTION
short-circuit extra-verbose API namespaces
Definition types.h:378
sal_Bool
unsigned char sal_Bool
Definition types.h:38
SAL_WARN_UNUSED_RESULT
#define SAL_WARN_UNUSED_RESULT
Use this as markup for functions and methods whose return value must be checked.
Definition types.h:284
SAL_WARN_UNUSED
#define SAL_WARN_UNUSED
Annotate classes where a compiler should warn if an instance is unused.
Definition types.h:587
RTL_STR_MAX_VALUEOFDOUBLE
#define RTL_STR_MAX_VALUEOFDOUBLE
Definition string.h:715
RTL_STR_MAX_VALUEOFINT32
#define RTL_STR_MAX_VALUEOFINT32
Definition string.h:631
rtl_string_alloc
SAL_DLLPUBLIC rtl_String * rtl_string_alloc(sal_Int32 nLen) SAL_THROW_EXTERN_C()
Allocate a new string containing space for a given number of characters.
rtl_str_valueOfInt64
SAL_DLLPUBLIC sal_Int32 rtl_str_valueOfInt64(char *str, sal_Int64 l, sal_Int16 radix) SAL_THROW_EXTERN_C()
Create the string representation of a long integer.
rtl_string_new
SAL_DLLPUBLIC void rtl_string_new(rtl_String **newStr) SAL_THROW_EXTERN_C()
Allocate a new string containing no characters.
rtl_str_valueOfBoolean
SAL_DLLPUBLIC sal_Int32 rtl_str_valueOfBoolean(char *str, sal_Bool b) SAL_THROW_EXTERN_C()
Create the string representation of a boolean.
rtl_string_newFromLiteral
SAL_DLLPUBLIC void rtl_string_newFromLiteral(rtl_String **newStr, const char *value, sal_Int32 len, sal_Int32 allocExtra) SAL_THROW_EXTERN_C()
RTL_STR_MAX_VALUEOFBOOLEAN
#define RTL_STR_MAX_VALUEOFBOOLEAN
Definition string.h:589
RTL_STR_MAX_VALUEOFFLOAT
#define RTL_STR_MAX_VALUEOFFLOAT
Definition string.h:696
rtl_string_new_WithLength
SAL_DLLPUBLIC void rtl_string_new_WithLength(rtl_String **newStr, sal_Int32 len) SAL_THROW_EXTERN_C()
Allocate a new string containing space for a given number of characters.
rtl_str_valueOfInt32
SAL_DLLPUBLIC sal_Int32 rtl_str_valueOfInt32(char *str, sal_Int32 i, sal_Int16 radix) SAL_THROW_EXTERN_C()
Create the string representation of an integer.
rtl_str_getLength
SAL_DLLPUBLIC sal_Int32 rtl_str_getLength(const char *str) SAL_THROW_EXTERN_C()
Return the length of a string.
RTL_STR_MAX_VALUEOFINT64
#define RTL_STR_MAX_VALUEOFINT64
Definition string.h:654
rtl_string_release
SAL_DLLPUBLIC void rtl_string_release(rtl_String *str) SAL_THROW_EXTERN_C()
Decrement the reference count of a string.
stringutils.hxx
rtl_math_StringFormat_G
@ rtl_math_StringFormat_G
Like sprintf() G, 'F' or 'E' format is used depending on which one is more compact.
Definition math.h:53
rtl_math_doubleToString
SAL_DLLPUBLIC void rtl_math_doubleToString(rtl_String **pResult, sal_Int32 *pResultCapacity, sal_Int32 nResultOffset, double fValue, enum rtl_math_StringFormat eFormat, sal_Int32 nDecPlaces, char cDecSeparator, sal_Int32 const *pGroups, char cGroupSeparator, sal_Bool bEraseTrailingDecZeros) SAL_THROW_EXTERN_C()
Conversions analogous to sprintf() using internal rounding.
string.hxx
strbuf.h
rtl_stringbuffer_ensureCapacity
SAL_DLLPUBLIC void rtl_stringbuffer_ensureCapacity(rtl_String **This, sal_Int32 *capacity, sal_Int32 minimumCapacity)
Ensures that the capacity of the buffer is at least equal to the specified minimum.
rtl_stringbuffer_newFromStringBuffer
SAL_DLLPUBLIC sal_Int32 rtl_stringbuffer_newFromStringBuffer(rtl_String **newStr, sal_Int32 capacity, rtl_String *oldStr)
Allocates a new String that contains the same sequence of characters as the string argument.
rtl_stringbuffer_remove
SAL_DLLPUBLIC void rtl_stringbuffer_remove(rtl_String **This, sal_Int32 start, sal_Int32 len)
Removes the characters in a substring of this sequence.
rtl_stringbuffer_insert
SAL_DLLPUBLIC void rtl_stringbuffer_insert(rtl_String **This, sal_Int32 *capacity, sal_Int32 offset, const char *str, sal_Int32 len)
Inserts the string representation of the char array argument into this string buffer.
rtl_stringbuffer_newFromStr_WithLength
SAL_DLLPUBLIC void rtl_stringbuffer_newFromStr_WithLength(rtl_String **newStr, const char *value, sal_Int32 count)
Allocates a new String that contains characters from the character array argument.
rtl
Definition bootstrap.hxx:34
rtl::Reference
Template reference class for reference type.
Definition ref.hxx:46
rtl::Reference::Reference
Reference()
Constructor...
Definition ref.hxx:55
rtl::OStringBuffer
A string buffer implements a mutable sequence of characters.
Definition strbuf.hxx:72
rtl::OStringBuffer::makeStringAndClear
SAL_WARN_UNUSED_RESULT OString makeStringAndClear()
Fill the string data in the new string and clear the buffer.
Definition strbuf.hxx:371
rtl::OStringBuffer::OStringBuffer
OStringBuffer()
Constructs a string buffer with no characters in it and an initial capacity of 16 characters.
Definition strbuf.hxx:78
rtl::OStringBuffer::append
OStringBuffer & append(sal_Int32 i, sal_Int16 radix=10)
Appends the string representation of the sal_Int32 argument to this string buffer.
Definition strbuf.hxx:697
rtl::OStringBuffer::insert
OStringBuffer & 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 strbuf.hxx:957
rtl::OStringBuffer::accessInternals
void accessInternals(rtl_String ***pInternalData, sal_Int32 **pInternalCapacity)
Allows access to the internal data of this OStringBuffer, for effective manipulation.
Definition strbuf.hxx:1074
rtl::OStringBuffer::insert
libreoffice_internal::NonConstCharArrayDetector< T, OStringBuffer & >::Type insert(sal_Int32 offset, T &str)
Definition strbuf.hxx:823
rtl::OStringBuffer::OStringBuffer
OStringBuffer(const T &value, typename libreoffice_internal::CharPtrDetector< T, libreoffice_internal::Dummy >::Type=libreoffice_internal::Dummy())
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition strbuf.hxx:166
rtl::OStringBuffer::insert
OStringBuffer & insert(sal_Int32 offset, float f)
Inserts the string representation of the float argument into this string buffer.
Definition strbuf.hxx:1004
rtl::OStringBuffer::append
OStringBuffer & append(char c)
Appends the string representation of the char argument to this string buffer.
Definition strbuf.hxx:680
rtl::OStringBuffer::OStringBuffer
OStringBuffer(sal_Int32 length)
Constructs a string buffer with no characters in it and an initial capacity specified by the length a...
Definition strbuf.hxx:104
rtl::OStringBuffer::setLength
void setLength(sal_Int32 newLength)
Sets the length of this String buffer.
Definition strbuf.hxx:451
rtl::OStringBuffer::append
OStringBuffer & append(double d)
Appends the string representation of the double argument to this string buffer.
Definition strbuf.hxx:746
rtl::OStringBuffer::append
OStringBuffer & append(const OString &str)
Appends the string to this string buffer.
Definition strbuf.hxx:543
rtl::OStringBuffer::OStringBuffer
OStringBuffer(const OString &value)
Constructs a string buffer so that it represents the same sequence of characters as the string argume...
Definition strbuf.hxx:153
rtl::OStringBuffer::insert
OStringBuffer & insert(sal_Int32 offset, double d)
Inserts the string representation of the double argument into this string buffer.
Definition strbuf.hxx:1030
rtl::OStringBuffer::isEmpty
bool isEmpty() const
Checks if a string buffer is empty.
Definition strbuf.hxx:397
rtl::OStringBuffer::append
OStringBuffer & append(const char *str, sal_Int32 len)
Appends the string representation of the char array argument to this string buffer.
Definition strbuf.hxx:596
rtl::OStringBuffer::insert
OStringBuffer & insert(sal_Int32 offset, bool b)
Inserts the string representation of the bool argument into this string buffer.
Definition strbuf.hxx:912
rtl::OStringBuffer::insert
libreoffice_internal::ConstCharArrayDetector< T, OStringBuffer & >::Type insert(sal_Int32 offset, T &literal)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition strbuf.hxx:834
rtl::OStringBuffer::OStringBuffer
OStringBuffer(T &literal, typename libreoffice_internal::ConstCharArrayDetector< T, libreoffice_internal::Dummy >::Type=libreoffice_internal::Dummy())
Constructs a string buffer so that it represents the same sequence of characters as the string litera...
Definition strbuf.hxx:206
rtl::OStringBuffer::append
OStringBuffer & append(float f)
Appends the string representation of the float argument to this string buffer.
Definition strbuf.hxx:730
rtl::OStringBuffer::append
OStringBuffer & append(bool b)
Appends the string representation of the bool argument to the string buffer.
Definition strbuf.hxx:655
rtl::OStringBuffer::getStr
const char * getStr() const SAL_RETURNS_NONNULL
Return a null terminated character array.
Definition strbuf.hxx:506
rtl::OStringBuffer::getCapacity
sal_Int32 getCapacity() const
Returns the current capacity of the String buffer.
Definition strbuf.hxx:412
rtl::OStringBuffer::remove
OStringBuffer & remove(sal_Int32 start, sal_Int32 len)
Removes the characters in a substring of this sequence.
Definition strbuf.hxx:1051
rtl::OStringBuffer::insert
OStringBuffer & insert(sal_Int32 offset, char c)
Inserts the string representation of the char argument into this string buffer.
Definition strbuf.hxx:934
rtl::OStringBuffer::~OStringBuffer
~OStringBuffer()
Release the string data.
Definition strbuf.hxx:358
rtl::OStringBuffer::ensureCapacity
void ensureCapacity(sal_Int32 minimumCapacity)
Ensures that the capacity of the buffer is at least equal to the specified minimum.
Definition strbuf.hxx:428
rtl::OStringBuffer::toString
OString toString() const
Return an OString instance reflecting the current content of this OStringBuffer.
Definition strbuf.hxx:527
rtl::OStringBuffer::insert
OStringBuffer & insert(sal_Int32 offset, const OString &str)
Inserts the string into this string buffer.
Definition strbuf.hxx:793
rtl::OStringBuffer::append
libreoffice_internal::ConstCharArrayDetector< T, OStringBuffer & >::Type append(T &literal)
This is an overloaded member function, provided for convenience. It differs from the above function o...
Definition strbuf.hxx:578
rtl::OStringBuffer::append
libreoffice_internal::CharPtrDetector< T, OStringBuffer & >::Type append(const T &str)
Appends the string representation of the char array argument to this string buffer.
Definition strbuf.hxx:561
rtl::OStringBuffer::insert
OStringBuffer & insert(sal_Int32 offset, const char *str, sal_Int32 len)
Inserts the string representation of the char array argument into this string buffer.
Definition strbuf.hxx:863
rtl::OStringBuffer::append
OStringBuffer & append(sal_Int64 l, sal_Int16 radix=10)
Appends the string representation of the long argument to this string buffer.
Definition strbuf.hxx:714
rtl::OStringBuffer::OStringBuffer
OStringBuffer(const OStringBuffer &value)
Allocates a new string buffer that contains the same sequence of characters as the string buffer argu...
Definition strbuf.hxx:91
rtl::OStringBuffer::append
libreoffice_internal::NonConstCharArrayDetector< T, OStringBuffer & >::Type append(T &str)
Definition strbuf.hxx:567
rtl::OStringBuffer::append
OStringBuffer & append(sal_Bool b)
Appends the string representation of the sal_Bool argument to the string buffer.
Definition strbuf.hxx:637
rtl::OStringBuffer::appendUninitialized
char * appendUninitialized(sal_Int32 length) SAL_RETURNS_NONNULL
Unsafe way to make space for a fixed amount of characters to be appended into this OStringBuffer.
Definition strbuf.hxx:766
rtl::OStringBuffer::OStringBuffer
OStringBuffer(const char *value, sal_Int32 length)
Constructs a string buffer so that it represents the same sequence of characters as the string argume...
Definition strbuf.hxx:233
rtl::OStringBuffer::OStringBuffer
OStringBuffer(T &value, typename libreoffice_internal::NonConstCharArrayDetector< T, libreoffice_internal::Dummy >::Type=libreoffice_internal::Dummy())
Definition strbuf.hxx:175
rtl::OStringBuffer::insert
OStringBuffer & insert(sal_Int32 offset, sal_Bool b)
Inserts the string representation of the sal_Bool argument into this string buffer.
Definition strbuf.hxx:887
rtl::OStringBuffer::insert
libreoffice_internal::CharPtrDetector< T, OStringBuffer & >::Type insert(sal_Int32 offset, const T &str)
Inserts the string representation of the char array argument into this string buffer.
Definition strbuf.hxx:817
rtl::OStringBuffer::getLength
sal_Int32 getLength() const
Returns the length (character count) of this string buffer.
Definition strbuf.hxx:384
rtl::OStringBuffer::insert
OStringBuffer & insert(sal_Int32 offset, sal_Int64 l, sal_Int16 radix=10)
Inserts the string representation of the long argument into this string buffer.
Definition strbuf.hxx:981
rtl::OString
This String class provide base functionality for C++ like 8-Bit character array handling.
Definition string.hxx:217
rtl::OString::getStr
const char * getStr() const SAL_RETURNS_NONNULL
Returns a pointer to the characters of this string.
Definition string.hxx:677
rtl::OString::getLength
sal_Int32 getLength() const
Returns the length of this string.
Definition string.hxx:651
rtl::libreoffice_internal::Dummy
Definition stringutils.hxx:140
rtl::libreoffice_internal::CharPtrDetector
Definition stringutils.hxx:143
rtl::libreoffice_internal::NonConstCharArrayDetector
Definition stringutils.hxx:167
rtl::libreoffice_internal::ConstCharArrayDetector
Definition stringutils.hxx:195
rtl::libreoffice_internal::Enable
Definition stringutils.hxx:375