swirl
Guide to OmniMark 8   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
  Related Syntax   Related Concepts   Other Library Functions  
function  

jis-output-file

 
 

Library: Character encodings, international (OMEFIO)
Include: omefio.xin

Declaration

define external string sink function jis-output-file
                value string filename
  exceptions-to value io-exception exceptions-to optional

Argument definitions

filename
the name of the JIS encoded file you want to write
exceptions-to
location that errors will be recorded


Purpose

This external function accepts UTF-8 encoded data and writes that data to the file named in the "filename" argument, converting the UTF-8 encoding to a JIS encoding. The program writes out UTF-8, but the file receives JIS.

If a zero-length filename is used (that is, ""), then jis-output-file does not open a file, but writes to standard output. The zero-length file name option allows the conversion functionality to be used in an OmniMark program that is being used as a filter.

There are three types of errors, categorized according to how they are handled:

The file format is produced according to the Japanese Industry Standards JIS X 0201, JIS X 0208, and JIS X 012. The file format uses escape sequences based on ISO 2022 (also known as JIS X 0202) to shift between the encodings defined by the three standards. On output, the escape sequences defined by the latest versions of the standards are used.

Example:


  ; Opening output files to write JIS-encoded files using "New JIS", "Old JIS" and
  ; "New JIS" using the 1990 standard, respectively.
  
  open my-jis-output as jis-output-file "myfile.jis"
  open my-jis-output as jis-output-file "myfile.oj" encoding jisio-old
  open my-jis-output as jis-output-file "myfile.j2" encoding jisio-1990

    Related Syntax
   jis-input-file
 
Related Concepts
   Character set encoding
 
Other Library Functions
   Big5-input-file
   Big5-output-file
   euc-input-file
   euc-output-file
   input-file
   jis-input-file
   jis-output-file
   output-file
   sjis-input-file
   sjis-output-file
   utf16-input-file
   utf16-output-file
 
 

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]

OmniMark 8.2.0 Documentation Generated: March 13, 2008 at 3:27:39 pm
If you have any comments about this section of the documentation, please use this form.

Copyright © Stilo International plc, 1988-2008.