Этот плагин предоставляет простую возможность построить из файла с данными
массив ссылок на хеши, каждый из которых представляет запись данных
известной структуры.
[% USE datafile(filename) %]
Необходимо указать абсолютный путь к файлу (по крайней мере - в начальной
реализации - в будущей версии возможно можно будет использовать INCLUDE_PATH).
Необязательный аргумент 'delim' можно использовать для задания альтернативного
символа-разделителя.
[% USE userlist = datafile('/path/to/file/users') %]
[% USE things = datafile('items', delim = '|') %]
Формат файла предельно прост. Первая строка определяет имена полей,
разделенных двоеточиями (вокруг двоеточий возможно использование
пробелов). Следующие строки определяют записи, содержащие элементы
данных, также разделенные двоеточиями, например:
id : name : email : tel
abw : Andy Wardley : abw@cre.canon.co.uk : 555-1234
neilb : Neil Bowers : neilb@cre.canon.co.uk : 555-9876
Каждая строка читается, разбивается на составляющие поля и затем
используется для инициализации хеша, использующего в качестве ключей
соответствующие имена полей. Плагин возвращает приведенную (blessed)
ссылку на массив, содержащий ссылки на хеши в порядке, определенном
в файле.
[% FOREACH user = userlist %]
[% user.id %]: [% user.name %]
[% END %]
Первая строка файла должна содержать определения полей. После
первой строки пустые строки будут игнорироваться, равно как и строки
комментариев, начинающиеся с символа '#'.
|