nsIScriptableUnicodeConverter

この文書は翻訳中です。他国語のままの部分などがあるのはその為です。
是非お気軽に MDN に登録して翻訳に参加し、私たちの手助けをして下さい！

intl/uconv/idl/nsIScriptableUConv.idlScriptable

このインターフェイスは、スクリプトで使用するための Unicode エンコーダーです。

継承元: nsISupports 最終更新: Gecko 1.8 (Firefox 1.5 / Thunderbird 1.5 / SeaMonkey 1.0)

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

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

メソッドの概要

ACString ConvertFromUnicode(in AString aSrc);

ACString Finish();

AString ConvertToUnicode(in ACString aSrc);

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

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

nsIInputStream convertToInputStream(in AString aString);

属性

属性名	型	概要
`charset`	`string`	現在の文字セット。要求された文字セットがサポートされていない場合、 `NS_ERROR_UCONV_NOCONV` がスローされる。

メソッド

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
);

引数

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

戻り値

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

例

See Reading textual data and Writing textual data for examples.