import{_ as e,c as r,a3 as t,o as i}from"./chunks/framework.CUlkWZrb.js";const p=JSON.parse('{"title":"ЧтениеДанных / DataReader","description":"","frontmatter":{"outline":[2,3]},"headers":[],"relativePath":"syntax/DataReader.md","filePath":"syntax/DataReader.md"}'),l={name:"syntax/DataReader.md"};function o(n,a,h,d,s,u){return i(),r("div",null,a[0]||(a[0]=[t('ЧтениеДанных / DataReader
Объект предназначен для чтения различных типов данных из источника данных. В качестве источника могут выступать Поток, Файл или ДвоичныеДанные. Необходимо соблюдать следующий порядок работы с данным объектом:
- Создать объект ЧтениеДанных на основании источника данных.
- Выполнить требуемые действия с помощью объекта.
- Закрыть экземпляр объекта ЧтениеДанных. При необходимости использовать другие методы для работы с источником данных, требуется сначала закрыть экземпляр объекта ЧтениеДанных с помощью метода Закрыть, выполнить необходимые действия над источником, установить требуемую позицию для чтения из источника и создать новый экземпляр ЧтениеДанных.
Свойства
КодировкаТекста / TextEncoding
Кодировка текста, используемая по-умолчанию для данного экземпляра ЧтениеДанных. Кодировка может быть задана как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки.
КонвертируемыйРазделительСтрок / ConvertibleSplitterOfLines
Тип значения: Строка (String)
Конвертируемый разделитель строк. Этот параметр влияет на поведение метода ПрочитатьСимволы.
ПорядокБайтов / ByteOrder
Тип значения: ПорядокБайтов (ByteOrder)
Порядок байтов по умолчанию.
РазделительСтрок / LineSplitter
Тип значения: Строка (String)
Разделитель строк по-умолчанию. Это свойство влияет на поведение метода ПрочитатьСтроку.
ЧтениеЗавершено / ReadCompleted
Тип значения: Булево (Boolean)
Содержит признак того, что во входном потоке больше нет данных для чтения. Изначально устанавливается в значение Ложь. Если при очередном чтении было прочитано меньше данных, чем было запрошено, принимает значение Истина.
Методы
Закрыть / Close
Вызов данного метода завершает работу с текущим объектом. Если объект является владельцем вложенного потока, поток также закрывается.
ИсходныйПоток / SourceStream
Получает исходный поток, из которого выполняется чтение данных.
Пропустить / Skip
Пропускает при чтении указанное количество байтов в потоке.
Параметры
ПропуститьДо / SkipTo
Пропускает при чтении двоичные данные до указанного разделителя.
Параметры
- marker: Маркер, до которого требуется пропустить данные.
Прочитать / Read
Выполняет чтение двоичных данных заданного размера из потока. Если размер не указан, будут прочитаны все данные до конца потока.
Параметры
- number: Количество байтов, которые требуется прочитать. Если не задано, то выполняется чтение всех данных до конца потока. Значение по умолчанию: Неопределено. Необязательный. Значение по умолчанию: 0
Возвращаемое значение
Содержит описание результата чтения данных из потока.
ПрочитатьБайт / ReadByte
Выполняет чтение одного байта из потока.
ПрочитатьВБуферДвоичныхДанных / ReadIntoBinaryDataBuffer
Прочитать байты из потока в БуферДвоичныхДанных.
Параметры
- buffer: Буфер двоичных данных, в который требуется поместить прочитанные байты. или Количество байтов, которые требуется прочитать (остальные параметры игнорируются). Если не задано, то выполняется чтение всех данных до конца потока. Необязательный.
- positionInBuffer: Позиция в буфере, начиная с которой требуется записать прочитанные данные. Необязательный. Значение по умолчанию: 0
- number: Количество байтов, которые требуется прочитать. Необязательный. Значение по умолчанию: 0
ПрочитатьДо / ReadTo
Выполняет чтение двоичных данных до указанного маркера.
Параметры
- marker: Маркер, до которого выполняется чтение данных.
Возвращаемое значение
Содержит описание результата чтения данных из потока.
ПрочитатьСимволы / ReadChars
Выполняет чтение заданного количества символов из потока в виде строки. Если количество символов не задано, выполняется чтение всего остатка потока.
Параметры
- count: Количество символов, которые требуется прочитать. Если не установлено, то будут прочитаны все символы до конца потока. Значение по умолчанию: Неопределено. Необязательный. Значение по умолчанию: 0
- encoding: Определяет кодировку текста. Если не установлена, используется кодировка, заданная для данного объекта ЧтениеДанных. Кодировка может быть задана как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки. Значение по умолчанию: Неопределено. Типы: КодировкаТекста (TextEncoding), Строка (String) Необязательный.
ПрочитатьСтроку / ReadLine
Выполняет чтение строки текста до разделителя строки. Если разделитель не найден, чтение выполняется до конца потока. Если разделитель строки не задан явно, используется разделитель строки, указанный для данного экземпляра объекта ЧтениеДанных.
Параметры
- encoding: Кодировка текста. Если не установлена, используется кодировка, заданная для текущего экземпляра ЧтениеДанных. Значение по умолчанию: Неопределено. Типы: КодировкаТекста (TextEncoding), Строка (String) Необязательный.
- lineSplitter: Указывает строку, являющуюся разделителем строк в читаемых данных. Если параметр не указан, используется разделитель строк, указанный для текущего экземпляра объекта ЧтениеДанных. Значение по умолчанию: Неопределено. Необязательный. Значение по умолчанию:
ПрочитатьЦелое16 / ReadInt16
Считывает 16-битное целое число из потока.
Параметры
- byteOrder: Порядок байтов, используемый при чтении числа. Если не задан, используется порядок, определенный для текущего экземпляра ЧтениеДанных. Значение по умолчанию: Неопределено. Необязательный.
ПрочитатьЦелое32 / ReadInt32
Прочитать 32-битное целое число из потока.
Параметры
- byteOrder: Порядок байтов, используемый при чтении числа. Если не задан, используется порядок, определенный для текущего экземпляра ЧтениеДанных. Значение по умолчанию: Неопределено. Необязательный.
Возвращаемое значение
Числовым типом может быть представлено любое десятичное число. Над данными числового типа определены основные арифметические операции: сложение, вычитание, умножение и деление. Максимально допустимая разрядность числа 38 знаков.
ПрочитатьЦелое64 / ReadInt64
Считывает 64-битное целое число из потока.
Параметры
- byteOrder: Устанавливает порядок байтов, используя который число будет прочитано. Если порядок байтов не задан, то используется порядок байтов, определенный для текущего экземпляра ЧтениеДанных. Значение по умолчанию: Неопределено. Необязательный.
Возвращаемое значение
Числовым типом может быть представлено любое десятичное число. Над данными числового типа определены основные арифметические операции: сложение, вычитание, умножение и деление. Максимально допустимая разрядность числа 38 знаков.
Разделить / Split
Разделяет остаток данных по заданным разделителям.
Параметры
- separator: Двоичный разделитель данных.
Разделить / Split
Разделяет остаток данных по заданным разделителям.
Параметры
- separator: Разделитель данных в виде строки.
- encoding: Кодировка текста. Если не задана, то используется кодировка, заданная для текущего экземпляра объекта ЧтениеДанных. Значение по умолчанию: Неопределено. Типы: КодировкаТекста (TextEncoding), Строка (String) Необязательный.
РазделитьНаЧастиПо / SplitInPartsOf
Разделяет остаток данных на части заданного размера. Размер части указывается в байтах.
Параметры
- partSizw: Размер части данных в байтах.
Конструкторы
На основании двоичных данных или имени файла
Создает объект для чтения из заданного объекта ДвоичныеДанные. После завершения работы с объектом ЧтениеДанных до того, как будет закрыт поток, переданный в конструктор, объект следует закрыть с помощью метода Закрыть или НачатьЗакрытие.
Параметры
dataSource: Путь к файлу или экземпляр объекта ДвоичныеДанные, из которого будет выполнено чтение.
textEncoding: Определяет кодировку текста, используемую для чтения данных. По-умолчанию используется кодировка UTF-8. Кодировка может быть задана как в виде значения перечисления КодировкаТекста, так и в виде строки с указанием названия кодировки. Значение по умолчанию: UTF8. Типы: КодировкаТекста (TextEncoding), Строка (String) Необязательный.
byteOrder: Порядок байтов, используемый для декодирования целых чисел при чтении из потока. Значение по умолчанию: LittleEndian. Необязательный.
lineSplitter: Определяет строку, разделяющую строки в двоичных данных. Значение по умолчанию: Неопределено. Необязательный. Значение по умолчанию:
convertibleSplitterOfLines: Определяет разделение строк в файле для конвертации в стандартный перевод строк ПС. Значение по умолчанию: ВК + ПС. Необязательный.
',95)]))}const b=e(l,[["render",o]]);export{p as __pageData,b as default};