1. module utf8
   1. function utf8.decode (byteString)
   2. function utf8.encode (string)
   3. string utf8.version

module utf8

function utf8.decode (byteString)

• description and source-code

  function utf8decode(byteString) {
  		byteArray = ucs2decode(byteString);
  		byteCount = byteArray.length;
  		byteIndex = 0;
  		var codePoints = [];
  		var tmp;
  		while ((tmp = decodeSymbol()) !== false) {
  			codePoints.push(tmp);
  		}
  		return ucs2encode(codePoints);
  	}

• example usage

  ...
  utf8.encode('\xA9');
  // → '\xC2\xA9'
  // U+10001 LINEAR B SYLLABLE B038 E; see http://codepoints.net/U+10001
  utf8.encode('\uD800\uDC01');
  // → '\xF0\x90\x80\x81'
  ```
  
  ### `utf8.decode(byteString)`
  
  Decodes any given UTF-8-encoded string (`byteString`) as UTF-8, and returns the UTF-8-decoded version of the string. It throws an
   error when malformed UTF-8 is detected. (If you need to be able to decode encoded non-scalar values as well, use [WTF-8](https://
  mths.be/wtf8) instead.)
  
  ```js
  utf8.decode('\xC2\xA9');
  // → '\xA9'
  ...

function utf8.encode (string)

• description and source-code

  function utf8encode(string) {
  		var codePoints = ucs2decode(string);
  		var length = codePoints.length;
  		var index = -1;
  		var codePoint;
  		var byteString = '';
  		while (++index < length) {
  			codePoint = codePoints[index];
  			byteString += encodeCodePoint(codePoint);
  		}
  		return byteString;
  	}

• example usage

  ...
      console.log(utf8);
    }
  );
  ```
  
  ## API
  
  ### `utf8.encode(string)`
  
  Encodes any given JavaScript string (`string`) as UTF-8, and returns the UTF-8-encoded version of the string. It throws an error
   if the input string contains a non-scalar value, i.e. a lone surrogate. (If you need to be able to encode non-scalar values as
  well, use [WTF-8](https://mths.be/wtf8) instead.)
  
  ```js
  // U+00A9 COPYRIGHT SIGN; see http://codepoints.net/U+00A9
  utf8.encode('\xA9');
  // → '\xC2\xA9'
  ...