UTF16< CharType >

UTF-16 encoding. More...

#include <encodings.h>

Inheritance diagram for UTF16< CharType >:

Collaboration diagram for UTF16< CharType >:

Public Types
enum	{ supportUnicode = 1 }
typedef CharType	Ch

Public Member Functions
	RAPIDJSON_STATIC_ASSERT (sizeof(Ch) >=2)

Static Public Member Functions
template<typename OutputStream >
static void	Encode (OutputStream &os, unsigned codepoint)
template<typename OutputStream >
static void	EncodeUnsafe (OutputStream &os, unsigned codepoint)
template<typename InputStream >
static bool	Decode (InputStream &is, unsigned *codepoint)
template<typename InputStream , typename OutputStream >
static bool	Validate (InputStream &is, OutputStream &os)

Detailed Description

template<typename CharType = wchar_t>
struct UTF16< CharType >

UTF-16 encoding.

http://en.wikipedia.org/wiki/UTF-16 http://tools.ietf.org/html/rfc2781

Template Parameters

CharType

Type for storing 16-bit UTF-16 data. Default is wchar_t. C++11 may use char16_t instead.

Note

implements Encoding concept

For in-memory access, no need to concern endianness. The code units and code points are represented by CPU's endianness. For streaming, use UTF16LE and UTF16BE, which handle endianness.

Definition at line 269 of file encodings.h.

Member Typedef Documentation

Ch

typedef CharType Ch

Definition at line 270 of file encodings.h.

Member Enumeration Documentation

anonymous enum

anonymous enum

Enumerator
supportUnicode

Definition at line 273 of file encodings.h.

{ supportUnicode = 1 };

Member Function Documentation

Decode()

static bool Decode ( InputStream &  is, unsigned *  codepoint  )

inlinestatic

Definition at line 307 of file encodings.h.

                                                             {
        RAPIDJSON_STATIC_ASSERT(sizeof(typename InputStream::Ch) >= 2);
        typename InputStream::Ch c = is.Take();
        if (c < 0xD800 || c > 0xDFFF) {
            *codepoint = static_cast<unsigned>(c);
            return true;
        }
        else if (c <= 0xDBFF) {
            *codepoint = (static_cast<unsigned>(c) & 0x3FF) << 10;
            c = is.Take();
            *codepoint |= (static_cast<unsigned>(c) & 0x3FF);
            *codepoint += 0x10000;
            return c >= 0xDC00 && c <= 0xDFFF;
        }
        return false;
    }

Encode()

static void Encode ( OutputStream &  os, unsigned  codepoint  )

inlinestatic

Definition at line 276 of file encodings.h.

                                                             {
        RAPIDJSON_STATIC_ASSERT(sizeof(typename OutputStream::Ch) >= 2);
        if (codepoint <= 0xFFFF) {
            RAPIDJSON_ASSERT(codepoint < 0xD800 || codepoint > 0xDFFF); // Code point itself cannot be surrogate pair 
            os.Put(static_cast<typename OutputStream::Ch>(codepoint));
        }
        else {
            RAPIDJSON_ASSERT(codepoint <= 0x10FFFF);
            unsigned v = codepoint - 0x10000;
            os.Put(static_cast<typename OutputStream::Ch>((v >> 10) | 0xD800));
            os.Put(static_cast<typename OutputStream::Ch>((v & 0x3FF) | 0xDC00));
        }
    }

EncodeUnsafe()

static void EncodeUnsafe ( OutputStream &  os, unsigned  codepoint  )

inlinestatic

Definition at line 292 of file encodings.h.

                                                                   {
        RAPIDJSON_STATIC_ASSERT(sizeof(typename OutputStream::Ch) >= 2);
        if (codepoint <= 0xFFFF) {
            RAPIDJSON_ASSERT(codepoint < 0xD800 || codepoint > 0xDFFF); // Code point itself cannot be surrogate pair 
            PutUnsafe(os, static_cast<typename OutputStream::Ch>(codepoint));
        }
        else {
            RAPIDJSON_ASSERT(codepoint <= 0x10FFFF);
            unsigned v = codepoint - 0x10000;
            PutUnsafe(os, static_cast<typename OutputStream::Ch>((v >> 10) | 0xD800));
            PutUnsafe(os, static_cast<typename OutputStream::Ch>((v & 0x3FF) | 0xDC00));
        }
    }

Here is the call graph for this function:

RAPIDJSON_STATIC_ASSERT()

RAPIDJSON_STATIC_ASSERT

(

sizeof(Ch) >=

2

)

Validate()

static bool Validate ( InputStream &  is, OutputStream &  os  )

inlinestatic

Definition at line 325 of file encodings.h.

                                                            {
        RAPIDJSON_STATIC_ASSERT(sizeof(typename InputStream::Ch) >= 2);
        RAPIDJSON_STATIC_ASSERT(sizeof(typename OutputStream::Ch) >= 2);
        typename InputStream::Ch c;
        os.Put(static_cast<typename OutputStream::Ch>(c = is.Take()));
        if (c < 0xD800 || c > 0xDFFF)
            return true;
        else if (c <= 0xDBFF) {
            os.Put(c = is.Take());
            return c >= 0xDC00 && c <= 0xDFFF;
        }
        return false;
    }

---

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

• rapidjson/encodings.h