Method string_to_utf8()
- Method
string_to_utf8
utf8_string
string_to_utf8(string
s
)
utf8_string
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
and0x0000e000-0x0010ffff
.- See also
Charset.encoder(), string_to_unicode(), unicode_to_string(), utf8_to_string()