This legacy API represents binary data using the lower haft of each 16-bit code unit in a JavaScript string. If the other APIs you are reading data from or writing data to don't require you to use this legacy representation, you should use TextDecoder and TextEncoder (available to chrome JavaScript via Components.utils.importGlobalProperties) instead of this API.

Implemented by: @mozilla.org/intl/scriptableunicodeconverter. To create an instance, use:

var converter = Components.classes["@mozilla.org/intl/scriptableunicodeconverter"]
                .createInstance(Components.interfaces.nsIScriptableUnicodeConverter);

Method overview

Attributes

Methods

ConvertFromUnicode()

Converts the data from Unicode to one Charset. Returns the converted string. After converting, Finish should be called and its return value appended to this return value.

ACString ConvertFromUnicode(
  in AString aSrc
);

Finish()

Returns the terminator string. Should be called after ConvertFromUnicode() and appended to that function's return value.

ACString Finish();

ConvertToUnicode()

Converts the data from one Charset to Unicode.

AString ConvertToUnicode(
  in ACString aSrc
);

convertFromByteArray()

Converts an array of bytes to a unicode string.

AString convertFromByteArray(
  [const,array,size_is(aCount)] in octet aData,
  in unsigned long aCount
);

convertToByteArray()

Convert a unicode string to an array of bytes. Finish does not need to be called.

void convertToByteArray(in AString aString,
  out unsigned long aLen, Optional
  [array, size_is(aLen),retval] out octet aData
);

convertToInputStream()

Converts a Unicode string to an input stream. The bytes in the stream are encoded according to the charset attribute. The returned stream is non-blocking.

nsIInputStream convertToInputStream(
  in AString aString
);

Parameters

aString

The text to encode to the stream. The text is encoded into the character set specified by the charset attribute.

Return value

An nsIInputStream that will present the text specified in aString as its data.

Examples

See Reading textual data and Writing textual data for examples.