\read

Синопсис:

\read number tomacro

Сделать команду macro содержащей следующую строку ввода из текстового потока number, как в \read5 to\data.

Это открывает файл email.tex для чтения, помещает содержимое первой строки в команду \email, а затем закрывает файл.

\newread\recipientfile
\openin\recipientfile=email
\read\recipientfile to\email
\typeout{Email address: \email}
\closein\recipientfile

Если number находится вне диапазона от 0 до 15, или если файл с таким номером не открыт, или если файл закончился, тогда \read получит ввод с терминала (или завершится, если взаимодействие запрещено, например, \nonstopmode; см. режимы взаимодействия). (Однако, естественный способ в LaTeX получить ввод с терминала — \typein (см. \typein.)

Для чтения всего файла как дополнительного LaTeX-исходного кода используйте \input (см. \input) или \include (см. \include & \includeonly).

Частая причина для чтения из файла данных — это объединение почтовых рассылок. CTAN имеет ряд пакетов для этого; один из них — datatool.