The Free and Open Productivity Suite
Follow us on Twitter: @ApacheOO

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous


Global Functions in Global Namespace C++
in Sourcefile strbuf.h


rtl_stringbuffer_ensureCapacity
extern "C"
void rtl_stringbuffer_ensureCapacity(
rtl_String * * This,
sal_Int32 * capacity,
sal_Int32 minimumCapacity );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO YES

Summary
Ensures that the capacity of the buffer is at least equal to the specified minimum.
Description
If the current capacity of this string buffer is less than the argument, then a new internal buffer is allocated with greater capacity. The new capacity is the larger of:
  • The minimumCapacity argument.
  • Twice the old capacity, plus 2.
If the minimumCapacity argument is nonpositive, this method takes no action and simply returns.
Parameters
capacity
in: old capicity, out: new capacity.
minimumCapacity
the minimum desired capacity.

rtl_stringbuffer_insert
extern "C"
void rtl_stringbuffer_insert(
rtl_String * * This,
sal_Int32 * capacity,
sal_Int32 offset,
const sal_Char * str,
sal_Int32 len );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO YES

Summary
Inserts the string representation of the char array argument into this string buffer.
Description
The characters of the array argument are inserted into the contents of this string buffer at the position indicated by offset. The length of this string buffer increases by the length of the argument.
Parameters
capacity
the capacity of the string buffer
offset
the offset.
ch
a character array.
len
the number of characters to append.
Return
this string buffer.

rtl_stringbuffer_newFromStr_WithLength
extern "C"
void rtl_stringbuffer_newFromStr_WithLength(
rtl_String * * newStr,
const sal_Char * value,
sal_Int32 count );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO YES

Summary
Allocates a new String that contains characters from the character array argument.
Description
The count argument specifies the length of the array. The initial capacity of the string buffer is 16 plus the length of the string argument.
Parameters
newStr
out parameter, contains the new string. The reference count is 1.
value
the initial value of the string.
count
the length of value.

rtl_stringbuffer_newFromStringBuffer
extern "C"
sal_Int32 rtl_stringbuffer_newFromStringBuffer(
rtl_String * * newStr,
sal_Int32 capacity,
rtl_String * olsStr );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO YES

Summary
Allocates a new String that contains the same sequence of characters as the string argument.
Description
The initial capacity is the larger of:
  • The bufferLen argument.
  • The length of the string argument.
Parameters
newStr
out parameter, contains the new string. The reference count is 1.
capacity
the initial len of the string buffer.
oldStr
the initial value of the string.
Return
the new capacity of the string buffer

Top of Page

Apache Software Foundation

Copyright & License | Privacy | Website Feedback | Contact Us | Donate | Thanks

Apache, the Apache feather logo, and OpenOffice are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.