import{_ as e,c as t,a3 as r,o as i}from"./chunks/framework.CUlkWZrb.js";const p=JSON.parse('{"title":"ФайловыйПоток / FileStream","description":"","frontmatter":{"outline":[2,3]},"headers":[],"relativePath":"syntax/FileStream.md","filePath":"syntax/FileStream.md"}'),l={name:"syntax/FileStream.md"};function o(n,a,h,s,d,u){return i(),t("div",null,a[0]&#124;&#124;(a[0]=[r('<h1 id="фаиловыипоток-filestream" tabindex="-1">ФайловыйПоток / FileStream <a href="#фаиловыипоток-filestream" aria-label="Permalink to &quot;ФайловыйПоток / FileStream&quot;">​</a> </h1><p>Специализированная версия объекта Поток для работы данными, расположенными в файле на диске. Предоставляет возможность чтения из потока, записи в поток и изменения текущей позиции. По умолчанию, все операции с файловым потоком являются буферизированными, размер буфера по умолчанию - 8 КБ. Размер буфера можно изменить, в том числе - полностью отключить буферизацию при вызове конструктора. Следует учитывать, что помимо буферизации существует кэширование чтения и записи файлов в операционной системе, на которое невозможно повлиять программно.</p><h2 id="своиства" tabindex="-1">Свойства <a href="#своиства" aria-label="Permalink to &quot;Свойства&quot;">​</a> </h2><h3 id="доступназапись-canwrite" tabindex="-1">ДоступнаЗапись / CanWrite <a href="#доступназапись-canwrite" aria-label="Permalink to &quot;ДоступнаЗапись / CanWrite&quot;">​</a> </h3><ul><li>Чтение: Да</li><li>Запись: Нет</li></ul><p><strong>Тип значения:</strong> Булево (Boolean)</p><p>Признак доступности записи в поток.</p><h3 id="доступноизменениепозиции-canseek" tabindex="-1">ДоступноИзменениеПозиции / CanSeek <a href="#доступноизменениепозиции-canseek" aria-label="Permalink to &quot;ДоступноИзменениеПозиции / CanSeek&quot;">​</a> </h3><ul><li>Чтение: Да</li><li>Запись: Нет</li></ul><p><strong>Тип значения:</strong> Булево (Boolean)</p><p>Признак доступности произвольного изменения позиции чтения/записи в потоке.</p><h3 id="доступночтение-canread" tabindex="-1">ДоступноЧтение / CanRead <a href="#доступночтение-canread" aria-label="Permalink to &quot;ДоступноЧтение / CanRead&quot;">​</a> </h3><ul><li>Чтение: Да</li><li>Запись: Нет</li></ul><p><strong>Тип значения:</strong> Булево (Boolean)</p><p>Признак доступности чтения из потока.</p><h3 id="доступентаимаут-cantimeout" tabindex="-1">ДоступенТаймаут / CanTimeout <a href="#доступентаимаут-cantimeout" aria-label="Permalink to &quot;ДоступенТаймаут / CanTimeout&quot;">​</a> </h3><ul><li>Чтение: Да</li><li>Запись: Нет</li></ul><p><strong>Тип значения:</strong> Булево (Boolean)</p><p>Признак доступности установки таймаута чтения/записи в потоке.</p><h3 id="таимаутчтения-readtimeout" tabindex="-1">ТаймаутЧтения / ReadTimeout <a href="#таимаутчтения-readtimeout" aria-label="Permalink to &quot;ТаймаутЧтения / ReadTimeout&quot;">​</a> </h3><ul><li>Чтение: Да</li><li>Запись: Да</li></ul><p><strong>Тип значения:</strong> Число (int)</p><p>Время в миллисекундах, отведенное потоку на операцию чтения.</p><h3 id="таимаутзаписи-writetimeout" tabindex="-1">ТаймаутЗаписи / WriteTimeout <a href="#таимаутзаписи-writetimeout" aria-label="Permalink to &quot;ТаймаутЗаписи / WriteTimeout&quot;">​</a> </h3><ul><li>Чтение: Да</li><li>Запись: Да</li></ul><p><strong>Тип значения:</strong> Число (int)</p><p>Время в миллисекундах, отведенное потоку на операцию записи.</p><h3 id="имяфаила" tabindex="-1">ИмяФайла / <a href="#имяфаила" aria-label="Permalink to &quot;ИмяФайла /&quot;">​</a> </h3><ul><li>Чтение: Да</li><li>Запись: Нет</li></ul><p>Содержит полное имя файла, включая путь</p><h2 id="методы" tabindex="-1">Методы <a href="#методы" aria-label="Permalink to &quot;Методы&quot;">​</a> </h2><h3 id="закрыть-close" tabindex="-1">Закрыть / Close <a href="#закрыть-close" aria-label="Permalink to &quot;Закрыть / Close&quot;">​</a> </h3><p>Вызов данного метода завершает работу с потоком. При попытке вызвать любой метод объекта, кроме метода Закрыть, будет вызвано исключение. При повторном вызове данного метода никаких действий выполняться не будет. Выполняемое действие зависит от используемого типа потока.</p><h3 id="записать-write" tabindex="-1">Записать / Write <a href="#записать-write" aria-label="Permalink to &quot;Записать / Write&quot;">​</a> </h3><p>Записывает в поток заданное количество байтов из буфера по заданному смещению. Если в буфере меньше данных, чем требуется записать, вызывается исключение о недостаточном количестве данных в буфере. Запись в поток возможна только, если поток поддерживает запись. В противном случае при вызове метода будет вызвано исключение.</p><h4 id="параметры" tabindex="-1">Параметры <a href="#параметры" aria-label="Permalink to &quot;Параметры&quot;">​</a> </h4><ul><li><strong>buffer</strong>: Буфер, из которого выбираются данные для записи.</li><li><strong>positionInBuffer</strong>: Позиция в буфере, начиная с которой данные будут получены для записи в поток.</li><li><strong>number</strong>: Количество байт, которые требуется записать.</li></ul><h3 id="копироватьв-copyto" tabindex="-1">КопироватьВ / CopyTo <a href="#копироватьв-copyto" aria-label="Permalink to &quot;КопироватьВ / CopyTo&quot;">​</a> </h3><p>Копирует данные из текущего потока в другой поток.</p><h4 id="параметры-1" tabindex="-1">Параметры <a href="#параметры-1" aria-label="Permalink to &quot;Параметры&quot;">​</a> </h4><ul><li><strong>targetStream</strong>: Поток, в который будет выполняться копирование.</li><li><strong>bufferSize</strong>: Размер буфера, используемого при копировании. Если параметр не задан, то система подбирает размер буфера автоматически. <em>Необязательный</em>. Значение по умолчанию: 0</li></ul><h3 id="переити-seek" tabindex="-1">Перейти / Seek <a href="#переити-seek" aria-label="Permalink to &quot;Перейти / Seek&quot;">​</a> </h3><p>Сдвигает текущую позицию потока на заданное количество байтов относительно начальной позиции. Если указано отрицательное смещение, позиция сдвигается в направлении к началу потока. Если изменение позиции недоступно (ДоступноИзменениеПозиции установлено в Ложь), будет сгенерировано исключение.</p><h4 id="параметры-2" tabindex="-1">Параметры <a href="#параметры-2" aria-label="Permalink to &quot;Параметры&quot;">​</a> </h4><ul><li><strong>offset</strong>: Количество байтов, на которое нужно передвинуть позицию в потоке.</li><li><strong>initialPosition</strong>: Начальная позиция, от которой отсчитывается смещение. <em>Необязательный</em>. Значение по умолчанию: Begin</li></ul><h4 id="возвращаемое-значение" tabindex="-1">Возвращаемое значение <a href="#возвращаемое-значение" aria-label="Permalink to &quot;Возвращаемое значение&quot;">​</a> </h4><p>Числовым типом может быть представлено любое десятичное число. Над данными числового типа определены основные арифметические операции: сложение, вычитание, умножение и деление. Максимально допустимая разрядность числа 38 знаков.</p><h3 id="получитьпотоктолькодлячтения-getreadonlystream" tabindex="-1">ПолучитьПотокТолькоДляЧтения / GetReadonlyStream <a href="#получитьпотоктолькодлячтения-getreadonlystream" aria-label="Permalink to &quot;ПолучитьПотокТолькоДляЧтения / GetReadonlyStream&quot;">​</a> </h3><p>Возвращает поток, который разделяет данные и текущую позицию с данным потоком, но не разрешает запись.</p><h3 id="прочитать-read" tabindex="-1">Прочитать / Read <a href="#прочитать-read" aria-label="Permalink to &quot;Прочитать / Read&quot;">​</a> </h3><p>Выполняет чтение заданного количества байтов в указанный буфер по указанному смещению. Текущая позиция смещается вперед на фактическое количество прочитанных байтов. Чтение из потока возможно только, если поток поддерживает чтение. В противном случае, будет вызвано исключение. При чтении размер целевого буфера не меняется, а его содержимое перезаписывается фактически прочитанными данными. Если в буфере недостаточно места для записи прочитанных данных, происходит ошибка переполнения.</p><h4 id="параметры-3" tabindex="-1">Параметры <a href="#параметры-3" aria-label="Permalink to &quot;Параметры&quot;">​</a> </h4><ul><li><strong>buffer</strong>: Буфер, в который выполняется чтение.</li><li><strong>positionInBuffer</strong>: Позиция в целевом буфере, начиная с которой требуется записывать данные из потока.</li><li><strong>number</strong>: Количество байт, которые требуется записать в целевой буфер.</li></ul><h4 id="возвращаемое-значение-1" tabindex="-1">Возвращаемое значение <a href="#возвращаемое-значение-1" aria-label="Permalink to &quot;Возвращаемое значение&quot;">​</a> </h4><p>Возвращает число прочитанных байт</p><h3 id="размер-size" tabindex="-1">Размер / Size <a href="#размер-size" aria-label="Permalink to &quot;Размер / Size&quot;">​</a> </h3><p>Получает размер данных в байтах.</p><h3 id="сброситьбуферы-flush" tabindex="-1">СброситьБуферы / Flush <a href="#сброситьбуферы-flush" aria-label="Permalink to &quot;СброситьБуферы / Flush&quot;">​</a> </h3><p>Сбрасывает все промежуточные буферы и производит запись всех незаписанных данных в целевое устройство.</p><h3 id="текущаяпозиция-currentposition" tabindex="-1">ТекущаяПозиция / CurrentPosition <a href="#текущаяпозиция-currentposition" aria-label="Permalink to &quot;ТекущаяПозиция / CurrentPosition&quot;">​</a> </h3><p>Возвращает текущую позицию в потоке.</p><h4 id="возвращаемое-значение-2" tabindex="-1">Возвращаемое значение <a href="#возвращаемое-значение-2" aria-label="Permalink to &quot;Возвращаемое значение&quot;">​</a> </h4><p>Числовым типом может быть представлено любое десятичное число. Над данными числового типа определены основные арифметические операции: сложение, вычитание, умножение и деление. Максимально допустимая разрядность числа 38 знаков.</p><h3 id="установитьразмер-setsize" tabindex="-1">УстановитьРазмер / SetSize <a href="#установитьразмер-setsize" aria-label="Permalink to &quot;УстановитьРазмер / SetSize&quot;">​</a> </h3><p>Устанавливает размер потока. Если текущий размер превышает заданный, поток будет сокращен до заданного размера, а информация, превышающая заданный размер, будет потеряна. Если текущий размер потока меньше заданного, то содержимое потока между старым и новым размером не определено.</p><h4 id="параметры-4" tabindex="-1">Параметры <a href="#параметры-4" aria-label="Permalink to &quot;Параметры&quot;">​</a> </h4><ul><li><strong>size</strong>: Устанавливаемый размер потока.</li></ul><h2 id="конструкторы" tabindex="-1">Конструкторы <a href="#конструкторы" aria-label="Permalink to &quot;Конструкторы&quot;">​</a> </h2><h3 id="с-указанием-режима-открытия" tabindex="-1">С указанием режима открытия <a href="#с-указанием-режима-открытия" aria-label="Permalink to &quot;С указанием режима открытия&quot;">​</a> </h3><h3 id="с-указанием-режима-открытия-и-уровня-доступа" tabindex="-1">С указанием режима открытия и уровня доступа <a href="#с-указанием-режима-открытия-и-уровня-доступа" aria-label="Permalink to &quot;С указанием режима открытия и уровня доступа&quot;">​</a> </h3>',70)]))}const m=e(l,[["render",o]]);export{p as __pageData,m as default};
</div><div class="naked_ctrl">
<form action="/index.cgi/contrast" method="get" name="gate">
<p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="https://oscript.io/assets/syntax_FileStream.md.BDJ8HIAz.lean.js">(-&gt;オリジナル)</a>
/ <label>アドレス: <input type="text" name="naked_post_url" value="https://oscript.io/assets/syntax_FileStream.md.BDJ8HIAz.lean.js" size="22" /></label> <label>モード: <select name="naked_post_mode">
<option value="default">デフォルト</option>
<option value="speech">音声ブラウザ</option>
<option value="ruby">ルビ付き</option>
<option value="contrast" selected="selected">配色反転</option>
<option value="larger-text">文字拡大</option>
<option value="mobile">モバイル</option>
</select>
<input type="submit" value="表示" />
</p>
</form>
</div>