#include <hikogui/unicode/grapheme.hpp>

Public Types
using	value_type = uint64_t

Public Member Functions
constexpr	grapheme (grapheme const &) noexcept=default

constexpr	grapheme (grapheme &&) noexcept=default

constexpr grapheme &	operator= (grapheme const &) noexcept=default

constexpr grapheme &	operator= (grapheme &&) noexcept=default

constexpr	grapheme (char32_t code_point) noexcept
	Encode a single code-point.

constexpr grapheme &	operator= (char32_t code_point) noexcept
	Encode a single code-point.

constexpr	grapheme (char code_point) noexcept
	Encode a single code-point.

constexpr grapheme &	operator= (char code_point) noexcept
	Encode a single code-point.

	grapheme (std::u32string_view code_points) noexcept
	Encode a grapheme from a list of code-points.

grapheme &	operator= (std::u32string_view code_points) noexcept
	Encode a grapheme from a list of code-points.

constexpr void	clear () noexcept
	Clear the grapheme.

constexpr bool	empty () const noexcept
	Check if the grapheme is empty.

constexpr	operator bool () const noexcept
	Check if the grapheme holds any code-points.

bool	valid () const noexcept
	Check if the grapheme is valid.

constexpr std::size_t	size () const noexcept
	Return the number of code-points encoded in the grapheme.

constexpr bool	overlong () const noexcept
	Check if the grapheme was initialized with more than 4 combining characters.

constexpr char32_t	operator[] (size_t i) const noexcept
	Get the code-point at the given index.

constexpr std::u32string	composed () const noexcept
	Get a list of code-point normalized to NFC.

std::u32string	decomposed () const noexcept
	Get a list of code-point normalized to NFD.

Static Public Member Functions
static grapheme	from_composed (std::u32string_view code_points) noexcept
	Encode a grapheme from a list of NFKC-normalized code-points.

static constexpr grapheme	eof () noexcept
	Create empty grapheme / end-of-file.

Data Fields
value_type	value
	[63:43] Starter code-point 0.

Friends
template<size_t I>
constexpr char32_t	get (grapheme const &rhs) noexcept
	Get the code-point at the given index.

constexpr bool	operator== (grapheme const &a, grapheme const &b) noexcept=default
	Compare equivalence of two graphemes.

constexpr std::strong_ordering	operator<=> (grapheme const &a, grapheme const &b) noexcept=default
	Compare two graphemes lexicographically.

constexpr bool	operator== (grapheme const &lhs, char32_t const &rhs) noexcept

constexpr std::strong_ordering	operator<=> (grapheme const &lhs, char32_t const &rhs) noexcept

constexpr bool	operator== (grapheme const &lhs, char const &rhs) noexcept

constexpr std::strong_ordering	operator<=> (grapheme const &lhs, char const &rhs) noexcept

std::string	to_string (grapheme const &rhs) noexcept

std::u32string	to_u32string (grapheme const &rhs) noexcept

Detailed Description

A grapheme, what a user thinks a character is.

This class will hold:

empty/eof (no code points encoded at all, the value 0)
U+0000 (value 1)
1 starter code-point, followed by 0-4 combining characters.

A grapheme should not include typographical ligatures such as 'fi' as the font should handle creating ligatures.

If a grapheme is initialized with more than 4 combining characters the extra combining characters are dropped and can be detected by calling overlong().

This class is trivial and constant-destructible so that it can be used as a character class in std::basic_string and used as a non-type template parameter.

Constructor & Destructor Documentation

◆ grapheme() [1/3]

constexpr v1::grapheme::grapheme ( char32_t code_point )

inlineexplicitconstexprnoexcept

Encode a single code-point.

◆ grapheme() [2/3]

constexpr v1::grapheme::grapheme ( char code_point )

inlineexplicitconstexprnoexcept

Encode a single code-point.

◆ grapheme() [3/3]

v1::grapheme::grapheme ( std::u32string_view code_points )

explicitnoexcept

Encode a grapheme from a list of code-points.

Parameters

code_points The non-normalized list of code-points.

Member Function Documentation

◆ clear()

constexpr void v1::grapheme::clear ( )

inlineconstexprnoexcept

Clear the grapheme.

◆ composed()

constexpr std::u32string v1::grapheme::composed ( ) const

inlineconstexprnoexcept

Get a list of code-point normalized to NFC.

◆ decomposed()

std::u32string v1::grapheme::decomposed ( ) const

noexcept

Get a list of code-point normalized to NFD.

◆ empty()

constexpr bool v1::grapheme::empty ( ) const

inlineconstexprnoexcept

Check if the grapheme is empty.

◆ eof()

static constexpr grapheme v1::grapheme::eof ( )

inlinestaticconstexprnoexcept

Create empty grapheme / end-of-file.

◆ from_composed()

static grapheme v1::grapheme::from_composed ( std::u32string_view code_points )

staticnoexcept

Encode a grapheme from a list of NFKC-normalized code-points.

Parameters

code_points The NFKC-normalized list of code-points.

◆ operator bool()

constexpr v1::grapheme::operator bool ( ) const

inlineconstexprnoexcept

Check if the grapheme holds any code-points.

◆ operator=() [1/3]

constexpr grapheme & v1::grapheme::operator= ( char code_point )

inlineconstexprnoexcept

Encode a single code-point.

◆ operator=() [2/3]

constexpr grapheme & v1::grapheme::operator= ( char32_t code_point )

inlineconstexprnoexcept

Encode a single code-point.

◆ operator=() [3/3]

grapheme & v1::grapheme::operator= ( std::u32string_view code_points )

noexcept

Encode a grapheme from a list of code-points.

Parameters

code_points The non-normalized list of code-points.

◆ operator[]()

constexpr char32_t v1::grapheme::operator[] ( size_t i ) const

inlineconstexprnoexcept

Get the code-point at the given index.

Note: It is undefined-behavior to index beyond the number of encoded code-points.

Parameters

i	Index of code-point in the grapheme.

Returns: code-point at the given index.

◆ overlong()

constexpr bool v1::grapheme::overlong ( ) const

inlineconstexprnoexcept

Check if the grapheme was initialized with more than 4 combining characters.

◆ size()

constexpr std::size_t v1::grapheme::size ( ) const

inlineconstexprnoexcept

Return the number of code-points encoded in the grapheme.

◆ valid()

bool v1::grapheme::valid ( ) const

noexcept

Check if the grapheme is valid.

A grapheme is invalid in case:

The grapheme is empty.
The first code-point is part of general category 'C'.
The first code-point is a combining character; canonical combining class != 0.

Friends And Related Symbol Documentation

◆ get

template<size_t I>

constexpr char32_t get ( grapheme const & rhs )

friend

Get the code-point at the given index.

Note: It is undefined-behavior to index beyond the number of encoded code-points.

Template Parameters

I	Index of code-point in the grapheme.

Parameters

rhs	The grapheme to query.

Returns: code-point at the given index.

◆ operator<=>

constexpr std::strong_ordering operator<=>	(	grapheme const &	a,
		grapheme const &	b )

friend

Compare two graphemes lexicographically.

◆ operator==

constexpr bool operator==	(	grapheme const &	a,
		grapheme const &	b )

friend

Compare equivalence of two graphemes.

Field Documentation

◆ value

value_type v1::grapheme::value

[63:43] Starter code-point 0.

[42:33] Non-starter code 1 [32:23] Non-starter code 2 [22:13] Non-starter code 3 [12: 3] Non-starter code 4 [ 2: 0] Length 0-5, 6 == overlong, 7 == reserved.

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

hikogui/src/hikogui/unicode/grapheme.hpp

Public Types

Public Member Functions

Static Public Member Functions

Data Fields

Friends

Detailed Description

Constructor & Destructor Documentation

◆ grapheme() [1/3]

◆ grapheme() [2/3]

◆ grapheme() [3/3]

Member Function Documentation

◆ clear()

◆ composed()

◆ decomposed()

◆ empty()

◆ eof()

◆ from_composed()

◆ operator bool()

◆ operator=() [1/3]

◆ operator=() [2/3]

◆ operator=() [3/3]

◆ operator[]()

◆ overlong()

◆ size()

◆ valid()

Friends And Related Symbol Documentation

◆ get

◆ operator<=>

◆ operator==

Field Documentation

◆ value