CCL 0.1 Beta API Reference - Unicode Package

Table of Contents

Classes

bool_format
by_code_point
floating_point_format
integer_format
invalid_code_point
invalid_radix
invalid_unicode_encoding
iterated_past_end
parse_failed

Free Functions

template <
    unicode_string InputString
>
std::string
to_string (
    const InputString& s
)

Converts the given string to a std::string.

Parameters:
  • s:
std::u16string
to_u16string (
    const std::string& s
)

Converts the given string to a std::u16string.

Parameters:
  • s:
template <
    unicode_string InputString
>
std::u16string
to_u16string (
    const InputString& s
)

Converts the given string to a std::u16string.

Parameters:
  • s:
std::u32string
to_u32string (
    const std::string& s
)

Converts the given string to a std::u32string.

Parameters:
  • s:
template <
    unicode_string InputString
>
std::u32string
to_u32string (
    const InputString& s
)

Converts the given string to a std::u32string.

Parameters:
  • s:
std::u8string
to_u8string (
    const std::string& s
)

Converts the given string to a std::u8string.

Parameters:
  • s:
template <
    unicode_string InputString
>
std::u8string
to_u8string (
    const InputString& s
)

Converts the given string to a std::u8string.

Parameters:
  • s:
template <
    raii_unicode_string OutputString,
    unicode_string InputString
>
OutputString
convert_string (
    const InputString& s
)

Converts the given string to the requested Unicode string type.

Parameters:
  • s:
template <
    raii_unicode_string Output
>
Output
format_bool (
    bool input,
    const bool_format& format
)

Formats the given bool value with the given bool format and returns the formatted string.

template <
    raii_unicode_string Output,
    std::floating_point Input
>
Output
format_floating_point (
    Input input,
    const floating_point_format& format
)

Formats the given floating point value with the given floating point format and returns the formatted string.

template <
    raii_unicode_string Output,
    std::integral Input
>
Output
format_integer (
    Input input,
    const integer_format& format
)

Formats the given integer value with the given integer format and returns the formatted string.

void
insert_code_point (
    std::u16string& s,
    char32_t code_point,
    std::u16string::size_type index
)

Inserts the given code point into the given string at the given index.

Parameters:
  • s:
  • code_point:

    The code point to insert.

  • index:

    The index of the string at which to insert the code point.

void
insert_code_point (
    std::u32string& s,
    char32_t code_point,
    std::u32string::size_type index
)

Inserts the given code point into the given string at the given index.

Parameters:
  • s:
  • code_point:

    The code point to insert.

  • index:

    The index of the string at which to insert the code point.

void
insert_code_point (
    std::u8string& s,
    char32_t code_point,
    std::u8string::size_type index
)

Inserts the given code point into the given string at the given index.

Parameters:
  • s:
  • code_point:

    The code point to insert.

  • index:

    The index of the string at which to insert the code point.

template <
    unicode_string Input
>
bool
parse_bool (
    Input input,
    const bool_format& format
)

Parses the input string and returns the corresponding boolean value. The input string is expected to conform to the given bool format. If it doesn't, a parse_failed exception is thrown.

template <
    std::floating_point Output,
    unicode_string Input
>
Output
parse_floating_point (
    const Input& input,
    const floating_point_format& format
)

Parses the input string and returns the corresponding floating point value. The input string is expected to conform to the given floating point format. If it doesn't, a parse_failed exception is thrown.

template <
    std::integral Output,
    unicode_string Input
>
Output
parse_integer (
    const Input& input,
    const integer_format& format
)

Parses the input string and returns the corresponding integer value. The input string is expected to conform to the given integer format. If it doesn't, a parse_failed exception is thrown.

std::size_t
string_size (
    const char* s
)
noexcept

Returns the number of characters in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const std::string& s
)
noexcept

Returns the number of characters in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const char16_t* s
)
noexcept

Returns the number of code units in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const char32_t* s
)
noexcept

Returns the number of code units in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const char8_t* s
)
noexcept

Returns the number of code units in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const std::u16string& s
)
noexcept

Returns the number of code units in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const std::u16string_view& s
)
noexcept

Returns the number of code units in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const std::u32string& s
)
noexcept

Returns the number of code units in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const std::u32string_view& s
)
noexcept

Returns the number of code units in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const std::u8string& s
)
noexcept

Returns the number of code units in the given string.

Parameters:
  • s:
std::size_t
string_size (
    const std::u8string_view& s
)
noexcept

Returns the number of code units in the given string.

Parameters:
  • s:
template <
    unicode_string ContentString,
    unicode_string Substring
>
bool
ends_with (
    const ContentString& content,
    const Substring& substring
)
noexcept

Returns true if the content strings ends with the contents of substring.

Parameters:
  • content:

    The string to look at the end of.

  • substring:

    The substring to look for.

template <
    unicode_string ContentString,
    unicode_string Substring
>
bool
starts_with (
    const ContentString& content,
    const Substring& substring
)
noexcept

Returns true if the content strings starts with the contents of substring.

Parameters:
  • content:

    The string to look at the start of.

  • substring:

    The substring to look for.

template <
    unicode_string InputString
>
typename by_code_point<value_type_t<InputString>>::const_iterator
validate_string (
    const InputString& s
)
noexcept

Validates the given string and returns a by_code_point constant iterator just past the last valid code point, which is the end iterator if the entire string is valid.

Parameters:
  • s:
constexpr
bool
is_surrogate (
    char16_t code_unit
)
noexcept

Returns true if the given UTF-16 code unit is a surrogate. Otherwise, returns false.

Parameters:
  • code_unit:

    The UTF-16 code unit to examine.

constexpr
bool
is_leading_surrogate (
    char16_t code_unit
)
noexcept

Returns true if the given UTF-16 code unit is a leading surrogate (meaning the first code unit of a surrogate pair). Otherwise, returns false.

Parameters:
  • code_unit:

    The UTF-16 code unit to examine.

constexpr
bool
is_trailing_surrogate (
    char16_t code_unit
)
noexcept

Returns true if the given UTF-16 code unit is a trailing surrogate (meaning the last code unit of a surrogate pair). Otherwise, returns false.

Parameters:
  • code_unit:

    The UTF-16 code unit to examine.

constexpr
bool
is_leading_byte (
    char8_t code_unit
)
noexcept

Returns true if the given UTF-8 code unit is a leading byte (meaning that it marks the beginning of a sequence of code units). Otherwise, returns false.

Parameters:
  • code_unit:

    The UTF-8 code unit to examine.

constexpr
bool
is_trailing_byte (
    char8_t code_unit
)
noexcept

Returns true if the given UTF-8 code unit is a trailing byte (meaning that it follows a leading byte). Otherwise, returns false.

Parameters:
  • code_unit:

    The UTF-8 code unit to examine.

constexpr
bool
is_standalone_byte (
    char8_t code_unit
)
noexcept

Returns true if the given UTF-8 code unit is standalone (meaning that it stands on its own and is not part of a sequence of code units). Otherwise, returns false.

Parameters:
  • code_unit:

    The UTF-8 code unit to examine.

constexpr
bool
is_radix_digit (
    char32_t character,
    unsigned int radix
)
noexcept

Returns true if the given character represents a digit in the number system with the given radix. Otherwise, returns false. For example, '7' is a valid base-8 digit, 'F' is a valid base-16 digit, 'G' is a valid base-17 digit, and so on.

Parameters:
  • character:

    The character (code point) to examine.

  • radix:

    The radix to consider.

constexpr
bool
is_code_point_valid (
    char32_t code_point
)
noexcept

Returns true if the given code point is valid. Otherwise, returns false.

Parameters:
  • code_point:

    The code point to examine.

constexpr
bool
fits_in_7_bits (
    char32_t code_point
)
noexcept

Returns true if the given code point fits in 7 bits. Otherwise, returns false.

Parameters:
  • code_point:

    The code point to examine.

constexpr
bool
is_whitespace (
    char32_t code_point
)
noexcept

Returns true if the given code point represents a whitespace character, and false if it does not.

Parameters:
  • code_point:

    The code point to examine.

Copyright © 2022-2025 Daniel T. McGinnis

CCL was first published in 2022, and is still actively maintained.

This website was first published in 2022, and is still actively maintained.

This specific web page was first published in 2022.