View source code
Display the source code in std/utf.d from which this page was generated on github.
Report a bug
If you spot a problem with this page, click here to create a Bugzilla issue.
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.

Function std.utf.toUTF8

Encodes the elements of s to UTF-8 and returns a newly allocated string of the elements.

string toUTF8(S) (
  S s
)
if (isInputRange!S && !isInfinite!S && isSomeChar!(ElementEncodingType!S));

Parameters

NameDescription
s the string to encode

Returns

A UTF-8 string

See Also

For a lazy, non-allocating version of these functions, see byUTF.

Example

import std.algorithm.comparison : equal;

// The ö is represented by two UTF-8 code units
assert("Hellø"w.toUTF8.equal(['H', 'e', 'l', 'l', 0xC3, 0xB8]));

// 𐐷 is four code units in UTF-8
assert("𐐷"d.toUTF8.equal([0xF0, 0x90, 0x90, 0xB7]));

Authors

Walter Bright and Jonathan M Davis

License

Boost License 1.0.