mapfile

從標(biāo)準(zhǔn)輸入讀取行并賦值到數(shù)組。

概要

mapfile [-d delim] [-n count] [-O origin] [-s count] [-t] [-u fd] [-C callback] [-c quantum] [array]

主要用途

• 從標(biāo)準(zhǔn)輸入或文件描述符讀取行并賦值到數(shù)組。

選項(xiàng)

-d delim       將delim設(shè)為行分隔符，代替默認(rèn)的換行符。
-n count       從標(biāo)準(zhǔn)輸入中獲取最多count行，如果count為零那么獲取全部。
-O origin      從數(shù)組下標(biāo)為origin的位置開(kāi)始賦值，默認(rèn)的下標(biāo)為0。
-s count       跳過(guò)對(duì)前count行的讀取。
-t             讀取時(shí)移除行分隔符delim（默認(rèn)為換行符）。
-u fd          從文件描述符fd中讀取。
-C callback    每當(dāng)讀取了quantum行時(shí)，調(diào)用callback語(yǔ)句。
-c quantum     設(shè)定讀取的行數(shù)為quantum。

如果使用-C時(shí)沒(méi)有同時(shí)使用-c指定quantum的值，那么quantum默認(rèn)為5000。
當(dāng)callback語(yǔ)句執(zhí)行時(shí)，將數(shù)組下一個(gè)要賦值的下標(biāo)以及讀取的行作為額外的參數(shù)傳遞給callback語(yǔ)句。
如果使用-O時(shí)沒(méi)有提供起始位置，那么mapfile會(huì)在實(shí)際賦值之前清空該數(shù)組。

參數(shù)

array（可選）：用于輸出的數(shù)組名稱。如果沒(méi)有指定數(shù)組名稱，那么會(huì)默認(rèn)寫(xiě)入到變量名為MAPFILE的數(shù)組中。

返回值

返回成功除非使用了非法選項(xiàng)、指定的數(shù)組是只讀的、指定的數(shù)組不是下標(biāo)數(shù)組。

例子

# 常見(jiàn)的讀取形式。
mapfile < source_file target_array
cat source_file |mapfile target_array
mapfile -u fd target_array

# 只讀取前5行。
mapfile < source_file -n 5 target_array

# 跳過(guò)前5行。
mapfile < source_file -s 5 target_array

# 在數(shù)組指定的下標(biāo)開(kāi)始賦值。
# 請(qǐng)注意：這樣做不會(huì)清空該數(shù)組。
mapfile < source_file -O 2 target_array

# 讀取時(shí)設(shè)定行分隔符為tab。
# 注意，第二行的tab在終端需要用ctrl+v tab輸入；
mapfile < source_file -d