<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.dio-open" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>dio_open</refname>

<refpurpose>

Открывает или создаёт файл на уровне ниже,

чем потоковые функции ввода-вывода библиотеки языка C

</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>resource</type><methodname>dio_open</methodname>

<methodparam><type>string</type><parameter>filename</parameter></methodparam>

<methodparam><type>int</type><parameter>flags</parameter></methodparam>

<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>

</methodsynopsis>

<para>

Функция <function>dio_open</function> открывает файл и возвращает файловый дескриптор.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>filename</parameter></term>

<listitem>

<para>

Путь к файлу, который требуется открыть.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>flags</parameter></term>

<listitem>

<para>

Параметр <parameter>flags</parameter> принимает объединённую побитовым оператором ИЛИ

комбинацию следующих флагов. В комбинацию <emphasis>обязательно</emphasis> включают

константу <constant>O_RDONLY</constant>, <constant>O_WRONLY</constant>

или <constant>O_RDWR</constant> и дополнительно указывают

произвольную комбинацию других флагов из списка.

<itemizedlist>

<listitem>

<para>

<constant>O_RDONLY</constant> — открыть файл на чтение.

</para>

</listitem>

<listitem>

<para>

<constant>O_WRONLY</constant> — открыть файл на запись.

</para>

</listitem>

<listitem>

<para>

<constant>O_RDWR</constant> — открыть файл на чтение и запись.

</para>

</listitem>

<listitem>

<para>

<constant>O_CREAT</constant> — создать файл, если не существует.

</para>

</listitem>

<listitem>

<para>

<constant>O_EXCL</constant> — функция <function>dio_open</function> выдаст ошибку,

если установили флаги <constant>O_CREAT</constant>

и <constant>O_EXCL</constant>, и файл существует.

</para>

</listitem>

<listitem>

<para>

<constant>O_TRUNC</constant> — при открытии существующего файла на запись

функция усечёт файл до нулевой длины.

</para>

</listitem>

<listitem>

<para>

<constant>O_APPEND</constant> — запись в конец файла.

</para>

</listitem>

<listitem>

<para>

<constant>O_NONBLOCK</constant> — установить неблокирующий режим.

</para>

</listitem>

<listitem>

<para>

<constant>O_NOCTTY</constant> — запрещает операционной системе

назначать открытый файл как терминал контроля процесса,

если открыли файл устройства TTY.

</para>

</listitem>

</itemizedlist>

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>mode</parameter></term>

<listitem>

<para>

При передаче в параметр <parameter>flags</parameter>

значения <constant>O_CREAT</constant> параметр <parameter>mode</parameter> установит для файла

права доступа с учётом системных ограничений на установку прав для вновь создаваемых файлов.

Параметр <parameter>mode</parameter> требуется для правильной работы функции

при передаче в параметр <parameter>flags</parameter>

значения <constant>O_CREAT</constant>, а в остальных случаях игнорируется.

</para>

<para>

Фактические разрешения, которые назначаются вновь созданному файлу,

стандартно зависят от настройки маски прав доступа <emphasis>umask</emphasis> для процесса.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Функция возвращает дескриптор файла или &false;, если возникла ошибка.

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<example>

<title>Пример открытия файлового дескриптора</title>

<programlisting role="php">

</programlisting>

</example>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>dio_close</function></member>

</simplelist>

</para>

</refsect1>

</refentry>