🐐 GOAT

🐐 GOAT Shell

Current path: opt/alt/libicu65/usr/include/unicode/

✏️ Editing: appendable.h

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
*******************************************************************************
*   Copyright (C) 2011-2012, International Business Machines
*   Corporation and others.  All Rights Reserved.
*******************************************************************************
*   file name:  appendable.h
*   encoding:   UTF-8
*   tab size:   8 (not used)
*   indentation:4
*
*   created on: 2010dec07
*   created by: Markus W. Scherer
*/

#ifndef __APPENDABLE_H__
#define __APPENDABLE_H__

/**
 * \file
 * \brief C++ API: Appendable class: Sink for Unicode code points and 16-bit code units (char16_ts).
 */

#include "unicode/utypes.h"

#if U_SHOW_CPLUSPLUS_API

#include "unicode/uobject.h"

U_NAMESPACE_BEGIN

class UnicodeString;

/**
 * Base class for objects to which Unicode characters and strings can be appended.
 * Combines elements of Java Appendable and ICU4C ByteSink.
 *
 * This class can be used in APIs where it does not matter whether the actual destination is
 * a UnicodeString, a char16_t[] array, a UnicodeSet, or any other object
 * that receives and processes characters and/or strings.
 *
 * Implementation classes must implement at least appendCodeUnit(char16_t).
 * The base class provides default implementations for the other methods.
 *
 * The methods do not take UErrorCode parameters.
 * If an error occurs (e.g., out-of-memory),
 * in addition to returning FALSE from failing operations,
 * the implementation must prevent unexpected behavior (e.g., crashes)
 * from further calls and should make the error condition available separately
 * (e.g., store a UErrorCode, make/keep a UnicodeString bogus).
 * @stable ICU 4.8
 */
class U_COMMON_API Appendable : public UObject {
public:
    /**
     * Destructor.
     * @stable ICU 4.8
     */
    ~Appendable();

/**
     * Appends a 16-bit code unit.
     * @param c code unit
     * @return TRUE if the operation succeeded
     * @stable ICU 4.8
     */
    virtual UBool appendCodeUnit(char16_t c) = 0;

/**
     * Appends a code point.
     * The default implementation calls appendCodeUnit(char16_t) once or twice.
     * @param c code point 0..0x10ffff
     * @return TRUE if the operation succeeded
     * @stable ICU 4.8
     */
    virtual UBool appendCodePoint(UChar32 c);

/**
     * Appends a string.
     * The default implementation calls appendCodeUnit(char16_t) for each code unit.
     * @param s string, must not be NULL if length!=0
     * @param length string length, or -1 if NUL-terminated
     * @return TRUE if the operation succeeded
     * @stable ICU 4.8
     */
    virtual UBool appendString(const char16_t *s, int32_t length);

/**
     * Tells the object that the caller is going to append roughly
     * appendCapacity char16_ts. A subclass might use this to pre-allocate
     * a larger buffer if necessary.
     * The default implementation does nothing. (It always returns TRUE.)
     * @param appendCapacity estimated number of char16_ts that will be appended
     * @return TRUE if the operation succeeded
     * @stable ICU 4.8
     */
    virtual UBool reserveAppendCapacity(int32_t appendCapacity);

/**
     * 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 operation
     * on this Appendable.
     *
     * After writing at most *resultCapacity char16_ts, call appendString() with the
     * pointer returned from this function and the number of char16_ts written.
     * Many appendString() implementations will avoid copying char16_ts if this function
     * returned an internal buffer.
     *
     * Partial usage example:
     * \code
     *  int32_t capacity;
     *  char16_t* buffer = app.getAppendBuffer(..., &capacity);
     *  ... Write n char16_ts into buffer, with n <= capacity.
     *  app.appendString(buffer, n);
     * \endcode
     * In many implementations, that call to append will avoid copying char16_ts.
     *
     * If the Appendable allocates or reallocates an internal buffer, it should use
     * the desiredCapacityHint if appropriate.
     * If a caller cannot provide a reasonable guess at the desired capacity,
     * it should pass desiredCapacityHint=0.
     *
     * If a non-scratch buffer is returned, the caller may only pass
     * a prefix to it to appendString().
     * That is, it is not correct to pass an interior pointer to appendString().
     *
     * The default implementation always returns the scratch buffer.
     *
     * @param minCapacity required minimum capacity of the returned buffer;
     *                    must be non-negative
     * @param desiredCapacityHint desired capacity of the returned buffer;
     *                            must be non-negative
     * @param scratch default caller-owned buffer
     * @param scratchCapacity capacity of the scratch buffer
     * @param resultCapacity pointer to an integer which will be set to the
     *                       capacity of the returned buffer
     * @return a buffer with *resultCapacity>=minCapacity
     * @stable ICU 4.8
     */
    virtual char16_t *getAppendBuffer(int32_t minCapacity,
                                   int32_t desiredCapacityHint,
                                   char16_t *scratch, int32_t scratchCapacity,
                                   int32_t *resultCapacity);
};

/**
 * An Appendable implementation which writes to a UnicodeString.
 *
 * This class is not intended for public subclassing.
 * @stable ICU 4.8
 */
class U_COMMON_API UnicodeStringAppendable : public Appendable {
public:
    /**
     * Aliases the UnicodeString (keeps its reference) for writing.
     * @param s The UnicodeString to which this Appendable will write.
     * @stable ICU 4.8
     */
    explicit UnicodeStringAppendable(UnicodeString &s) : str(s) {}

/**
     * Destructor.
     * @stable ICU 4.8
     */
    ~UnicodeStringAppendable();

/**
     * Appends a 16-bit code unit to the string.
     * @param c code unit
     * @return TRUE if the operation succeeded
     * @stable ICU 4.8
     */
    virtual UBool appendCodeUnit(char16_t c);

/**
     * Appends a code point to the string.
     * @param c code point 0..0x10ffff
     * @return TRUE if the operation succeeded
     * @stable ICU 4.8
     */
    virtual UBool appendCodePoint(UChar32 c);

/**
     * Appends a string to the UnicodeString.
     * @param s string, must not be NULL if length!=0
     * @param length string length, or -1 if NUL-terminated
     * @return TRUE if the operation succeeded
     * @stable ICU 4.8
     */
    virtual UBool appendString(const char16_t *s, int32_t length);

/**
     * Tells the UnicodeString that the caller is going to append roughly
     * appendCapacity char16_ts.
     * @param appendCapacity estimated number of char16_ts that will be appended
     * @return TRUE if the operation succeeded
     * @stable ICU 4.8
     */
    virtual UBool reserveAppendCapacity(int32_t appendCapacity);

private:
    UnicodeString &str;
};

U_NAMESPACE_END

#endif /* U_SHOW_CPLUSPLUS_API */

#endif  // __APPENDABLE_H__

📄 alphaindex.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 appendable.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 basictz.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 brkiter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 bytestream.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 bytestrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 bytestriebuilder.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 calendar.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 caniter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 casemap.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 char16ptr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 chariter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 choicfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 coleitr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 coll.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 compactdecimalformat.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 curramt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 currpinf.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 currunit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 datefmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dbbi.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dcfmtsym.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 decimfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 docmain.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtfmtsym.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtintrv.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtitvfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtitvinf.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtptngen.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 dtrule.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 edits.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 enumset.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 errorcode.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 fieldpos.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 filteredbrk.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 fmtable.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 format.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 formattedvalue.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 fpositer.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 gender.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 gregocal.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 icudataver.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 icuplug.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 idna.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 listformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 localebuilder.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 localematcher.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 localpointer.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 locdspnm.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 locid.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 measfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 measunit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 measure.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 messagepattern.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 msgfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 normalizer2.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 normlzr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 nounit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 numberformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 numberrangeformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 numfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 numsys.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 parseerr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 parsepos.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 platform.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 plurfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 plurrule.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ptypes.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 putil.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 rbbi.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 rbnf.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 rbtz.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 regex.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 region.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 reldatefmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 rep.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 resbund.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 schriter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 scientificnumberformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 search.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 selfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 simpleformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 simpletz.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 smpdtfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 sortkey.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 std_string.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 strenum.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 stringoptions.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 stringpiece.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 stringtriebuilder.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 stsearch.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 symtable.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tblcoll.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 timezone.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tmunit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tmutamt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tmutfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 translit.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tzfmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tznames.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tzrule.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 tztrans.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ubidi.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ubiditransform.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ubrk.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucal.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucasemap.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucat.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uchar.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucharstrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucharstriebuilder.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uchriter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uclean.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucnv.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucnvsel.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucnv_cb.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucnv_err.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucol.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucoleitr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uconfig.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucpmap.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucptrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucsdet.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ucurr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udat.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udata.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udateintervalformat.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udatpg.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 udisplaycontext.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uenum.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ufieldpositer.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uformattable.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uformattedvalue.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ugender.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uidna.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uiter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uldnames.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ulistformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uloc.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ulocdata.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 umachine.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 umisc.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 umsg.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 umutablecptrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unifilt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unifunct.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unimatch.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unirepl.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uniset.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unistr.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unorm.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unorm2.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unum.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unumberformatter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 unumsys.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uobject.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 upluralrules.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uregex.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uregion.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ureldatefmt.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 urename.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 urep.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ures.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uscript.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 usearch.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uset.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 usetiter.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ushape.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uspoof.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 usprep.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ustdio.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ustream.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ustring.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 ustringtrie.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utext.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf8.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf16.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf32.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utf_old.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utmscale.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utrace.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utrans.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 utypes.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uvernum.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 uversion.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete
📄 vtzone.h | ✏️ Edit | ✏️ Rename | 🗑️ Delete

🐐 GOAT Shell

✏️ Editing: appendable.h

📤 Upload File

📁 Create Folder