ReadStringFormat()

Syntax

Result = ReadStringFormat(#File)

Checks if the current file position contains a BOM (Byte Order Mark) and tries to identify the String encoding used in the file. If a BOM is detected, the file pointer will be placed at the end of the BOM.

The Result can be one of the following:

  #PB_Ascii  : No BOM detected. This usually means a plain text file.
  #PB_UTF8   : UTF-8 BOM detected.
  #PB_Unicode: UTF-16 (little endian) BOM detected.

  #PB_UTF16BE: UTF-16 (big endian) BOM detected.
  #PB_UTF32  : UTF-32 (little endian) BOM detected.
  #PB_UTF32BE: UTF-32 (big endian) BOM detected.

The #PB_Ascii, #PB_UTF8 and #PB_Unicode results can be used directly in further calls to ReadString() to read the file. The other results represent string formats that cannot be directly read with PB string commands. They are included for completness so that an application can display a proper error message.

The Byte Order Mark is a commonly used way to indicate the encoding for a textfile. It is usually placed at the beginning of the file. It is however not a standard, just a commonly used practise. So if no BOM is detected at the start of a file, it does not necessarily mean that it is a plain text file. It could also just mean that the program that created the file did not use this practise. WriteStringFormat() can be used to place such a BOM in a file.

For more information, see this Wikipedia Article.
More informations about using unicode in PureBasic programm can also be found here.

Supported OS

All