Library: Character encodings, JIS (OMFFJIS) Import: omffjis.xmd

Return type: output Returns:  A writable output target for streaming data.

Declaration

  export external output function writer
         escape-sequence value stream escape-sequence
                         optional initial {'%27#$B'}
                    into value output output-data

Use writerto accept UTF-8 encoded data and write that data to a value output, heralded by into, converted from a UTF-8 encoding to a JIS encoding. That is, the program writes UTF-8, but the provided output receives JIS.

writer has an optional first argument, heralded by escape-sequence that is the escape sequence used to switch into two-byte JIS X 0208/JIS C 6226 mode. It must be at least one byte long and no more than eight bytes long if specified.

Usage Note

To use writer, you must import omffjis.xmd into your program using a statement like this:

  import "omffjis.xmd" prefixed by jis.

(Please see the import topic for more on importing.)

Example

  ; Write a JIS-encoded file named by the first command-line
  ; argument using the stream named "output-file".  Convert
  ; the data from UTF-8 to JIS prior to writing it to the file.
  import "omffjis.xmd" prefixed by jis.
  process
     local stream output-file
     open output-file as jis.writer into file #args [1]

Other Library Functions    jis.reader    jis.writer

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]