pr — печать файлов

НАЗВАНИЕ

pr — печать файлов

СИНТАКСИС

pr [+page] [-column] [-adFfmprt] [[-e] [char] [gap]] [-L locale]

[-h header] [[-i] [char] [gap]] [-l lines] [-o offset] [[-s] [char]]

[[-n] [char] [width]] [-w width] [-] [файл …]

ОПИСАНИЕ

Утилита pr является фильтром для разбиения на страницы и печати текстовых

файлов.  При указании нескольких входных файлов каждый из них читается,

форматируется и записывается на стандартный вывод.  По умолчанию ввод

разбивается на страницы длиной 66 строк, каждая с:

5-строчным заголовком с указанием номера страницы, даты, времени и

полного имени файла.

5-строчной нижней частью, состоящей из пустых строк.

Если стандартный вывод связан с терминалом, вывод диагностических сообще-

ний подавляется до окончания полной обработки утилитой pr.

При указании вывода в несколько столбцов, текстовые строки имеют одинако-

вую длину.  По умолчанию текстовые столбцы разделяются по крайней мере

одним <пробелом>.  Входные строки, не помещающиеся в колонку текста, усе-

каются.  Строки не усекаются при выводе в одну колонку.

ПАРАМЕТРЫ

В последующем описании параметров столбцы, строки, отступы, страницы и

ширина являются положительными десятичными целыми числами, а промежуток

выражается неотрицательным десятичным целым числом.

+page

Начать вывод со страницы номер page форматированного ввода.

-column

Формировать вывод в несколько колонок, количество которых задаётся

параметром column (по умолчанию в 1) и текст в которые помещается

вертикально в том порядке, в котором он следует во входном файле.

Предполагается использование параметров -e и -i.  Этот параметр не

должен использоваться совместно с -m.  При использовании с опцией

-t для вывода используется минимальное количество строк.  (Для раз-

биения на колонки и изменения формы вывода текстовых файлов в более

общем виде без дополнительного форматирования обратитесь к утилите

rs(1) .)

-a

Изменяет действие параметра -column таким образом, что колонки

заполняются строками со страницы по кругу.  (то есть в случае двух

колонок первая входная строка озаглавливает колонку 1, вторая

колонку 2, третья строка помещается во вторую строку колонки 1 и

так далее).  Эта опция требует использования параметра -column.

-d

Производит вывод с двойным интервалом.  Для каждого символа

<newline>, встреченного в вводе, выводится ещё один дополнительный

символ <newline>.

-e

[char][gap]

Заменяет каждый символ <tab> из входного потока перемещением на

позицию, соответствующую следующей колонке, определяемую по формуле

n*gap+1, где n — целое число > 0.  Если gap равен нулю или опущен,

то его значение по умолчанию равно 8.  Все символы <tab> во входном

потоке заменяются соответствующим количеством <пробелов>.  Если

указан любой нецифровой символ char, то он воспринимается как вход-

ной символ табуляции.

-F

Использовать последовательность <прогон страницы> для вывода новых

страниц, вместо поведения по умолчанию, при котором используется

последовательность символов <newline>.

-f

То же, что и -F, но перед началом вывода первой страницы выдержива-

ется пауза, если стандартный вывод является терминалом.

-h header

Использовать строку header для замены file name в строке заголовка.

-i [char][gap]

В выводе заменять несколько <пробелов> на символы <tab>, если два и

более соседних <пробела> достигают позиций колонок gap+1, 2*gap+1,

и так далее.  Если gap равен нулю или опущен, по умолчанию символ

<tab> связывается с каждой восьмой вертикальной позицией.  Если

указан любой нецифровой символ char, то он используется для вывода

символа <tab>.

-L locale

Использовать настройки локализации locale, указанные в качестве

параметра, вместо установленных в окружении.  Задайте «C» для

использования настроек локализации по умолчанию.

-l lines

Переопределить значение длины страницы по умолчанию 66, используя в

качестве длины значение lines.  Если значение lines не превышает

суммы длин заголовка и нижней части (в строках), то утилита pr

подавляет вывод как заголовка, так и нижней части, как при исполь-

зовании опции -t.

m

Объединить содержимое нескольких файлов.  Каждый файл из указанных

в командной строке, строчка за строчкой, выводится в отдельную

колонку текста одинаковой ширины.  Количество текстовых колонок

зависит от количества успешно открытых файлов, указанных в качестве

параметров.  Максимальное количество объединённых файлов зависит от

ширины страницы и ограничения на количество файлов, открытых одним

процессом.  Предполагается использование опций -e и -i.

-n [char][width]

Обеспечить width строк для нумерации строк.  Значение по умолчанию

для width, если оно не задано, равно 5.  Номер занимает первые

width колонок каждой текстовой колонки или каждую строку с номером

-m.  Если задаётся символ char (любой нецифровой символ), то он

добавляется к номеру строки для отделения от последующего вывода.

Символом, используемым для char по умолчанию, является <tab>.

Номера строк, превышающие width символов, отсекаются.

-o offset

Каждая строка вывода предваряется offset <пробелами>.  Если пара-

метр -o не указан, его значением по умолчанию принимается ноль.

Пробел добавляется к ширине выводимой строки.

-p

Выдерживать паузу перед каждой страницей, если стандартный вывод

является терминалом.  pr будет выдавать предупреждающий символ в

стандартный файл ошибок и ждать нажатия перевода каретки с терми-

нала.

-r

Не выдавать диагностических сообщений об ошибках открытия файлов.

-s char

Разделять колонки текста одним символом char вместо соответствую-

щего количества <пробелов> (значением по умолчанию для char явля-

ется символ <tab> ).

-t

Не печатать ни верхние пять идентификационных строк заголовка, ни

нижние пять строк, обычно выводимые на каждой странице.  Завершить

печать после последней строки каждого файла без пропуска пробелов в

конце страницы.

-w width

Установить длину строки равной width символов в столбце только для

вывода текста в несколько столбцов.  Если параметр -w не указан и

отсутствует опция -s, то длина строки по умолчанию равна 72.  Если

опция -w не указана, но указана -s, то длина строки по умолчанию

равна 512.

file

Имя файла для печати.  Если операнд file не указан, или если в

качестве file указан `-‘, то используется стандартный ввод.  Стан-

дартный ввод используется, если только не задан операнд file или

если в качестве file указан `-‘.

Опция -s не позволяет разделять символ опции от его аргумента, и опции

-e, -i, и -n требуют, чтобы оба аргумента, если они есть, не отделялись

от символа опции.

СТАТУС ЗАВЕРШЕНИЯ

Утилита pr возвращает 0 при успешном завершении работы и 1, если были

ошибки.Сообщения об ошибках выводятся в стандартный файл ошибок во время печати

(если вывод перенаправляется) или после полного успешного завершения

вывода файла (при выводе на терминал).

ДИАГНОСТИКА

Если в процессе вывода на терминал утилита pr получает прерывание, то

перед завершением работы все накопленные сообщения об ошибках сбрасыва-

ются на экран.

СМОТРИ ТАКЖЕ

cat(1), more(1), rs(1)СТАНДАРТЫ

Утилита pr соответствует стандарту IEEE Std 1003.1-2001 («POSIX.1»)

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *