Module `std::ascii`

The <code>ASCII</code> module defines basic string and char newtypes in Move that verify that characters are valid ASCII, and that strings consist of only valid ASCII characters.

Struct String
Struct Char
Constants
Function char
Function string
Function try_string
Function all_characters_printable
Function push_char
Function pop_char
Function length
Function append
Function insert
Function substring
Function as_bytes
Function into_bytes
Function byte
Function is_valid_char
Function is_printable_char
Function is_empty
Function to_uppercase
Function to_lowercase
Function index_of
Function char_to_uppercase
Function char_to_lowercase

<pre><code>use <a href="../std/option.md#std_option">std::option</a>; use <a href="../std/vector.md#std_vector">std::vector</a>; </code></pre>

Struct `String`

The <code><a href="../std/ascii.md#std_ascii_String">String</a></code> struct holds a vector of bytes that all represent valid ASCII characters. Note that these ASCII characters may not all be printable. To determine if a <code><a href="../std/ascii.md#std_ascii_String">String</a></code> contains only "printable" characters you should use the <code><a href="../std/ascii.md#std_ascii_all_characters_printable">all_characters_printable</a></code> predicate defined in this module.

<pre><code>public struct <a href="../std/ascii.md#std_ascii_String">String</a> has copy, drop, store </code></pre> <details> <summary>Fields</summary> <dl> <dt> <code>bytes: <a href="../std/vector.md#std_vector">vector</a><<a href="../std/u8.md#std_u8">u8</a>></code> </dt> <dd> </dd> </dl> </details>

Struct `Char`

An ASCII character.

<pre><code>public struct <a href="../std/ascii.md#std_ascii_Char">Char</a> has copy, drop, store </code></pre> <details> <summary>Fields</summary> <dl> <dt> <code><a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/u8.md#std_u8">u8</a></code> </dt> <dd> </dd> </dl> </details>

Constants

An invalid ASCII character was encountered when creating an ASCII string.

<pre><code>const <a href="../std/ascii.md#std_ascii_EInvalidASCIICharacter">EInvalidASCIICharacter</a>: <a href="../std/u64.md#std_u64">u64</a> = 65536; </code></pre>

An invalid index was encountered when creating a substring.

<pre><code>const <a href="../std/ascii.md#std_ascii_EInvalidIndex">EInvalidIndex</a>: <a href="../std/u64.md#std_u64">u64</a> = 65537; </code></pre>

Function `char`

Convert a <code><a href="../std/ascii.md#std_ascii_byte">byte</a></code> into a <code><a href="../std/ascii.md#std_ascii_Char">Char</a></code> that is checked to make sure it is valid ASCII.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_char">char</a>(<a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/ascii.md#std_ascii_Char">std::ascii::Char</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_char">char</a>(<a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/ascii.md#std_ascii_Char">Char</a> { assert!(<a href="../std/ascii.md#std_ascii_is_valid_char">is_valid_char</a>(<a href="../std/ascii.md#std_ascii_byte">byte</a>), <a href="../std/ascii.md#std_ascii_EInvalidASCIICharacter">EInvalidASCIICharacter</a>); <a href="../std/ascii.md#std_ascii_Char">Char</a> { <a href="../std/ascii.md#std_ascii_byte">byte</a> } } </code></pre> </details>

Function `string`

Convert a vector of bytes <code>bytes</code> into an <code><a href="../std/ascii.md#std_ascii_String">String</a></code>. Aborts if <code>bytes</code> contains non-ASCII characters.

<pre><code>public fun <a href="../std/string.md#std_string">string</a>(bytes: <a href="../std/vector.md#std_vector">vector</a><<a href="../std/u8.md#std_u8">u8</a>>): <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/string.md#std_string">string</a>(bytes: <a href="../std/vector.md#std_vector">vector</a><<a href="../std/u8.md#std_u8">u8</a>>): <a href="../std/ascii.md#std_ascii_String">String</a> { let x = <a href="../std/ascii.md#std_ascii_try_string">try_string</a>(bytes); assert!(x.is_some(), <a href="../std/ascii.md#std_ascii_EInvalidASCIICharacter">EInvalidASCIICharacter</a>); x.destroy_some() } </code></pre> </details>

Function `try_string`

Convert a vector of bytes <code>bytes</code> into an <code><a href="../std/ascii.md#std_ascii_String">String</a></code>. Returns <code>Some(<ascii_string>)</code> if the <code>bytes</code> contains all valid ASCII characters. Otherwise returns <code>None</code>.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_try_string">try_string</a>(bytes: <a href="../std/vector.md#std_vector">vector</a><<a href="../std/u8.md#std_u8">u8</a>>): <a href="../std/option.md#std_option_Option">std::option::Option</a><<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_try_string">try_string</a>(bytes: <a href="../std/vector.md#std_vector">vector</a><<a href="../std/u8.md#std_u8">u8</a>>): Option<<a href="../std/ascii.md#std_ascii_String">String</a>> { let is_valid = bytes.all!(|<a href="../std/ascii.md#std_ascii_byte">byte</a>| <a href="../std/ascii.md#std_ascii_is_valid_char">is_valid_char</a>(*<a href="../std/ascii.md#std_ascii_byte">byte</a>)); if (is_valid) <a href="../std/option.md#std_option_some">option::some</a>(<a href="../std/ascii.md#std_ascii_String">String</a> { bytes }) else <a href="../std/option.md#std_option_none">option::none</a>() } </code></pre> </details>

Function `all_characters_printable`

Returns <code>true</code> if all characters in <code><a href="../std/string.md#std_string">string</a></code> are printable characters Returns <code>false</code> otherwise. Not all <code><a href="../std/ascii.md#std_ascii_String">String</a></code>s are printable strings.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_all_characters_printable">all_characters_printable</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>): <a href="../std/bool.md#std_bool">bool</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_all_characters_printable">all_characters_printable</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">String</a>): <a href="../std/bool.md#std_bool">bool</a> { <a href="../std/string.md#std_string">string</a>.bytes.all!(|<a href="../std/ascii.md#std_ascii_byte">byte</a>| <a href="../std/ascii.md#std_ascii_is_printable_char">is_printable_char</a>(*<a href="../std/ascii.md#std_ascii_byte">byte</a>)) } </code></pre> </details>

Function `push_char`

Push a <code><a href="../std/ascii.md#std_ascii_Char">Char</a></code> to the end of the <code><a href="../std/string.md#std_string">string</a></code>.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_push_char">push_char</a>(<a href="../std/string.md#std_string">string</a>: &mut <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>, <a href="../std/ascii.md#std_ascii_char">char</a>: <a href="../std/ascii.md#std_ascii_Char">std::ascii::Char</a>) </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_push_char">push_char</a>(<a href="../std/string.md#std_string">string</a>: &mut <a href="../std/ascii.md#std_ascii_String">String</a>, <a href="../std/ascii.md#std_ascii_char">char</a>: <a href="../std/ascii.md#std_ascii_Char">Char</a>) { <a href="../std/string.md#std_string">string</a>.bytes.push_back(<a href="../std/ascii.md#std_ascii_char">char</a>.<a href="../std/ascii.md#std_ascii_byte">byte</a>); } </code></pre> </details>

Function `pop_char`

Pop a <code><a href="../std/ascii.md#std_ascii_Char">Char</a></code> from the end of the <code><a href="../std/string.md#std_string">string</a></code>.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_pop_char">pop_char</a>(<a href="../std/string.md#std_string">string</a>: &mut <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>): <a href="../std/ascii.md#std_ascii_Char">std::ascii::Char</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_pop_char">pop_char</a>(<a href="../std/string.md#std_string">string</a>: &mut <a href="../std/ascii.md#std_ascii_String">String</a>): <a href="../std/ascii.md#std_ascii_Char">Char</a> { <a href="../std/ascii.md#std_ascii_Char">Char</a> { <a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/string.md#std_string">string</a>.bytes.pop_back() } } </code></pre> </details>

Function `length`

Returns the length of the <code><a href="../std/string.md#std_string">string</a></code> in bytes.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_length">length</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>): <a href="../std/u64.md#std_u64">u64</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_length">length</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">String</a>): <a href="../std/u64.md#std_u64">u64</a> { <a href="../std/string.md#std_string">string</a>.<a href="../std/ascii.md#std_ascii_as_bytes">as_bytes</a>().<a href="../std/ascii.md#std_ascii_length">length</a>() } </code></pre> </details>

Function `append`

Append the <code>other</code> string to the end of <code><a href="../std/string.md#std_string">string</a></code>.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_append">append</a>(<a href="../std/string.md#std_string">string</a>: &mut <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>, other: <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>) </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_append">append</a>(<a href="../std/string.md#std_string">string</a>: &mut <a href="../std/ascii.md#std_ascii_String">String</a>, other: <a href="../std/ascii.md#std_ascii_String">String</a>) { <a href="../std/string.md#std_string">string</a>.bytes.<a href="../std/ascii.md#std_ascii_append">append</a>(other.<a href="../std/ascii.md#std_ascii_into_bytes">into_bytes</a>()) } </code></pre> </details>

Function `insert`

Insert the <code>other</code> string at the <code>at</code> index of <code><a href="../std/string.md#std_string">string</a></code>.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_insert">insert</a>(s: &mut <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>, at: <a href="../std/u64.md#std_u64">u64</a>, o: <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>) </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_insert">insert</a>(s: &mut <a href="../std/ascii.md#std_ascii_String">String</a>, at: <a href="../std/u64.md#std_u64">u64</a>, o: <a href="../std/ascii.md#std_ascii_String">String</a>) { assert!(at <= s.<a href="../std/ascii.md#std_ascii_length">length</a>(), <a href="../std/ascii.md#std_ascii_EInvalidIndex">EInvalidIndex</a>); o.<a href="../std/ascii.md#std_ascii_into_bytes">into_bytes</a>().destroy!(|e| s.bytes.<a href="../std/ascii.md#std_ascii_insert">insert</a>(e, at)); } </code></pre> </details>

Function `substring`

Copy the slice of the <code><a href="../std/string.md#std_string">string</a></code> from <code>i</code> to <code>j</code> into a new <code><a href="../std/ascii.md#std_ascii_String">String</a></code>.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_substring">substring</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>, i: <a href="../std/u64.md#std_u64">u64</a>, j: <a href="../std/u64.md#std_u64">u64</a>): <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_substring">substring</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">String</a>, i: <a href="../std/u64.md#std_u64">u64</a>, j: <a href="../std/u64.md#std_u64">u64</a>): <a href="../std/ascii.md#std_ascii_String">String</a> { assert!(i <= j && j <= <a href="../std/string.md#std_string">string</a>.<a href="../std/ascii.md#std_ascii_length">length</a>(), <a href="../std/ascii.md#std_ascii_EInvalidIndex">EInvalidIndex</a>); let mut bytes = <a href="../std/vector.md#std_vector">vector</a>[]; i.range_do!(j, |i| bytes.push_back(<a href="../std/string.md#std_string">string</a>.bytes[i])); <a href="../std/ascii.md#std_ascii_String">String</a> { bytes } } </code></pre> </details>

Function `as_bytes`

Get the inner bytes of the <code><a href="../std/string.md#std_string">string</a></code> as a reference

<pre><code>public fun <a href="../std/ascii.md#std_ascii_as_bytes">as_bytes</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>): &<a href="../std/vector.md#std_vector">vector</a><<a href="../std/u8.md#std_u8">u8</a>> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_as_bytes">as_bytes</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">String</a>): &<a href="../std/vector.md#std_vector">vector</a><<a href="../std/u8.md#std_u8">u8</a>> { &<a href="../std/string.md#std_string">string</a>.bytes } </code></pre> </details>

Function `into_bytes`

Unpack the <code><a href="../std/string.md#std_string">string</a></code> to get its backing bytes

<pre><code>public fun <a href="../std/ascii.md#std_ascii_into_bytes">into_bytes</a>(<a href="../std/string.md#std_string">string</a>: <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>): <a href="../std/vector.md#std_vector">vector</a><<a href="../std/u8.md#std_u8">u8</a>> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_into_bytes">into_bytes</a>(<a href="../std/string.md#std_string">string</a>: <a href="../std/ascii.md#std_ascii_String">String</a>): <a href="../std/vector.md#std_vector">vector</a><<a href="../std/u8.md#std_u8">u8</a>> { let <a href="../std/ascii.md#std_ascii_String">String</a> { bytes } = <a href="../std/string.md#std_string">string</a>; bytes } </code></pre> </details>

Function `byte`

Unpack the <code><a href="../std/ascii.md#std_ascii_char">char</a></code> into its underlying bytes.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_byte">byte</a>(<a href="../std/ascii.md#std_ascii_char">char</a>: <a href="../std/ascii.md#std_ascii_Char">std::ascii::Char</a>): <a href="../std/u8.md#std_u8">u8</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_byte">byte</a>(<a href="../std/ascii.md#std_ascii_char">char</a>: <a href="../std/ascii.md#std_ascii_Char">Char</a>): <a href="../std/u8.md#std_u8">u8</a> { let <a href="../std/ascii.md#std_ascii_Char">Char</a> { <a href="../std/ascii.md#std_ascii_byte">byte</a> } = <a href="../std/ascii.md#std_ascii_char">char</a>; <a href="../std/ascii.md#std_ascii_byte">byte</a> } </code></pre> </details>

Function `is_valid_char`

Returns <code>true</code> if <code>b</code> is a valid ASCII character. Returns <code>false</code> otherwise.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_is_valid_char">is_valid_char</a>(b: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/bool.md#std_bool">bool</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_is_valid_char">is_valid_char</a>(b: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/bool.md#std_bool">bool</a> { b <= 0x7F } </code></pre> </details>

Function `is_printable_char`

Returns <code>true</code> if <code><a href="../std/ascii.md#std_ascii_byte">byte</a></code> is a printable ASCII character. Returns <code>false</code> otherwise.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_is_printable_char">is_printable_char</a>(<a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/bool.md#std_bool">bool</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_is_printable_char">is_printable_char</a>(<a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/bool.md#std_bool">bool</a> { <a href="../std/ascii.md#std_ascii_byte">byte</a> >= 0x20 && // Disallow metacharacters <a href="../std/ascii.md#std_ascii_byte">byte</a> <= 0x7E // Don't allow DEL metacharacter } </code></pre> </details>

Function `is_empty`

Returns <code>true</code> if <code><a href="../std/string.md#std_string">string</a></code> is empty.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_is_empty">is_empty</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>): <a href="../std/bool.md#std_bool">bool</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_is_empty">is_empty</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">String</a>): <a href="../std/bool.md#std_bool">bool</a> { <a href="../std/string.md#std_string">string</a>.bytes.<a href="../std/ascii.md#std_ascii_is_empty">is_empty</a>() } </code></pre> </details>

Function `to_uppercase`

Convert a <code><a href="../std/string.md#std_string">string</a></code> to its uppercase equivalent.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_to_uppercase">to_uppercase</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>): <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_to_uppercase">to_uppercase</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">String</a>): <a href="../std/ascii.md#std_ascii_String">String</a> { let bytes = <a href="../std/string.md#std_string">string</a>.<a href="../std/ascii.md#std_ascii_as_bytes">as_bytes</a>().map_ref!(|<a href="../std/ascii.md#std_ascii_byte">byte</a>| <a href="../std/ascii.md#std_ascii_char_to_uppercase">char_to_uppercase</a>(*<a href="../std/ascii.md#std_ascii_byte">byte</a>)); <a href="../std/ascii.md#std_ascii_String">String</a> { bytes } } </code></pre> </details>

Function `to_lowercase`

Convert a <code><a href="../std/string.md#std_string">string</a></code> to its lowercase equivalent.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_to_lowercase">to_lowercase</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>): <a href="../std/ascii.md#std_ascii_String">std::ascii::String</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_to_lowercase">to_lowercase</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">String</a>): <a href="../std/ascii.md#std_ascii_String">String</a> { let bytes = <a href="../std/string.md#std_string">string</a>.<a href="../std/ascii.md#std_ascii_as_bytes">as_bytes</a>().map_ref!(|<a href="../std/ascii.md#std_ascii_byte">byte</a>| <a href="../std/ascii.md#std_ascii_char_to_lowercase">char_to_lowercase</a>(*<a href="../std/ascii.md#std_ascii_byte">byte</a>)); <a href="../std/ascii.md#std_ascii_String">String</a> { bytes } } </code></pre> </details>

Function `index_of`

Computes the index of the first occurrence of the <code>substr</code> in the <code><a href="../std/string.md#std_string">string</a></code>. Returns the length of the <code><a href="../std/string.md#std_string">string</a></code> if the <code>substr</code> is not found. Returns 0 if the <code>substr</code> is empty.

<pre><code>public fun <a href="../std/ascii.md#std_ascii_index_of">index_of</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>, substr: &<a href="../std/ascii.md#std_ascii_String">std::ascii::String</a>): <a href="../std/u64.md#std_u64">u64</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>public fun <a href="../std/ascii.md#std_ascii_index_of">index_of</a>(<a href="../std/string.md#std_string">string</a>: &<a href="../std/ascii.md#std_ascii_String">String</a>, substr: &<a href="../std/ascii.md#std_ascii_String">String</a>): <a href="../std/u64.md#std_u64">u64</a> { let mut i = 0; let (n, m) = (<a href="../std/string.md#std_string">string</a>.<a href="../std/ascii.md#std_ascii_length">length</a>(), substr.<a href="../std/ascii.md#std_ascii_length">length</a>()); if (n < m) return n; while (i <= n - m) { let mut j = 0; while (j < m && <a href="../std/string.md#std_string">string</a>.bytes[i + j] == substr.bytes[j]) j = j + 1; if (j == m) return i; i = i + 1; }; n } </code></pre> </details>

Function `char_to_uppercase`

Convert a <code><a href="../std/ascii.md#std_ascii_char">char</a></code> to its lowercase equivalent.

<pre><code>fun <a href="../std/ascii.md#std_ascii_char_to_uppercase">char_to_uppercase</a>(<a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/u8.md#std_u8">u8</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>fun <a href="../std/ascii.md#std_ascii_char_to_uppercase">char_to_uppercase</a>(<a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/u8.md#std_u8">u8</a> { if (<a href="../std/ascii.md#std_ascii_byte">byte</a> >= 0x61 && <a href="../std/ascii.md#std_ascii_byte">byte</a> <= 0x7A) <a href="../std/ascii.md#std_ascii_byte">byte</a> - 0x20 else <a href="../std/ascii.md#std_ascii_byte">byte</a> } </code></pre> </details>

Function `char_to_lowercase`

Convert a <code><a href="../std/ascii.md#std_ascii_char">char</a></code> to its lowercase equivalent.

<pre><code>fun <a href="../std/ascii.md#std_ascii_char_to_lowercase">char_to_lowercase</a>(<a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/u8.md#std_u8">u8</a> </code></pre> <details> <summary>Implementation</summary> <pre><code>fun <a href="../std/ascii.md#std_ascii_char_to_lowercase">char_to_lowercase</a>(<a href="../std/ascii.md#std_ascii_byte">byte</a>: <a href="../std/u8.md#std_u8">u8</a>): <a href="../std/u8.md#std_u8">u8</a> { if (<a href="../std/ascii.md#std_ascii_byte">byte</a> >= 0x41 && <a href="../std/ascii.md#std_ascii_byte">byte</a> <= 0x5A) <a href="../std/ascii.md#std_ascii_byte">byte</a> + 0x20 else <a href="../std/ascii.md#std_ascii_byte">byte</a> } </code></pre> </details>

Struct String

Struct Char

Constants

Function char

Function string

Function try_string

Function all_characters_printable

Function push_char

Function pop_char

Function length

Function append

Function insert

Function substring

Function as_bytes

Function into_bytes

Function byte

Function is_valid_char

Function is_printable_char

Function is_empty

Function to_uppercase

Function to_lowercase

Function index_of

Function char_to_uppercase

Function char_to_lowercase