ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / include / unicode

// © 2017 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html

// char16ptr.h
// created: 2017feb28 Markus W. Scherer

#ifndef __CHAR16PTR_H__
#define __CHAR16PTR_H__

#include "unicode/utypes.h"

#if U_SHOW_CPLUSPLUS_API

#include <cstddef>

/**
 * \file
 * \brief C++ API: char16_t pointer wrappers with
 *        implicit conversion from bit-compatible raw pointer types.
 *        Also conversion functions from char16_t * to UChar * and OldUChar *.
 */

U_NAMESPACE_BEGIN

/**
 * \def U_ALIASING_BARRIER
 * Barrier for pointer anti-aliasing optimizations even across function boundaries.
 * @internal
 */
#ifdef U_ALIASING_BARRIER
    // Use the predefined value.
#elif (defined(__clang__) || defined(__GNUC__)) && U_PLATFORM != U_PF_BROWSER_NATIVE_CLIENT
#   define U_ALIASING_BARRIER(ptr) asm volatile("" : : "rm"(ptr) : "memory")
#elif defined(U_IN_DOXYGEN)
#   define U_ALIASING_BARRIER(ptr)
#endif

/**
 * char16_t * wrapper with implicit conversion from distinct but bit-compatible pointer types.
 * @stable ICU 59
 */
class U_COMMON_API Char16Ptr U_FINAL {
public:
    /**
     * Copies the pointer.
     * @param p pointer
     * @stable ICU 59
     */
    inline Char16Ptr(char16_t *p);
#if !U_CHAR16_IS_TYPEDEF
    /**
     * Converts the pointer to char16_t *.
     * @param p pointer to be converted
     * @stable ICU 59
     */
    inline Char16Ptr(uint16_t *p);
#endif
#if U_SIZEOF_WCHAR_T==2 || defined(U_IN_DOXYGEN)
    /**
     * Converts the pointer to char16_t *.
     * (Only defined if U_SIZEOF_WCHAR_T==2.)
     * @param p pointer to be converted
     * @stable ICU 59
     */
    inline Char16Ptr(wchar_t *p);
#endif
    /**
     * nullptr constructor.
     * @param p nullptr
     * @stable ICU 59
     */
    inline Char16Ptr(std::nullptr_t p);
    /**
     * Destructor.
     * @stable ICU 59
     */
    inline ~Char16Ptr();

/**
     * Pointer access.
     * @return the wrapped pointer
     * @stable ICU 59
     */
    inline char16_t *get() const;
    /**
     * char16_t pointer access via type conversion (e.g., static_cast).
     * @return the wrapped pointer
     * @stable ICU 59
     */
    inline operator char16_t *() const { return get(); }

private:
    Char16Ptr() = delete;

#ifdef U_ALIASING_BARRIER
    template<typename T> static char16_t *cast(T *t) {
        U_ALIASING_BARRIER(t);
        return reinterpret_cast<char16_t *>(t);
    }

char16_t *p_;
#else
    union {
        char16_t *cp;
        uint16_t *up;
        wchar_t *wp;
    } u_;
#endif
};

/// \cond
#ifdef U_ALIASING_BARRIER

Char16Ptr::Char16Ptr(char16_t *p) : p_(p) {}
#if !U_CHAR16_IS_TYPEDEF
Char16Ptr::Char16Ptr(uint16_t *p) : p_(cast(p)) {}
#endif
#if U_SIZEOF_WCHAR_T==2
Char16Ptr::Char16Ptr(wchar_t *p) : p_(cast(p)) {}
#endif
Char16Ptr::Char16Ptr(std::nullptr_t p) : p_(p) {}
Char16Ptr::~Char16Ptr() {
    U_ALIASING_BARRIER(p_);
}

char16_t *Char16Ptr::get() const { return p_; }

#else

Char16Ptr::Char16Ptr(char16_t *p) { u_.cp = p; }
#if !U_CHAR16_IS_TYPEDEF
Char16Ptr::Char16Ptr(uint16_t *p) { u_.up = p; }
#endif
#if U_SIZEOF_WCHAR_T==2
Char16Ptr::Char16Ptr(wchar_t *p) { u_.wp = p; }
#endif
Char16Ptr::Char16Ptr(std::nullptr_t p) { u_.cp = p; }
Char16Ptr::~Char16Ptr() {}

char16_t *Char16Ptr::get() const { return u_.cp; }

#endif
/// \endcond

/**
 * const char16_t * wrapper with implicit conversion from distinct but bit-compatible pointer types.
 * @stable ICU 59
 */
class U_COMMON_API ConstChar16Ptr U_FINAL {
public:
    /**
     * Copies the pointer.
     * @param p pointer
     * @stable ICU 59
     */
    inline ConstChar16Ptr(const char16_t *p);
#if !U_CHAR16_IS_TYPEDEF
    /**
     * Converts the pointer to char16_t *.
     * @param p pointer to be converted
     * @stable ICU 59
     */
    inline ConstChar16Ptr(const uint16_t *p);
#endif
#if U_SIZEOF_WCHAR_T==2 || defined(U_IN_DOXYGEN)
    /**
     * Converts the pointer to char16_t *.
     * (Only defined if U_SIZEOF_WCHAR_T==2.)
     * @param p pointer to be converted
     * @stable ICU 59
     */
    inline ConstChar16Ptr(const wchar_t *p);
#endif
    /**
     * nullptr constructor.
     * @param p nullptr
     * @stable ICU 59
     */
    inline ConstChar16Ptr(const std::nullptr_t p);

/**
     * Destructor.
     * @stable ICU 59
     */
    inline ~ConstChar16Ptr();

/**
     * Pointer access.
     * @return the wrapped pointer
     * @stable ICU 59
     */
    inline const char16_t *get() const;
    /**
     * char16_t pointer access via type conversion (e.g., static_cast).
     * @return the wrapped pointer
     * @stable ICU 59
     */
    inline operator const char16_t *() const { return get(); }

private:
    ConstChar16Ptr() = delete;

#ifdef U_ALIASING_BARRIER
    template<typename T> static const char16_t *cast(const T *t) {
        U_ALIASING_BARRIER(t);
        return reinterpret_cast<const char16_t *>(t);
    }

const char16_t *p_;
#else
    union {
        const char16_t *cp;
        const uint16_t *up;
        const wchar_t *wp;
    } u_;
#endif
};

/// \cond
#ifdef U_ALIASING_BARRIER

ConstChar16Ptr::ConstChar16Ptr(const char16_t *p) : p_(p) {}
#if !U_CHAR16_IS_TYPEDEF
ConstChar16Ptr::ConstChar16Ptr(const uint16_t *p) : p_(cast(p)) {}
#endif
#if U_SIZEOF_WCHAR_T==2
ConstChar16Ptr::ConstChar16Ptr(const wchar_t *p) : p_(cast(p)) {}
#endif
ConstChar16Ptr::ConstChar16Ptr(const std::nullptr_t p) : p_(p) {}
ConstChar16Ptr::~ConstChar16Ptr() {
    U_ALIASING_BARRIER(p_);
}

const char16_t *ConstChar16Ptr::get() const { return p_; }

#else

ConstChar16Ptr::ConstChar16Ptr(const char16_t *p) { u_.cp = p; }
#if !U_CHAR16_IS_TYPEDEF
ConstChar16Ptr::ConstChar16Ptr(const uint16_t *p) { u_.up = p; }
#endif
#if U_SIZEOF_WCHAR_T==2
ConstChar16Ptr::ConstChar16Ptr(const wchar_t *p) { u_.wp = p; }
#endif
ConstChar16Ptr::ConstChar16Ptr(const std::nullptr_t p) { u_.cp = p; }
ConstChar16Ptr::~ConstChar16Ptr() {}

const char16_t *ConstChar16Ptr::get() const { return u_.cp; }

#endif
/// \endcond

/**
 * Converts from const char16_t * to const UChar *.
 * Includes an aliasing barrier if available.
 * @param p pointer
 * @return p as const UChar *
 * @stable ICU 59
 */
inline const UChar *toUCharPtr(const char16_t *p) {
#ifdef U_ALIASING_BARRIER
    U_ALIASING_BARRIER(p);
#endif
    return reinterpret_cast<const UChar *>(p);
}

/**
 * Converts from char16_t * to UChar *.
 * Includes an aliasing barrier if available.
 * @param p pointer
 * @return p as UChar *
 * @stable ICU 59
 */
inline UChar *toUCharPtr(char16_t *p) {
#ifdef U_ALIASING_BARRIER
    U_ALIASING_BARRIER(p);
#endif
    return reinterpret_cast<UChar *>(p);
}

/**
 * Converts from const char16_t * to const OldUChar *.
 * Includes an aliasing barrier if available.
 * @param p pointer
 * @return p as const OldUChar *
 * @stable ICU 59
 */
inline const OldUChar *toOldUCharPtr(const char16_t *p) {
#ifdef U_ALIASING_BARRIER
    U_ALIASING_BARRIER(p);
#endif
    return reinterpret_cast<const OldUChar *>(p);
}

/**
 * Converts from char16_t * to OldUChar *.
 * Includes an aliasing barrier if available.
 * @param p pointer
 * @return p as OldUChar *
 * @stable ICU 59
 */
inline OldUChar *toOldUCharPtr(char16_t *p) {
#ifdef U_ALIASING_BARRIER
    U_ALIASING_BARRIER(p);
#endif
    return reinterpret_cast<OldUChar *>(p);
}

U_NAMESPACE_END

#endif /* U_SHOW_CPLUSPLUS_API */

#endif  // __CHAR16PTR_H__

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