fread_char — Read one character from a text file.
fread_char( : : FileHandle : Char)
该算子 fread_char reads a character from the input
file defined by FileHandle.
The input file must have been opened with open_file in text format.
The read character or the control character sequence 'eof' is returned in
parameter Char.
该算子 fread_char respects the encoding of the characters,
unless the file was opened with the option 'ignore_encoding'
(see open_file).
Thus, when opened with the correct encoding 该算子 fread_char
returns multi-byte characters at once.
If necessary, the character is transcoded into the current encoding of the
HALCON library (see set_system(::'filename_encoding',<encoding>:)).
When the file was opened with encoding mode 'ignore_encoding',
Char always returns one byte without any interpretation or
transcoding. This is useful for reading a file with special control bytes
in a kind of raw mode.
If no character can be read because the end of the file is reached,
fread_char returns the control character sequence 'eof' in
Char.
该算子 fread_char emits a low-level error message, when
the next byte or byte sequence does not represent a valid code point in the
specified encoding. Despite of the low-level error message, 该算子
will not fail and Char will contain the next byte.
Furthermore, 该算子 also emits a low-level error
message, when the read character cannot be transcoded without loss of
information into the current encoding of the HALCON library.
This can only happen when the file is UTF-8 encoded and the
current encoding of the HALCON library is 'locale'
(see set_system(::'filename_encoding','locale':)).
FileHandle (input_control) file → (handle)
File handle.
Char (output_control) string → (string)
Read character, which can be multi-byte or the control string 'eof'.
* Read a text file character by character.
open_file (FileName, 'input', FileHandle)
repeat
fread_char (FileHandle, Char)
until (Char == 'eof')
close_file (FileHandle)
If an input file is open, 该算子 fread_char returns 2 (
H_MSG_TRUE)
.
Otherwise, an exception is raised.
Encoding errors have no influence on the result state.
fread_string,
read_string,
fread_line
open_file,
close_file,
fread_string,
fread_line
Foundation