swirl
Guide to OmniMark 9   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
  Related Topics   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 Topics
 
Other Library Functions
 
 

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

OmniMark 9.1.0 Documentation Generated: September 2, 2010 at 1:38:10 pm
If you have any comments about this section of the documentation, please use this form.

Copyright © Stilo International plc, 1988-2010.