ujson_utf.h File Reference

Unicode helper macros and functions. More...

#include <stdint.h>
#include <stddef.h>

Go to the source code of this file.

Macros
#define	UJSON_UTF8_IS_ASCII(ch)   (!((ch) & 0x80))
#define	UJSON_UTF8_IS_NBYTE(ch)   (((ch) & 0xc0) == 0x80)
#define	UJSON_UTF8_IS_2BYTE(ch)   (((ch) & 0xe0) == 0xc0)
#define	UJSON_UTF8_IS_3BYTE(ch)   (((ch) & 0xf0) == 0xe0)
#define	UJSON_UTF8_IS_4BYTE(ch)   (((ch) & 0xf8) == 0xf0)

Functions
static uint32_t	ujson_utf8_next (const char **str)
	Parses next unicode character in UTF-8 string. More...
int8_t	ujson_utf8_next_chsz (const char *str, size_t off)
	Returns number of bytes next character is occupying in an UTF-8 string. More...
int8_t	ujson_utf8_prev_chsz (const char *str, size_t off)
	Returns number of bytes previous character is occupying in an UTF-8 string. More...
size_t	ujson_utf8_strlen (const char *str)
	Returns a number of characters in UTF-8 string. More...
static unsigned int	ujson_utf8_bytes (uint32_t unicode)
	Returns a number of bytes needed to store unicode character into UTF-8. More...
static int	ujson_to_utf8 (uint32_t unicode, char *buf)
	Writes an unicode character into a UTF-8 buffer. More...

Detailed Description

Unicode helper macros and functions.

Definition in file ujson_utf.h.

Macro Definition Documentation

UJSON_UTF8_IS_2BYTE

#define UJSON_UTF8_IS_2BYTE

(

ch

)

(((ch) & 0xe0) == 0xc0)

Returns true if we have first unicode byte of two byte sequence

Definition at line 22 of file ujson_utf.h.

UJSON_UTF8_IS_3BYTE

#define UJSON_UTF8_IS_3BYTE

(

ch

)

(((ch) & 0xf0) == 0xe0)

Returns true if we have first unicode byte of three byte sequence

Definition at line 24 of file ujson_utf.h.

UJSON_UTF8_IS_4BYTE

#define UJSON_UTF8_IS_4BYTE

(

ch

)

(((ch) & 0xf8) == 0xf0)

Returns true if we have first unicode byte of four byte sequence

Definition at line 26 of file ujson_utf.h.

UJSON_UTF8_IS_ASCII

#define UJSON_UTF8_IS_ASCII

(

ch

)

(!((ch) & 0x80))

Returns true if unicode byte is ASCII

Definition at line 18 of file ujson_utf.h.

UJSON_UTF8_IS_NBYTE

#define UJSON_UTF8_IS_NBYTE

(

ch

)

(((ch) & 0xc0) == 0x80)

Returns true if we have first unicode byte of single byte sequence

Definition at line 20 of file ujson_utf.h.

Function Documentation

ujson_to_utf8()

static int ujson_to_utf8 ( uint32_t  unicode, char *  buf  )

inlinestatic

Writes an unicode character into a UTF-8 buffer.

The buffer must be large enough!

Parameters

unicode	A unicode character.
buf	A byte buffer.

Returns

A number of bytes written.

Definition at line 141 of file ujson_utf.h.

ujson_utf8_bytes()

static unsigned int ujson_utf8_bytes ( uint32_t  unicode )

inlinestatic

Returns a number of bytes needed to store unicode character into UTF-8.

Parameters

unicode

A unicode character.

Returns

Number of utf8 bytes required to store a unicode character.

Definition at line 118 of file ujson_utf.h.

ujson_utf8_next()

static uint32_t ujson_utf8_next ( const char **  str )

inlinestatic

Parses next unicode character in UTF-8 string.

Parameters

str	A pointer to the C string.

Returns

A unicode character or 0 on error or end of the string.

Definition at line 35 of file ujson_utf.h.

References UJSON_UTF8_IS_ASCII, and UJSON_UTF8_IS_NBYTE.

ujson_utf8_next_chsz()

int8_t ujson_utf8_next_chsz	(	const char *	str,
		size_t	off
	)

Returns number of bytes next character is occupying in an UTF-8 string.

Parameters

str	A pointer to a string.
off	An offset into the string, must point to a valid multibyte boundary.

Returns

Number of bytes next character occupies, zero on string end and -1 on failure.

ujson_utf8_prev_chsz()

int8_t ujson_utf8_prev_chsz	(	const char *	str,
		size_t	off
	)

Returns number of bytes previous character is occupying in an UTF-8 string.

Parameters

str	A pointer to a string.
off	An offset into the string, must point to a valid multibyte boundary.

Returns

Number of bytes previous character occupies, and -1 on failure.

ujson_utf8_strlen()

size_t ujson_utf8_strlen

(

const char *

str

)

Returns a number of characters in UTF-8 string.

Returns number of characters in an UTF-8 string, which may be less or equal to what strlen() reports.

Parameters

str	An UTF-8 string.

Returns

Number of characters in the string.