Текстовые файлы: объект TextStream Javascript

Текстовые файлы: объект TextStream

Объект TextStream предназначен для работы с текстовыми файлами. Он может быть создан методами FileSystemObject.CreateTextFile, FileSystemObject.OpenTextFile, Folder.CreateTextFile и File.OpenAsTextStream.

**Свойства объекта TextStream**
Свойство	Описание
`AtEndOfLine`	Проверяет конец строки.
`AtEndOfStream`	Проверяет конец файла.
`Column`	Номер текущего символа в строке.
`Line`	Номер текущей строки.

**Методы объекта TextStream**
Метод	Описание
`Close`	Закрывает файл.
`Read`	Читает заданное количество символов.
`ReadAll`	Читает весь файл.
`ReadLine`	Читает строку.
`Skip`	Пропускает заданное количество символов.
`SkipLine`	Пропускает строку.
`Write`	Выводит строку.
`WriteBlankLines`	Выводит пустые строки.
`WriteLine`	Выводит строку и символ конца строки.

Свойство AtEndOfLine

Синтаксис: объект.AtEndOfLine
Атрибуты:  { DontEnum, DontDelete, ReadOnly }

Свойство AtEndOfLine возвращает true, если следующим символом файла является символ перевода строки, и false в противном случае. Этим свойством обладают только файлы, открытые для чтения. Следующий пример показывает, как можно считать первую строку текстового файла:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.OpenTextFile("c:\\test.txt", 1, false);
var s = "";
while (!f.AtEndOfLine)
  s += f.Read(1);
f.Close();

Свойство AtEndOfStream

Синтаксис: объект.AtEndOfStream
Атрибуты:  { DontEnum, DontDelete, ReadOnly }

Свойство AtEndOfStream возвращает true, если достигнут конец файла, и false в противном случае. Этим свойством обладают только файлы, открытые для чтения. Следующий пример показывает, как можно считать весь текстовый файл в строку:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.OpenTextFile("c:\\test.txt", 1, false);
var s = "";
while (!f.AtEndOfStream)
  s += f.ReadLine();
f.Close();

Свойство Column

Синтаксис: объект.Column
Атрибуты:  { DontEnum, DontDelete, ReadOnly }

Свойство Column возвращает номер текущего символа в строке, считая с 1. Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.OpenTextFile("c:\\test.txt", 1, false);
var s = f.ReadLine();
var n = f.Column;

Свойство Line

Синтаксис: объект.Line
Атрибуты:  { DontEnum, DontDelete, ReadOnly }

Свойство Line возвращает номер текущей строки файла, считая с 1. Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.OpenTextFile("c:\\test.txt", 1, false);
var s = f.ReadAll();
var n = f.Line;

Метод Close

Синтаксис: объект.Close()

Метод Close закрывает данный файл. Примеры его использования приведены выше.

Метод Read

Синтаксис: объект.Read(число)
Аргументы: число — числовое выражение
Результат: строковое значение

Метод Read читает из файла заданное число символов и возвращает их в новой строке. Пример его использования приведен выше.

Метод ReadAll

Синтаксис: объект.ReadAll()
Результат: строковое значение

Метод ReadAll считывает файл полностью и возвращает результат в новой строке. Пример его использования приведен выше. Этим методом можно пользоваться только в тех случаях, когда размер файла невелик. В противном случае следует пользоваться последовательным обращением к методу ReadLine.

Метод ReadLine

Синтаксис: объект.ReadLine()
Результат: строковое значение

Метод ReadLine считывает очередную строку из файла и возвращает результат в новой строке. Пример его использования приведен выше. Чтение производится до символа перевода строки, но не включая его.

Метод Skip

Синтаксис: объект.Skip(число)
Аргументы: число — числовое выражение

Метод Skip считывает из файла заданное число символов, но не возвращает их. Используется для пропуска ненужного содержимого файла. Следующий пример пропускает при чтении первую строку файла:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.OpenTextFile("c:\\test.txt", 1, false);
while (!f.AtEndOfLine)
  f.Skip(1);
…

Метод SkipLine

Синтаксис: объект.SkipLine()

Метод SkipLine считывает из файла очередную строку, но не возвращает ее. Используется для пропуска ненужного содержимого файла. Следующий пример пропускает при чтении первую строку файла:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.OpenTextFile("c:\\test.txt", 1, false);
f.SkipLine();
…

Метод Write

Синтаксис: объект.Write(строка)
Аргументы: строка — строковое выражение

Метод Write выводит в файл заданную строку. Символ перевода строки после строки не выводится, для этого нужно пользоваться методом WriteLine. Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.OpenTextFile("c:\\test.txt", 2, true);
f.Write("Тестовая строка");
f.Close();

Метод WriteBlankLines

Синтаксис: объект.WriteBlankLines(число)
Аргументы: число — числовое выражение

Метод WriteBlankLines выводит в файл заданное число символов перевода строки. Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.OpenTextFile("c:\\test.txt", 2, false);
f.WriteBlankLines(10);
f.Close()

Метод WriteLine

Синтаксис: объект.Write(строка?)
Аргументы: строка — строковое выражение

Метод Write выводит в файл заданную строку и символ перевода строки после нее. Если строка опущена, то выводится только символ перевода строки. Пример:

var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.OpenTextFile("c:\\test.txt", 2, true);
f.WriteLine("Тестовая строка");
f.Close();

Javascript