# os.open ()

### os.open ( *path*, *flags*, *mode=0o777*, *\**, *dir\_fd=None* )

Открывает путь ***path*** к файлу и устанавливает различные флаги в соответствии с ***flags*** и, возможно, его режим в соответствии с ***mode***. Когда ***mode*** вычисляется, текущее значение umask сначала маскируется. Возвращает файловый дескриптор для вновь открытого файла. Новый дескриптор файла не наследуется.

Описание значений ***flags*** и ***mode*** см. в документации среды выполнения C; константы флагов (например, O\_RDONLY и O\_WRONLY) определены в модуле os. В частности, в Windows добавление O\_BINARY необходимо для открытия файлов в двоичном режиме.

Эта функция может поддерживать пути относительно дескрипторов каталогов с параметром ***dir\_fd***.

Вызывает событие аудита, открытое с аргументами `path`, `mode`, `flags`.

*Изменено в версии 3.4:* новый дескриптор файла теперь не наследуется.

{% hint style="info" %}
Эта функция предназначена для ввода/вывода низкого уровня. Для нормального использования используйте встроенную функцию [open ()](/python-docs/vstroennye-obekty/vstroennye-funkcii/open.md), которая возвращает объект файла с помощью методов `read ()` и `write ()` (и многих других). Чтобы обернуть файловый дескриптор в файловый объект, используйте [fdopen ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/os/sozdanie-failovogo-obekta/os.fdopen.md).
{% endhint %}

*Новое в версии 3.3:* аргумент ***dir\_fd***.

*Изменено в версии 3.5:* если системный вызов прерывается и обработчик сигнала не вызывает исключения, функция теперь повторяет системный вызов вместо того, чтобы вызывать исключение InterruptedError (объяснение см. в [PEP 475](https://www.python.org/dev/peps/pep-0475/)).

*Изменено в версии 3.6:* Принимает объект, подобный пути (*path-like object* ).

Следующие константы являются опциями для параметра ***flags*** функции [open ()](/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/os/operacii-s-failovymi-deskriptorami/os.open.md). Их можно объединить с помощью побитового оператора ИЛИ `|`. Некоторые из них доступны не на всех платформах. За описанием их доступности и использования обратитесь к странице руководства [open (2)](https://manpages.debian.org/buster/manpages-dev/open.2.en.html) в Unix или в [MSDN](https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/open-wopen?redirectedfrom=MSDN\&view=vs-2019) в Windows.

#### Эти константы доступны в Unix и Windows:

* **os.O\_RDONLY**  - открыть файл только для чтения
* **os.O\_WRONLY** - открыть файл только для записи
* **os.O\_RDWR**     - открыть файл для чтения и записи
* **os.O\_APPEND** - открыть файл в режиме добавления
* **os.O\_CREAT**    - создает файл и открывает его для записи
* **os.O\_EXCL**       - разрешает создание файла, только если он не существует
* **os.O\_TRUNC**   - открывает файл и обрезает его до нулевой длины

#### Константы, доступные только в Unix:

* os.O\_DSYNC 
* os.O\_RSYNC 
* os.O\_SYNC 
* **os.O\_NDELAY** - по возможности открывает файл в неблокирующем режиме (синоним)
* **os.O\_NONBLOCK** - по возможности открывает файл в неблокирующем режиме (синоним)
* **os.O\_NOCTTY** - процесс не станет управляющим терминалом процесса (даже если терминальное устройство tty присутствует в команде)
* **os.O\_CLOEXEC** - включает флаг закрытия при запуске нового дескриптора файла

*Изменено в версии 3.3:* Добавлена константа **O\_CLOEXEC**.

#### Константы, доступные только в Windows:

* **os.O\_BINARY** - открывает файл в двоичном режиме
* **os.O\_NOINHERIT** - предотвращает создание общего файлового дескриптора
* **os.O\_SHORT\_LIVED** - создает файл как временный и по возможности не сбрасывает на диск
* **os.O\_TEMPORARY** - создает файл как временный, файл удаляется при закрытии дескриптора
* **os.O\_RANDOM** - кеширование оптимизировано для произвольного доступа с диска
* **os.O\_SEQUENTIAL** - кеширование оптимизировано для последовательного доступа с диска
* **os.O\_TEXT** - открывает файл в текстовом режиме

#### Эти константы являются расширениями и отсутствуют, если они не определены библиотекой C:

* os.O\_ASYNC 
* os.O\_DIRECT 
* os.O\_DIRECTORY 
* os.O\_NOFOLLOW 
* os.O\_NOATIME 
* os.O\_PATH 
* os.O\_TMPFILE 
* os.O\_SHLOCK 
* os.O\_EXLOCK

*Изменено в версии 3.4:* Добавлен **O\_PATH** в системах, которые его поддерживают. Добавлен **O\_TMPFILE**, доступный только в Linux Kernel 3.11 или новее.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://treasuremaster.gitbook.io/python-docs/moduli-standartnoi-biblioteki-1/obshie-sluzhby-operacionnoi-sistemy/os/operacii-s-failovymi-deskriptorami/os.open.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.