encode

Encodes a single code point into an array.

This function encodes a single code point into one or more code units The code units are stored in a user-supplied fixed-size array, which must be passed by reference.

The input to this function MUST be a valid code point. This is enforced by the function's in-contract.

The type of the output cannot be deduced. Therefore, it is necessary to explicitly specify the encoding as a template parameter.

Supersedes: This function supersedes std.utf.encode(), however, note that the function codeUnits() supersedes it more conveniently.

Parameters

c dchar

the code point to be encoded

array E[]

the destination array

Return Value

Type: size_t

the number of code units written to the array

Meta

Standards

Unicode 5.0, ASCII, ISO-8859-1, ISO-8859-2, WINDOWS-1250, WINDOWS-1251, WINDOWS-1252