zipfile::decode

ИМЯ

zipfile::decode — доступ к zip-архивам

Содержание

• Содержание

• Краткое описание

• Описание

• API

• Ошибки, идеи, отзывы

• Категория

• Авторские права

КРАТКОЕ ОПИСАНИЕ

package require Tcl 8.5 9
package require fileutil::decode 0.2.1
package require Trf
package require zlibtcl
package require zipfile::decode ?0.10.1?

::zipfile::decode::archive
::zipfile::decode::close
::zipfile::decode::comment adict
::zipfile::decode::content archive
::zipfile::decode::copyfile adict path dst
::zipfile::decode::files adict
::zipfile::decode::getfile zdict path
::zipfile::decode::hasfile adict path
::zipfile::decode::filesize zdict path
::zipfile::decode::filecomment zdict path
::zipfile::decode::iszip archive
::zipfile::decode::open archive
::zipfile::decode::unzip adict dstdir
::zipfile::decode::unzipfile archive dstdir

ОПИСАНИЕ

Примечание: пакеты Trf и zlibtcl не требуются, если доступен TCL 8.6. Этот пакет предоставляет команды для распаковки и доступа к содержимому zip-архивов.

API

• ::zipfile::decode::archive

  Эта команда декодирует последний открытый (и ещё не закрытый) файл zip-архива. Результатом команды является словарь, описывающий содержимое архива. Структура этого словаря не является общедоступной. Для корректного доступа следует использовать предоставленные в этом пакете команды-аксессоры.

• ::zipfile::decode::close

  Эта команда освобождает всё состояние, связанное с последним вызовом ::zipfile::decode::open. Результатом команды является пустая строка.

• ::zipfile::decode::comment adict

  Эта команда принимает словарь, описывающий текущий открытый файл zip-архива, возвращаемый командой ::zipfile::decode::archive, и возвращает общий комментарий архива.

• ::zipfile::decode::content archive

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

• ::zipfile::decode::copyfile adict path dst

  Эта команда принимает словарь, описывающий текущий открытый файл zip-архива, возвращаемый командой ::zipfile::decode::archive, и копирует распакованное содержимое файла path из архива в файл dst. Если файл не найден в архиве, возникает ошибка.

• ::zipfile::decode::files adict

  Эта команда принимает словарь, описывающий текущий открытый файл zip-архива, возвращаемый командой ::zipfile::decode::archive, и возвращает список файлов, найденных в архиве.

• ::zipfile::decode::getfile zdict path

  Эта команда принимает словарь, описывающий текущий открытый файл zip-архива, возвращаемый командой ::zipfile::decode::archive, и возвращает распакованное содержимое файла path в архиве. Если файл не найден в архиве, возникает ошибка.

• ::zipfile::decode::hasfile adict path

  Эта команда принимает словарь, описывающий текущий открытый файл zip-архива, возвращаемый командой ::zipfile::decode::archive, и проверяет, есть ли в архиве указанный путь path. Результатом команды является логическое значение: true, если путь найден, и false в противном случае.

• ::zipfile::decode::filesize zdict path

  Эта команда принимает словарь, описывающий текущий открытый файл zip-архива, возвращаемый командой ::zipfile::decode::archive, и возвращает распакованный размер файла path в архиве. Если файл не найден в архиве, возникает ошибка.

• ::zipfile::decode::filecomment zdict path

  Эта команда принимает словарь, описывающий текущий открытый файл zip-архива, возвращаемый командой ::zipfile::decode::archive, и возвращает комментарий к файлу path в архиве. Если файл не найден в архиве, возникает ошибка.

• ::zipfile::decode::iszip archive

  Эта команда принимает путь к файлу, который предположительно является zip-archive, и возвращает логическое значение, указывающее, действительно ли это zip-архив (true) или нет (false).

• ::zipfile::decode::open archive

  Эта команда принимает путь к файлу zip-archive и подготавливает его к декодированию. Результатом команды является пустая строка. Вся важная информация сохраняется в глобальном состоянии. Если выполнить несколько вызовов open подряд, другим командам будет доступно только состояние последнего вызова.

• ::zipfile::decode::unzip adict dstdir

  Эта команда принимает словарь, описывающий текущий открытый файл zip-архива, возвращаемый командой ::zipfile::decode::archive, и распаковывает архив в указанный целевой каталог dstdir. Результатом команды является пустая строка.

• ::zipfile::decode::unzipfile archive dstdir

  Эта вспомогательная команда распаковывает указанный файл zip-archive в целевой каталог dstdir.

  Результатом команды является пустая строка.

ОШИБКИ, ИДЕИ, ОТЗЫВЫ

В этом документе и описываемом в нём пакете, несомненно, есть ошибки и другие проблемы. Сообщайте о них в категории zipfile в системе отслеживания ошибок Tcllib. Также сообщайте о любых идеях по улучшению пакета и/или документации.

Предлагая изменения кода, пожалуйста, предоставляйте унифицированные diff-файлы, то есть результат выполнения diff -u.

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

КАТЕГОРИЯ

Файл

АВТОРСКИЕ ПРАВА

Авторские права © 2008-2022 Andreas Kupries