Изчитане на редове от стандартния вход и запазване в променлива — индексиран
низ.
Прочитане на редове от стандартния вход, които след това се запазват в
променливата МАСИВ. Когато е дадена опцията „-u“, се чете от
ФАЙЛов_ДЕСКРиптор. Стандартното име на променливата-масив е MAPFILE.
Опции:
-d РАЗДЕЛИТЕЛ РАЗДЕЛяне на редовете с този знак, а не с нов ред
-n МАКС_РЕДА Изчитане на не повече от МАКСимум РЕДа. Ако е 0, се
прочитат всички редове
-O НАЧАЛО Присвояването да започне при индекс НАЧАЛО в МАСИВа
Стандартната стойност е 0
-s БРОЙ_ПРОП Прескачане на първите БРОЙ за ПРОПускане прочетени реда
-t Премахване на последващия знак-РАЗДЕЛител от всеки ред
(стандартно е знакът за нов ред)
-u ФАЙЛов_ДЕСКРиптор
Изчитане на редовете от ФАЙЛов_ДЕСКРиптор, а не стандартния
вход
-C ФУНКЦИЯ Функция, която се извиква при изчитането на всеки БРОЙ_РЕДА
-c БРОЙ_РЕДА Редове, които да се изчетат преди да се извика ФУНКЦИЯта
Аргументи:
МАСИВ Име на променливата-масив
Ако опцията „-C“ е зададена без „-c“, стандартния БРОЙ_РЕДА е 5000. При
извикването на ФУНКЦИЯта за аргументи ѝ се подават индекса на следващия
елемент от масива и реда, който се счита за стойност.
Ако не е дадено изрично НАЧАЛО, командата „mapfile“ изчиства МАСИВа, преди
да започне присвояването към него.
Изходен код:
Връща 0, освен ако е дадена неправилна опция или ако МАСИВът е променлива
само за четене или не е индексиран масив.