# Method string_to_unicode()

Method string_to_unicode

  `string(8bit) string_to_unicode(string s, int(0..2)|void byteorder)`

Description

  Converts a string into an UTF16 compliant byte-stream.

Parameter `s`

  String to convert to UTF16.

Parameter `byteorder`

  Byte-order for the output. One of:

  `0` | Network (aka big-endian) byte-order (default).
  `1` | Little-endian byte-order.
  `2` | Native byte-order.

Note

  Throws an error if characters not legal in an UTF16 stream are encountered. Valid characters are in the range 0x00000 - 0x10ffff, except for characters 0xfffe and 0xffff.

  Characters in range 0x010000 - 0x10ffff are encoded using surrogates.

See also

  Charset.decoder(), string_to_utf8(), unicode_to_string(), utf8_to_string()