# Method string_to_utf8()

Method string_to_utf8

  ``string(8bit)` string_to_utf8(`string` `s`)`
  ``string(8bit)` string_to_utf8(`string` `s`, `int` `extended`)`

Description

  Convert a string into a UTF-8 compliant byte-stream.

Parameter `s`

  String to encode into UTF-8.

Parameter `extended`

  Bitmask with extension options.

  ``1`` | Accept and encode the characters outside the valid ranges using the same algorithm. Such encoded characters are however not UTF-8 compliant.
  ``2`` | Encode characters outside the BMP with UTF-8 encoded UTF-16 (ie split them into surrogate pairs and encode).

Note

  Throws an error if characters not valid in an UTF-8 stream are encountered. Valid characters are in the ranges `0x00000000-0x0000d7ff` and `0x0000e000-0x0010ffff`.

See also

  Charset.encoder(), string_to_unicode(), unicode_to_string(), utf8_to_string()