Функции для работы с файлами

Функции предназначены для работы с текстовыми файлами и могут использоваться, например, для ведения журнала (log-файла) действий программы. Названия файлов могут содержать пути к ним, например «C:/QUIK/log/new.log».

CLEAR_FILE

Очищает указанный файл.

MAP CLEAR_FILE (STRING target_file)

Функция возвращает ассоциативный массив (MAP), содержащий параметры:

№	Параметр	Тип	Описание
1	RESULT	DOUBLE	Результат выполнения операции. Возможные значения: «1» – выполнено успешно, «0» – произошла ошибка.
2	DESCRIPTION	STRING	Диагностика операционной системы в случае ошибки

WRITE

Записывает в конец файла «target_file» строку «string_to_write».

MAP WRITE (STRING target_file, STRING string_to_write)

Функция возвращает ассоциативный массив (MAP), содержащий параметры:

№	Параметр	Тип	Описание
1	RESULT	DOUBLE	Результат выполнения операции. Возможные значения: «1» – выполнено успешно, «0» – произошла ошибка.
2	DESCRIPTION	STRING	Диагностика операционной системы в случае ошибки

WRITELN

Записывает в конец файла «target_file» строку «string_to_write» с последующим переводом строки.

MAP WRITELN (STRING target_file, STRING string_to_write)

Функция возвращает ассоциативный массив (MAP), содержащий параметры:

Пример:

‘
CLEAR_FILE ("new.log")
WRITE ("new.log","Hello, ")
WRITELN ("new.log","world")
‘

GET_FILE_LEN

Возвращает количество строк в файле «target_file». Если такого файла не существует, возвращает «-1». 

DOUBLE GET_FILE_LEN (STRING target_file)

READ_LINE

Функция считывает из файла «target_file» и возвращает строку под номером «line». Длина строки не должна превышать 1000 символов, строки большей длины при считывании будут обрезаны.

STRING READ_LINE (STRING target_file, DOUBLE line, DOUBLE error)

«error» - возвращаемый результат выполнения операции. Если значение равно «0», то чтение прошло успешно; «1» - произошла ошибка, «2» - достигнут конец файла.

Пример:

‘
WRITELN ("new.log","Hello, world")
msg = READ_LINE ("new.log", GET_FILE_LEN("new.log"), error)
MESSAGE (msg,1)
‘