getln

Read a line from the buffer stack into a variable

$ getln [variable_name]

$ getln line && echo $line

getln name [name ...]

getln is a zsh builtin that reads the top entry from the shell's buffer stack and assigns it to the named variable. The buffer stack is a LIFO (last-in, first-out) data structure where lines can be pushed using print -z or pushln and later retrieved with getln.
If multiple variable names are given, the line is split into words and assigned to each variable in order, similar to read.
The buffer stack is typically used for programmatic input manipulation, where a script prepares command lines to be executed or processed later.

Only available in zsh. The buffer stack is a zsh-specific feature not found in other shells. If the buffer stack is empty, getln will assign an empty string. The buffer stack is separate from the command history.

getln is part of zsh's buffer stack mechanism, a unique feature of the Z Shell that allows programmatic queuing and retrieval of text lines within the shell environment.

pushln(1), print(1), read(1), zsh(1)