Main Help → All Commands → Language Reference → Lines
The Lines
command divides up a variable by lines:
Lines "(varName)",(start),(end),(expr)
where:
"(varName)"
is a valid string variable name in quotes (e.g., "#varName"), but not an array name followed by [(index)]
.(start)
and (end)
specify the range of lines to extract (first line is line number 1) or can be <=0 to specify line number relative to the end (0 is last line, -1 is next to last line, etc.).(expr)
is a string or string expression possibly containing multiple lines.When done, the results will be in the specified variable.
If the qouted variable name is "#varName"
, for example, the extracted lines will be in #varName[1]
, #varName$[2]
, etc., and the total number of lines will be stored in #varName[0]
.