ICU 50.1.2  50.1.2
Public Member Functions
icu::UnicodeStringAppendable Class Reference

An Appendable implementation which writes to a UnicodeString. More...

#include <appendable.h>

Inheritance diagram for icu::UnicodeStringAppendable:
icu::Appendable icu::UObject icu::UMemory

Public Member Functions

 UnicodeStringAppendable (UnicodeString &s)
 Aliases the UnicodeString (keeps its reference) for writing. More...
 
 ~UnicodeStringAppendable ()
 Destructor. More...
 
virtual UBool appendCodeUnit (UChar c)
 Appends a 16-bit code unit to the string. More...
 
virtual UBool appendCodePoint (UChar32 c)
 Appends a code point to the string. More...
 
virtual UBool appendString (const UChar *s, int32_t length)
 Appends a string to the UnicodeString. More...
 
virtual UBool reserveAppendCapacity (int32_t appendCapacity)
 Tells the UnicodeString that the caller is going to append roughly appendCapacity UChars. More...
 
virtual UChargetAppendBuffer (int32_t minCapacity, int32_t desiredCapacityHint, UChar *scratch, int32_t scratchCapacity, int32_t *resultCapacity)
 Returns a writable buffer for appending and writes the buffer's capacity to *resultCapacity. More...
 
- Public Member Functions inherited from icu::Appendable
 ~Appendable ()
 Destructor. More...
 
- Public Member Functions inherited from icu::UObject
virtual ~UObject ()
 Destructor. More...
 

Detailed Description

An Appendable implementation which writes to a UnicodeString.

This class is not intended for public subclassing.

Stable:
ICU 4.8

Definition at line 155 of file appendable.h.

Constructor & Destructor Documentation

icu::UnicodeStringAppendable::UnicodeStringAppendable ( UnicodeString s)
inlineexplicit

Aliases the UnicodeString (keeps its reference) for writing.

Parameters
sThe UnicodeString to which this Appendable will write.
Stable:
ICU 4.8

Definition at line 162 of file appendable.h.

icu::UnicodeStringAppendable::~UnicodeStringAppendable ( )

Destructor.

Stable:
ICU 4.8

Member Function Documentation

virtual UBool icu::UnicodeStringAppendable::appendCodePoint ( UChar32  c)
virtual

Appends a code point to the string.

Parameters
ccode point 0..0x10ffff
Returns
TRUE if the operation succeeded
Stable:
ICU 4.8

Reimplemented from icu::Appendable.

virtual UBool icu::UnicodeStringAppendable::appendCodeUnit ( UChar  c)
virtual

Appends a 16-bit code unit to the string.

Parameters
ccode unit
Returns
TRUE if the operation succeeded
Stable:
ICU 4.8

Implements icu::Appendable.

virtual UBool icu::UnicodeStringAppendable::appendString ( const UChar s,
int32_t  length 
)
virtual

Appends a string to the UnicodeString.

Parameters
sstring, must not be NULL if length!=0
lengthstring length, or -1 if NUL-terminated
Returns
TRUE if the operation succeeded
Stable:
ICU 4.8

Reimplemented from icu::Appendable.

virtual UChar* icu::UnicodeStringAppendable::getAppendBuffer ( int32_t  minCapacity,
int32_t  desiredCapacityHint,
UChar scratch,
int32_t  scratchCapacity,
int32_t *  resultCapacity 
)
virtual

Returns a writable buffer for appending and writes the buffer's capacity to *resultCapacity.

Guarantees *resultCapacity>=minCapacity. May return a pointer to the caller-owned scratch buffer which must have scratchCapacity>=minCapacity. The returned buffer is only valid until the next write operation on the UnicodeString.

For details see Appendable::getAppendBuffer().

Parameters
minCapacityrequired minimum capacity of the returned buffer; must be non-negative
desiredCapacityHintdesired capacity of the returned buffer; must be non-negative
scratchdefault caller-owned buffer
scratchCapacitycapacity of the scratch buffer
resultCapacitypointer to an integer which will be set to the capacity of the returned buffer
Returns
a buffer with *resultCapacity>=minCapacity
Stable:
ICU 4.8

Reimplemented from icu::Appendable.

virtual UBool icu::UnicodeStringAppendable::reserveAppendCapacity ( int32_t  appendCapacity)
virtual

Tells the UnicodeString that the caller is going to append roughly appendCapacity UChars.

Parameters
appendCapacityestimated number of UChars that will be appended
Returns
TRUE if the operation succeeded
Stable:
ICU 4.8

Reimplemented from icu::Appendable.


The documentation for this class was generated from the following file: