Skip to main content

AIOFileOpen

Краткая информация

Открывает локальный или облачный дескриптор файла, поддерживающий протокол контекстного управления.

Синтаксис

AIOFileOpen(path, {mode}, {encoding}, {mime})

Параметр Объяснение Тип данных

path

The relative path from the current working directory or an absolute path (absolute vsi path for cloud).

String

mode

Specifies the mode that will be used for opening a file.

  • r—The file will be opened in read mode.

  • w—The file will be opened in write mode

  • rb—The file will be opened in binary format for reading.

  • wb—The file will be opened in binary format for writing

Примечание:

Only read mode honors the encoding parameter.

(Значение по умолчанию — 'r')

String

encoding

Specifies the encoding that will be used to open a file.

  • utf-8—UTF-8 encoding will be used. This is the default.

  • utf-16—UTF-16 encoding will be used.

  • ascii—ASCII encoding will be used.

(Значение по умолчанию — 'utf-8')

String

mime

The Multipurpose Internet Mail Extensions (MIME) headers. For faster creation and setting of metadata, set MIME headers when creating the file.

(Значение по умолчанию — None)

Dictionary

Возвращаемое значение

Тип данных Объяснение

Object

Возвращает дескриптор файла как объект AIOFile.

Пример кода

# For opening a file in the cloud store
with AIOFileOpen(r"C:\data\datacloud.acs\datafile.txt", 'r') as rcsfile:
    rcsfile.seek(5)
    rcsfile.tell()
    print(rcsfile.read(4))
# For opening a local file
with AIOFileOpen(r"C:\data\datafile.txt", 'r') as rcsfile:
    rcsfile.seek(5)
    rcsfile.tell()
    print(rcsfile.read(4))