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

jis-input-file

 
 

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

Declaration

define external string source function jis-input-file
                value string filename
  exceptions-to value io-exception exceptions-to optional


Purpose

This external string source function reads the file named by the "filename" argument and returns the text of that file converted from a JIS encoding to a UTF-8 encoding. The file is in JIS, but the program receives the UTF-8 conversion.

Arguments:

The file format is interpreted according to the Japanese Industry Standards JIS X 0201, JIS X 0208, and JIS X 0212. 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 input, some laxity is shown in recognizing not-quite-valid escape sequences and those defined by older versions of the standards.

Example:

  ; Outputting just the ASCII characters in a JIS-encoded file.
  
  repeat scan jis-input-file "myfile.jis"
  match ["%0#" to "%127#"]+ => ascii-text
     output ascii-text
  match ["%128#" to "%255#"]+
     ; Ignore high-order characters (which are non-ASCII).
  again

    Related Syntax
   jis-output-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.