Руководство разработчика

Функция ФАЙЛ_ОТКРЫТЬ

Функция ФАЙЛ_ОТКРЫТЬ предназначена для открытия файла на чтение.

ФУНКЦИЯ ТИП_ФАЙЛ: ФАЙЛ_ОТКРЫТЬ(ТИП_СТРОКА: имя_файла
    [; кодировка])

Параметры

имя_файла
Путь к открываемому файлу. Если указанный файл не найден, то расчет останавливается по ошибке.
кодировка
Необязательный параметр логического или строкового типа.

Если задано значение логического типа, то определяет необходимость перекодировки символов. Если параметр равен ДА или опущен, то перекодировка из кодовой таблицы OEM cp 866 включена. Когда этот параметр имеет значение НЕТ, то перекодировка символов файла не производится (в кодовую страницу cp1251, используемую в программе).

Дополнительные возможности перекодировки доступны, если указывается значение строкового типа:
  • "DOS" или "OEM" - производится перекодировка из cp866 в cp1251;
  • "WIN" или "ANSI - перекодировка не выполняется;
  • "UTF-8" - производится перекодировка из cp1251 в utf-8, BOM в начале файла пропускается (при его наличии).
  • "UTF-8.NoBOM" - производится перекодировка из cp1251 в utf-8, не предполагает наличия BOM в начале файла.

Возвращаемое значение

Объектная переменная.

Функция ФАЙЛ_ОТКРЫТЬ открывает файл только на чтение, записать что-либо при этом будет невозможно.

Пример использования

имя_файла = "C:\IB\ORN\Документ.txt"
ЕСЛИ  НЕ СУЩ_ФАЙЛ (имя_файла)  ТО   // Если файл не существует, то
    СТОП                            // остановить расчет
КОНЕЦ_ЕСЛИ
файл = ФАЙЛ_ОТКРЫТЬ (имя_файла, НЕТ)
и=0
ЦИКЛ ПОКА ( НЕ файл.КОНЕЦ_ФАЙЛА )
    СООБЩЕНИЕ(файл.СЧИТАТЬ)         // считать очередную строку
    и++                             // и вывести ее на экран
КОНЕЦ_ЦИКЛА
файл.ЗАКРЫТЬ

См. также: