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

Метод ТИП_ФАЙЛ.НОВАЯ

Метод НОВАЯ создает новый текстовый файл. Метод ОТКРЫТЬ открывает файл только на чтение и применить метод ЗАПИСАТЬ в этом случае нельзя. Чтобы открыть файл на запись, необходимо использовать метод НОВАЯ.

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

Параметры

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

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

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

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

имя_файла = "Test.txt"
ЕСЛИ  СУЩ_ФАЙЛ (имя_файла)  ТО
    ЕСЛИ  ВОПРОС ("Файл уже существует! Заменить", НЕТ ) = НЕТ  ТО
        СТОП
    КОНЕЦ_ЕСЛИ
КОНЕЦ_ЕСЛИ
СОЗДАТЬ ( файл, ТИП_ФАЙЛ )  // Создать объект Файл
файл.НОВАЯ (имя_файла)
файл.ЗАПИСАТЬ ("Тест метода 'НОВАЯ' объекта 'Файл'")
файл.ЗАПИСАТЬ ("Текущая дата: "+ДАТАП ( ДАТА_ТЕК ) )
файл.ЗАПИСАТЬ ("Текущее время: "+СТР (ВРЕМЯ_ТЕК) )
файл.ЗАКРЫТЬ

См. также: