img_codec_list_byext()

Перечисление кодеков по расширению файла

Прототип:

#include <img.h>
                                       
size_t img_codec_list_byext( img_lib_t ilib,
                             const char *string,
                             img_codec_t *buf,
                             size_t nbuf );

Аргументы:

ilib: Дескриптор библиотеки, заполенный img_lib_attach().
string: Строка, содержащая расширение файла для идентификации. Например, jpg, для файлов с именем filename.jpg.
buf: Адрес массива, который функция заполняет дескрипторами для доступных кодеков.
nbuf: Количество элементов в массиве buf.

Описание:

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

Не существует стандартов по определению расширений и их названий. Однако, есть стандарт де-факто, регулирующий применение расширений. Термин “расширение” происходит от внутренних свойств имени файла, хотя в большинстве современных реализций расширения не рассматриваются как отдельные компоненты имени файла. Таким образом, элемент “расширение” развивался, чтобы по части символов в имени файла, следующих да последним появлением символа “.”, можно было дать его приближенное описание. Такой же принцип встречается в сети Интернет и во многих операционных системах, в которых используют расширения в качестве механизма распознавания контента. Хотя расширения не гарантируют, каким будет характер данных, содержащихся в файле, но назначаются они из хорошо известного набора и не могут в точности отразить критериев по принятию решений в применении того или иного кодека обработки данных, по крайнем мере на начальном этапе.

В массив buf копируется не более чем nbuf дескрипторов. Копирование не произвоится, если nbuf равно 0. Функция возвращает общее количество подходящих кодеков, которое может быть больше, чем nbuf, если буфер не был достаточно большим для хранения всех дескрипторов.

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

Общее количество подходящих кодеков.

Классификация:

Графическая подсистема ЗОСРВ «Нейтрино», Библиотека Image

Безопасность использования
Обработчик прерываний: Нет
Обработчик сигналов: Нет
В потоке: Нет

Тематические ссылки:

img_codec_list(), img_codec_list_bymime(), img_lib_attach()

Предыдущий раздел: Image API