Overview | Namespace | Class | Index | Help

## 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

Copyright © 2003 Sun Microsystems, Inc.