Логотип

Документация по макросам и шаблонам UMI.CMS

system getSize()

Название

%system getSize()% — Выводит размер файла filePath.

Параметры: %system getSize(filePath [, dimension = 'B', precision = '0'] )%

filePath

Путь к файлу в файловой системе, размер которого необходимо вывести.

dimension

Задает единицы измерения, в которых необходимо вывести размер файла. Допустимые значения: «B» (байты), «K» (килобайты), «M» (мегабайты), «G» (гигабайты). По умолчанию выводится размер в байтах.

precision

Количество знаков после запятой. По умолчанию этот параметр равен «0».

Описание

Макрос выводит на страницу размер файла filePath в единицах dimension и с точностью precision знаков после запятой.

Если файл filePath не существует, то макрос ничего не выведет

Дополнительные сведения

Для большинства задач можно использовать протокол UFS (см. «Файловая система: протокол UFS»).

Пример вызова

udata://system/getSize/(files/banner600x90.gif)/(K)/2

XML-ответ UData

<udata module="system" method="getSize" generation-time="0.000407">1.35</udata>

Примеры использования

Вывести размер картинки в килобайтах:

%system getSize('./images/cms/admin/mac/trash_restore.gif', 'K', 5)% Кб"