#include <stddef.h>

Include dependency graph for utf8.h:

This graph shows which files directly or indirectly include this file:

Macros
#define	UTF8_CONTINUATION_BYTE(c)

Functions
int	UTF8_delete_char_at (char *s, int pos)
	Delete a whole (possibly multibyte) character from a string.
int	UTF8_insert_char_at (char *s, int n, int pos, int codepoint)
	Insert a (possibly multibyte) UTF-8 character into a string.
int	UTF8_char_len (unsigned char c)
	length of UTF-8 character starting with this byte.
int	UTF8_next (const char **str)
	Get the next utf-8 character from the given string.
int	UTF8_encoded_len (int codepoint)
size_t	UTF8_strlen (const char *str)
	Count the number of character (not the number of bytes) of a zero termination string.
int	UTF8_char_offset_to_byte_offset (char *str, int pos)
	Convert UTF-8 character offset to a byte offset in the given string.
char *	UTF8_strncpyz (char dest, const char src, size_t limit)
	UTF8 capable string copy function.

Macro Definition Documentation

◆ UTF8_CONTINUATION_BYTE

#define UTF8_CONTINUATION_BYTE ( c )

Value:

(((c) & 0xc0) == 0x80)

Is this the second or later byte of a multibyte UTF-8 character?

Definition at line 35 of file utf8.h.

Referenced by Com_sprintf(), R_FontFindFit(), R_FontFindTruncFit(), R_FontMakeChunks(), UTF8_delete_char_at(), UTF8_next(), and UTF8_strncpyz().

Function Documentation

◆ UTF8_char_len()

int UTF8_char_len ( unsigned char c )

length of UTF-8 character starting with this byte.

Returns: length of character encoding, or 0 if not start of a UTF-8 sequence

Todo: Using this does not solve the truncation problem in case of decomposed characters. For example a code for "a" followed by a code for "put dots above previous character: the "a" will be reported as a character of length 1 by this function, even though the code that follows is part of its visual appearance and should not be cut off separately. Fortunately decomposed characters are rarely used.

Definition at line 109 of file utf8.cpp.

Referenced by Com_sprintf(), Con_Print(), R_FontMakeChunks(), UTF8_char_offset_to_byte_offset(), UTF8_strlen(), and UTF8_strncpyz().

◆ UTF8_char_offset_to_byte_offset()

int UTF8_char_offset_to_byte_offset	(	char *	str,
		int	pos )

Convert UTF-8 character offset to a byte offset in the given string.

Parameters

[in]	str	Start of the string
[in]	pos	UTF-8 character offset from the start

Returns: offset of the first byte of the UTF-8 character at that offset

Note: If there aren't enough UTF-8 characters, returns the offset of the NULL terminator.

See also: UTF8_char_len

Definition at line 227 of file utf8.cpp.

References UTF8_char_len().

Referenced by TEST_F(), UTF8_delete_char_at(), and UTF8_insert_char_at().

◆ UTF8_delete_char_at()

int UTF8_delete_char_at	(	char *	s,
		int	pos )

Delete a whole (possibly multibyte) character from a string.

Parameters

[in]	s	Start of the string
[in]	pos	UTF-8 char offset from the start (not the byte offset)

Returns: Number of bytes deleted

Definition at line 35 of file utf8.cpp.

References UTF8_char_offset_to_byte_offset(), and UTF8_CONTINUATION_BYTE.

Referenced by TEST_F(), and UI_TextEntryNodeEdit().

◆ UTF8_encoded_len()

int UTF8_encoded_len ( int c )

Calculate how long a Unicode code point (such as returned by SDL key events in unicode mode) would be in UTF-8 encoding.

Definition at line 188 of file utf8.cpp.

Referenced by IN_TranslateKey(), UI_TextEntryNodeEdit(), and UTF8_insert_char_at().

◆ UTF8_insert_char_at()

int UTF8_insert_char_at	(	char *	s,
		int	n,
		int	pos,
		int	c )

Insert a (possibly multibyte) UTF-8 character into a string.

Parameters

[in]	s	Start of the string
[in]	n	Buffer size of the string
[in]	pos	UTF-8 char offset from the start (not the byte offset)
[in]	c	Unicode code as 32-bit integer