LibreOffice
LibreOffice 5.1 SDK C/C++ API Reference
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 #ifndef INCLUDED_RTL_STRBUF_HXX
21 #define INCLUDED_RTL_STRBUF_HXX
22 
23 #include <sal/config.h>
24 
25 #include <cassert>
26 #include <string.h>
27 
28 #include <rtl/strbuf.h>
29 #include <rtl/string.hxx>
30 #include <rtl/stringutils.hxx>
31 
32 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
33 #include <rtl/stringconcat.hxx>
34 #endif
35 
36 // The unittest uses slightly different code to help check that the proper
37 // calls are made. The class is put into a different namespace to make
38 // sure the compiler generates a different (if generating also non-inline)
39 // copy of the function and does not merge them together. The class
40 // is "brought" into the proper rtl namespace by a typedef below.
41 #ifdef RTL_STRING_UNITTEST
42 #define rtl rtlunittest
43 #endif
44 
45 namespace rtl
46 {
47 
49 #ifdef RTL_STRING_UNITTEST
50 #undef rtl
51 // helper macro to make functions appear more readable
52 #define RTL_STRING_CONST_FUNCTION rtl_string_unittest_const_literal_function = true;
53 #else
54 #define RTL_STRING_CONST_FUNCTION
55 #endif
56 
61 {
62 public:
68  : pData(NULL)
69  , nCapacity( 16 )
70  {
71  rtl_string_new_WithLength( &pData, nCapacity );
72  }
73 
80  OStringBuffer( const OStringBuffer & value )
81  : pData(NULL)
82  , nCapacity( value.nCapacity )
83  {
84  rtl_stringbuffer_newFromStringBuffer( &pData, value.nCapacity, value.pData );
85  }
86 
93  explicit OStringBuffer(int length)
94  : pData(NULL)
95  , nCapacity( length )
96  {
97  rtl_string_new_WithLength( &pData, length );
98  }
99 #if __cplusplus >= 201103L
100  explicit OStringBuffer(unsigned int length)
101  : OStringBuffer(static_cast<int>(length))
102  {
103  }
104 #if SAL_TYPES_SIZEOFLONG == 4
105  // additional overloads for sal_Int32 sal_uInt32
106  explicit OStringBuffer(long length)
107  : OStringBuffer(static_cast<int>(length))
108  {
109  }
110  explicit OStringBuffer(unsigned long length)
111  : OStringBuffer(static_cast<int>(length))
112  {
113  }
114 #endif
115  // avoid obvious bugs
116  explicit OStringBuffer(char) = delete;
117  explicit OStringBuffer(sal_Unicode) = delete;
118 #endif
119 
130  OStringBuffer(const OString& value)
131  : pData(NULL)
132  , nCapacity( value.getLength() + 16 )
133  {
134  rtl_stringbuffer_newFromStr_WithLength( &pData, value.getStr(), value.getLength() );
135  }
136 
141  template< typename T >
143  : pData(NULL)
144  {
145  sal_Int32 length = rtl_str_getLength( value );
146  nCapacity = length + 16;
147  rtl_stringbuffer_newFromStr_WithLength( &pData, value, length );
148  }
149 
150  template< typename T >
152  : pData(NULL)
153  {
154  sal_Int32 length = rtl_str_getLength( value );
155  nCapacity = length + 16;
156  rtl_stringbuffer_newFromStr_WithLength( &pData, value, length );
157  }
158 
170  template< typename T >
172  : pData(NULL)
173  , nCapacity( libreoffice_internal::ConstCharArrayDetector<T>::length + 16 )
174  {
175  assert(
178  &pData,
181 #ifdef RTL_STRING_UNITTEST
182  rtl_string_unittest_const_literal = true;
183 #endif
184  }
185 
198  OStringBuffer(const sal_Char * value, sal_Int32 length)
199  : pData(NULL)
200  , nCapacity( length + 16 )
201  {
202  rtl_stringbuffer_newFromStr_WithLength( &pData, value, length );
203  }
204 
205 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
206 
210  template< typename T1, typename T2 >
211  OStringBuffer( const OStringConcat< T1, T2 >& c )
212  {
213  const sal_Int32 l = c.length();
214  nCapacity = l + 16;
215  pData = rtl_string_alloc( nCapacity );
216  char* end = c.addData( pData->buffer );
217  *end = '\0';
218  pData->length = l;
219  }
220 #endif
221 
224  OStringBuffer& operator = ( const OStringBuffer& value )
225  {
226  if (this != &value)
227  {
229  value.nCapacity,
230  value.pData);
231  nCapacity = value.nCapacity;
232  }
233  return *this;
234  }
235 
240  {
241  rtl_string_release( pData );
242  }
243 
253  {
254  OString aRet( pData );
255  rtl_string_new(&pData);
256  nCapacity = 0;
257  return aRet;
258  }
259 
265  sal_Int32 getLength() const
266  {
267  return pData->length;
268  }
269 
278  bool isEmpty() const
279  {
280  return pData->length == 0;
281  }
282 
293  sal_Int32 getCapacity() const
294  {
295  return nCapacity;
296  }
297 
309  void ensureCapacity(sal_Int32 minimumCapacity)
310  {
311  rtl_stringbuffer_ensureCapacity( &pData, &nCapacity, minimumCapacity );
312  }
313 
332  void setLength(sal_Int32 newLength)
333  {
334  assert(newLength >= 0);
335  // Avoid modifications if pData points to const empty string:
336  if( newLength != pData->length )
337  {
338  if( newLength > nCapacity )
339  rtl_stringbuffer_ensureCapacity(&pData, &nCapacity, newLength);
340  else
341  pData->buffer[newLength] = '\0';
342  pData->length = newLength;
343  }
344  }
345 
359  SAL_DEPRECATED("use rtl::OStringBuffer::operator [] instead")
360  sal_Char charAt( sal_Int32 index )
361  {
362  assert(index >= 0 && index < pData->length);
363  return pData->buffer[ index ];
364  }
365 
376  SAL_DEPRECATED("use rtl::OStringBuffer::operator [] instead")
377  OStringBuffer & setCharAt(sal_Int32 index, sal_Char ch)
378  {
379  assert(index >= 0 && index < pData->length);
380  pData->buffer[ index ] = ch;
381  return *this;
382  }
383 
387  const sal_Char* getStr() const { return pData->buffer; }
388 
398  sal_Char & operator [](sal_Int32 index)
399  {
400  assert(index >= 0 && index < pData->length);
401  return pData->buffer[index];
402  }
403 
408  const OString toString() const
409  {
410  return OString(pData->buffer, pData->length);
411  }
412 
424  {
425  return append( str.getStr(), str.getLength() );
426  }
427 
439  template< typename T >
441  {
442  return append( str, rtl_str_getLength( str ) );
443  }
444 
445  template< typename T >
447  {
448  return append( str, rtl_str_getLength( str ) );
449  }
450 
456  template< typename T >
458  {
459  RTL_STRING_CONST_FUNCTION
460  assert(
463  &pData, &nCapacity, getLength(),
466  return *this;
467  }
468 
482  OStringBuffer & append( const sal_Char * str, sal_Int32 len)
483  {
484  assert( len == 0 || str != 0 ); // cannot assert that in rtl_stringbuffer_insert
485  rtl_stringbuffer_insert( &pData, &nCapacity, getLength(), str, len );
486  return *this;
487  }
488 
489 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
490 
494  template< typename T1, typename T2 >
495  OStringBuffer& append( const OStringConcat< T1, T2 >& c )
496  {
497  sal_Int32 l = c.length();
498  if( l == 0 )
499  return *this;
500  l += pData->length;
501  rtl_stringbuffer_ensureCapacity( &pData, &nCapacity, l );
502  char* end = c.addData( pData->buffer + pData->length );
503  *end = '\0';
504  pData->length = l;
505  return *this;
506  }
507 #endif
508 
521  {
523  return append( sz, rtl_str_valueOfBoolean( sz, b ) );
524  }
525 
540  {
542  return append( sz, rtl_str_valueOfBoolean( sz, b ) );
543  }
544 
546  // Pointer can be automatically converted to bool, which is unwanted here.
547  // Explicitly delete all pointer append() overloads to prevent this
548  // (except for char* overload, which is handled elsewhere).
549  template< typename T >
550  typename libreoffice_internal::Enable< void,
552  append( T* ) SAL_DELETED_FUNCTION;
554 
566  {
567  return append( &c, 1 );
568  }
569 
582  OStringBuffer & append(sal_Int32 i, sal_Int16 radix = 10 )
583  {
585  return append( sz, rtl_str_valueOfInt32( sz, i, radix ) );
586  }
587 
600  OStringBuffer & append(sal_Int64 l, sal_Int16 radix = 10 )
601  {
603  return append( sz, rtl_str_valueOfInt64( sz, l, radix ) );
604  }
605 
618  {
620  return append( sz, rtl_str_valueOfFloat( sz, f ) );
621  }
622 
634  OStringBuffer & append(double d)
635  {
637  return append( sz, rtl_str_valueOfDouble( sz, d ) );
638  }
639 
655  char * appendUninitialized(sal_Int32 length) {
656  sal_Int32 n = getLength();
657  rtl_stringbuffer_insert(&pData, &nCapacity, n, 0, length);
658  return pData->buffer + n;
659  }
660 
676  OStringBuffer & insert(sal_Int32 offset, const OString & str)
677  {
678  return insert( offset, str.getStr(), str.getLength() );
679  }
680 
698  template< typename T >
700  {
701  return insert( offset, str, rtl_str_getLength( str ) );
702  }
703 
704  template< typename T >
706  {
707  return insert( offset, str, rtl_str_getLength( str ) );
708  }
709 
715  template< typename T >
717  {
718  RTL_STRING_CONST_FUNCTION
719  assert(
722  &pData, &nCapacity, offset,
725  return *this;
726  }
727 
746  OStringBuffer & insert( sal_Int32 offset, const sal_Char * str, sal_Int32 len)
747  {
748  assert( len == 0 || str != 0 ); // cannot assert that in rtl_stringbuffer_insert
749  rtl_stringbuffer_insert( &pData, &nCapacity, offset, str, len );
750  return *this;
751  }
752 
770  OStringBuffer & insert(sal_Int32 offset, sal_Bool b)
771  {
773  return insert( offset, sz, rtl_str_valueOfBoolean( sz, b ) );
774  }
775 
795  OStringBuffer & insert(sal_Int32 offset, bool b)
796  {
798  return insert( offset, sz, rtl_str_valueOfBoolean( sz, b ) );
799  }
800 
817  OStringBuffer & insert(sal_Int32 offset, sal_Char c)
818  {
819  return insert( offset, &c, 1 );
820  }
821 
840  OStringBuffer & insert(sal_Int32 offset, sal_Int32 i, sal_Int16 radix = 10 )
841  {
843  return insert( offset, sz, rtl_str_valueOfInt32( sz, i, radix ) );
844  }
845 
864  OStringBuffer & insert(sal_Int32 offset, sal_Int64 l, sal_Int16 radix = 10 )
865  {
867  return insert( offset, sz, rtl_str_valueOfInt64( sz, l, radix ) );
868  }
869 
887  OStringBuffer insert(sal_Int32 offset, float f)
888  {
890  return insert( offset, sz, rtl_str_valueOfFloat( sz, f ) );
891  }
892 
910  OStringBuffer & insert(sal_Int32 offset, double d)
911  {
913  return insert( offset, sz, rtl_str_valueOfDouble( sz, d ) );
914  }
915 
928  OStringBuffer & remove( sal_Int32 start, sal_Int32 len )
929  {
930  rtl_stringbuffer_remove( &pData, start, len );
931  return *this;
932  }
933 
934 private:
938  rtl_String * pData;
939 
943  sal_Int32 nCapacity;
944 };
945 
946 #ifdef LIBO_INTERNAL_ONLY // "RTL_FAST_STRING"
947 
950 template<>
951 struct ToStringHelper< OStringBuffer >
952  {
953  static int length( const OStringBuffer& s ) { return s.getLength(); }
954  static char* addData( char* buffer, const OStringBuffer& s ) { return addDataHelper( buffer, s.getStr(), s.getLength()); }
955  static const bool allowOStringConcat = true;
956  static const bool allowOUStringConcat = false;
957  };
958 #endif
959 
960 
961 }
962 
963 #ifdef RTL_STRING_UNITTEST
964 namespace rtl
965 {
966 typedef rtlunittest::OStringBuffer OStringBuffer;
967 }
968 #undef RTL_STRING_CONST_FUNCTION
969 #endif
970 
971 #if defined LIBO_INTERNAL_ONLY && !defined RTL_STRING_UNITTEST
972 using ::rtl::OStringBuffer;
973 #endif
974 
975 #endif // INCLUDED_RTL_STRBUF_HXX
976 
977 
978 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
#define RTL_STR_MAX_VALUEOFINT32
Definition: string.h:627
SAL_DLLPUBLIC void rtl_stringbuffer_remove(rtl_String **This, sal_Int32 start, sal_Int32 len)
Removes the characters in a substring of this sequence.
SAL_DLLPUBLIC void rtl_string_release(rtl_String *str) SAL_THROW_EXTERN_C()
Decrement the reference count of a string.
bool isEmpty() const
Checks if a string buffer is empty.
Definition: strbuf.hxx:278
OStringBuffer & insert(sal_Int32 offset, double d)
Inserts the string representation of the double argument into this string buffer. ...
Definition: strbuf.hxx:910
OStringBuffer & insert(sal_Int32 offset, sal_Bool b)
Inserts the string representation of the sal_Bool argument into this string buffer.
Definition: strbuf.hxx:770
OStringBuffer & insert(sal_Int32 offset, const sal_Char *str, sal_Int32 len)
Inserts the string representation of the char array argument into this string buffer.
Definition: strbuf.hxx:746
sal_Int32 getCapacity() const
Returns the current capacity of the String buffer.
Definition: strbuf.hxx:293
OStringBuffer(int length)
Constructs a string buffer with no characters in it and an initial capacity specified by the length a...
Definition: strbuf.hxx:93
void ensureCapacity(sal_Int32 minimumCapacity)
Ensures that the capacity of the buffer is at least equal to the specified minimum.
Definition: strbuf.hxx:309
#define SAL_DELETED_FUNCTION
short-circuit extra-verbose API namespaces
Definition: types.h:404
#define RTL_STR_MAX_VALUEOFDOUBLE
Definition: string.h:711
sal_Int32 getLength() const
Returns the length (character count) of this string buffer.
Definition: strbuf.hxx:265
#define SAL_WARN_UNUSED
Annotate classes where a compiler should warn if an instance is unused.
Definition: types.h:608
OStringBuffer & append(bool b)
Appends the string representation of the bool argument to the string buffer.
Definition: strbuf.hxx:539
SAL_DLLPUBLIC sal_Int32 rtl_str_valueOfFloat(sal_Char *str, float f) SAL_THROW_EXTERN_C()
Create the string representation of a float.
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:699
SAL_DLLPUBLIC void rtl_string_newFromLiteral(rtl_String **newStr, const sal_Char *value, sal_Int32 len, sal_Int32 allocExtra) SAL_THROW_EXTERN_C()
char sal_Char
A legacy synonym for char.
Definition: types.h:130
Definition: stringutils.hxx:116
This String class provide base functionality for C++ like 8-Bit character array handling.
Definition: string.hxx:89
const OString toString() const
Return a OString instance reflecting the current content of this OStringBuffer.
Definition: strbuf.hxx:408
OStringBuffer(const OStringBuffer &value)
Allocates a new string buffer that contains the same sequence of characters as the string buffer argu...
Definition: strbuf.hxx:80
unsigned char sal_Bool
Definition: types.h:48
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:864
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:171
OStringBuffer(T &value, typename libreoffice_internal::NonConstCharArrayDetector< T, libreoffice_internal::Dummy >::Type=libreoffice_internal::Dummy())
Definition: strbuf.hxx:151
OStringBuffer & insert(sal_Int32 offset, const OString &str)
Inserts the string into this string buffer.
Definition: strbuf.hxx:676
const sal_Char * getStr() const
Returns a pointer to the characters of this string.
Definition: string.hxx:380
SAL_DLLPUBLIC sal_Int32 rtl_str_getLength(const sal_Char *str) SAL_THROW_EXTERN_C()
Return the length of a string.
OStringBuffer()
Constructs a string buffer with no characters in it and an initial capacity of 16 characters...
Definition: strbuf.hxx:67
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.
SAL_DLLPUBLIC void rtl_string_new(rtl_String **newStr) SAL_THROW_EXTERN_C()
Allocate a new string containing no characters.
#define RTL_STR_MAX_VALUEOFBOOLEAN
Definition: string.h:585
~OStringBuffer()
Release the string data.
Definition: strbuf.hxx:239
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.
OStringBuffer & append(const sal_Char *str, sal_Int32 len)
Appends the string representation of the char array argument to this string buffer.
Definition: strbuf.hxx:482
const sal_Char * getStr() const
Return a null terminated character array.
Definition: strbuf.hxx:387
OStringBuffer & insert(sal_Int32 offset, sal_Char c)
Inserts the string representation of the char argument into this string buffer.
Definition: strbuf.hxx:817
OStringBuffer(const sal_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:198
#define RTL_STR_MAX_VALUEOFFLOAT
Definition: string.h:692
void setLength(sal_Int32 newLength)
Sets the length of this String buffer.
Definition: strbuf.hxx:332
#define RTL_STR_MAX_VALUEOFINT64
Definition: string.h:650
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.
OStringBuffer & append(sal_Int64 l, sal_Int16 radix=10)
Appends the string representation of the long argument to this string buffer.
Definition: strbuf.hxx:600
sal_uInt16 sal_Unicode
Definition: types.h:152
Definition: stringutils.hxx:244
libreoffice_internal::NonConstCharArrayDetector< T, OStringBuffer & >::Type insert(sal_Int32 offset, T &str)
Definition: strbuf.hxx:705
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...
SAL_DLLPUBLIC sal_Int32 rtl_str_valueOfInt64(sal_Char *str, sal_Int64 l, sal_Int16 radix) SAL_THROW_EXTERN_C()
Create the string representation of a long integer.
SAL_DLLPUBLIC void rtl_stringbuffer_newFromStr_WithLength(rtl_String **newStr, const sal_Char *value, sal_Int32 count)
Allocates a new String that contains characters from the character array argument.
OString makeStringAndClear()
Fill the string data in the new string and clear the buffer.
Definition: strbuf.hxx:252
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:840
OStringBuffer & append(sal_Bool b)
Appends the string representation of the sal_Bool argument to the string buffer.
Definition: strbuf.hxx:520
Definition: stringutils.hxx:118
SAL_DLLPUBLIC void rtl_stringbuffer_insert(rtl_String **This, sal_Int32 *capacity, sal_Int32 offset, const sal_Char *str, sal_Int32 len)
Inserts the string representation of the char array argument into this string buffer.
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:142
#define SAL_DEPRECATED(message)
Use as follows: SAL_DEPRECATED("Dont use, its evil.") void doit(int nPara);.
Definition: types.h:495
OStringBuffer & insert(sal_Int32 offset, bool b)
Inserts the string representation of the bool argument into this string buffer.
Definition: strbuf.hxx:795
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:457
OStringBuffer & append(double d)
Appends the string representation of the double argument to this string buffer.
Definition: strbuf.hxx:634
OStringBuffer & append(float f)
Appends the string representation of the float argument to this string buffer.
Definition: strbuf.hxx:617
SAL_DLLPUBLIC sal_Int32 rtl_str_valueOfBoolean(sal_Char *str, sal_Bool b) SAL_THROW_EXTERN_C()
Create the string representation of a boolean.
char * appendUninitialized(sal_Int32 length)
Unsafe way to make space for a fixed amount of characters to be appended into this OStringBuffer...
Definition: strbuf.hxx:655
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:582
SAL_DLLPUBLIC sal_Int32 rtl_str_valueOfDouble(sal_Char *str, double d) SAL_THROW_EXTERN_C()
Create the string representation of a double.
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:440
Definition: bootstrap.hxx:24
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:716
libreoffice_internal::NonConstCharArrayDetector< T, OStringBuffer & >::Type append(T &str)
Definition: strbuf.hxx:446
OStringBuffer(const OString &value)
Constructs a string buffer so that it represents the same sequence of characters as the string argume...
Definition: strbuf.hxx:130
OStringBuffer insert(sal_Int32 offset, float f)
Inserts the string representation of the float argument into this string buffer.
Definition: strbuf.hxx:887
sal_Int32 getLength() const
Returns the length of this string.
Definition: string.hxx:354
A string buffer implements a mutable sequence of characters.
Definition: strbuf.hxx:60
OStringBuffer & append(const OString &str)
Appends the string to this string buffer.
Definition: strbuf.hxx:423
SAL_DLLPUBLIC sal_Int32 rtl_str_valueOfInt32(sal_Char *str, sal_Int32 i, sal_Int16 radix) SAL_THROW_EXTERN_C()
Create the string representation of an integer.