ICU 72.1 72.1
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 (char16_t c) override
 Appends a 16-bit code unit to the string. More...
 
virtual UBool appendCodePoint (UChar32 c) override
 Appends a code point to the string. More...
 
virtual UBool appendString (const char16_t *s, int32_t length) override
 Appends a string to the UnicodeString. More...
 
virtual UBool reserveAppendCapacity (int32_t appendCapacity) override
 Tells the UnicodeString that the caller is going to append roughly appendCapacity char16_ts. More...
 
virtual char16_t * getAppendBuffer (int32_t minCapacity, int32_t desiredCapacityHint, char16_t *scratch, int32_t scratchCapacity, int32_t *resultCapacity) override
 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...
 
virtual UBool appendCodeUnit (char16_t c)=0
 Appends a 16-bit code unit. More...
 
virtual UBool appendCodePoint (UChar32 c)
 Appends a code point. More...
 
virtual UBool appendString (const char16_t *s, int32_t length)
 Appends a string. More...
 
virtual UBool reserveAppendCapacity (int32_t appendCapacity)
 Tells the object that the caller is going to append roughly appendCapacity char16_ts. More...
 
virtual char16_t * getAppendBuffer (int32_t minCapacity, int32_t desiredCapacityHint, char16_t *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::UObject
virtual ~UObject ()
 Destructor. More...
 
virtual UClassID getDynamicClassID () const
 ICU4C "poor man's RTTI", returns a UClassID for the actual ICU class. 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 156 of file appendable.h.

Constructor & Destructor Documentation

◆ UnicodeStringAppendable()

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 163 of file appendable.h.

◆ ~UnicodeStringAppendable()

icu::UnicodeStringAppendable::~UnicodeStringAppendable ( )

Destructor.

Stable:
ICU 4.8

Member Function Documentation

◆ appendCodePoint()

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

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.

◆ appendCodeUnit()

virtual UBool icu::UnicodeStringAppendable::appendCodeUnit ( char16_t  c)
overridevirtual

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.

◆ appendString()

virtual UBool icu::UnicodeStringAppendable::appendString ( const char16_t *  s,
int32_t  length 
)
overridevirtual

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.

◆ getAppendBuffer()

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

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.

◆ reserveAppendCapacity()

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

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

Parameters
appendCapacityestimated number of char16_ts 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: