View source code Display the source code in std/encoding.d from which this page was generated on github. Improve this page Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone. Page wiki View or edit the community-maintained wiki page associated with this page.

Function std.encoding.codeUnits

Returns a foreachable struct which can bidirectionally iterate over all code units in a code point.

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 type in the template parameter.

Prototype

CodeUnits!E codeUnits(E)(
  dchar c
);

Supersedes

This function supersedes std.utf.encode().

Standards

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

Parameters

NameDescription
c the code point to be encoded

Example

char[] a;
foreach(c;codeUnits!(char)(cast(dchar)'\u20AC'))
{
    a ~= c;
}
assert(a.length == 3);
assert(a[0] == 0xE2);
assert(a[1] == 0x82);
assert(a[2] == 0xAC);

Authors

Janice Caron

License

Boost License 1.0.

Comments