mozilla

Compare Revisions

Writing textual data

Change Revisions

Revision 96777:

Revision 96777 by Biesi on

Revision 96778:

Revision 96778 by Jungshik on

Title:
Writing textual data
Writing textual data
Slug:
Writing_textual_data
Writing_textual_data
Tags:
Extensions, Add-ons, Internationalization, Unicode
Extensions, Add-ons, Internationalization, Unicode
Content:

Revision 96777
Revision 96778
n16      When writing textual data to an output stream or to a file,n16      When writing textual data to an output stream or to a file,
> you need to pick a <a href="en/Character_set">character set</a>.> you need to pick a <a href="en/Character_encoding">character enc
 >oding</a>.
n19      Some character sets can represent "all" characters (the UTFn19      Some character encodings (UTF-8, UTF-16, UTF-32) can repres
>-* character sets and UCS-4), others can only represent some char>ent "all" characters (the full repertoire of Unicode) while other
>acters.>s can only represent a subset of the full repertoire.
n31var charset = "UTF-8"; // Can be any charset name that Mozilla sun31var charset = "UTF-8"; // Can be any character encoding name that
>pports> Mozilla supports
n52      By default, trying to write characters that are not supportn52      By default, trying to write characters that are not support
>ed by the selected character set throws an exception (with an err>ed by the selected character encoding throws an exception (with a
>or code of NS_ERROR_LOSS_OF_SIGNIFICANT_DATA), and no data will b>n error code of NS_ERROR_LOSS_OF_SIGNIFICANT_DATA), and no data w
>e written.>ill be written.
n61      <i>Note</i>: If the replacement character is not a supporten61      <i>Note</i>: If the replacement character is not a supporte
>d character in the chosen character set, attempts to write unsupp>d character in the chosen character encoding, attempts to write u
>orted characters will fail with NS_ERROR_LOSS_OF_SIGNIFICANT_DATA>nsupported characters will fail with NS_ERROR_LOSS_OF_SIGNIFICANT
>.>_DATA.
n70      Alternative ways usable from JavaScript <b>do not support cn70      Alternative ways usable from JavaScript <b>do not support c
>haracter sets that use embedded nulls</b> (such as UTF-16 or UCS->haracter encodings that use embedded nulls</b> (such as UTF-16 an
>4). They work by manually converting the string you want to write>d UTF-32). They work by manually converting the string you want t
> to a byte sequence, and writing that to the stream.>o write to a byte sequence, and writing that to the stream.
n79converter.charset = /* The charset you want, using UTF-8 for thisn79converter.charset = /* The character encoding you want, using UTF
> example */ "UTF-8";>-8 for this example */ "UTF-8";
t92      At the end, you need to call <code>Finish</code> and write t92      At the end, you need to call <code>Finish</code> and write 
>its data to the stream. Note that not many character sets need it>its data to the stream. Note that not many character encodings ne
>, but for those that do calling this is important for proper outp>ed it, but for those that do calling this is important for proper
>ut.> output.

Back to History