Menu
Search

API Documentation

version 2.110.0

overview

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