NEWFORM(1)

НАЗВАНИЕ
newform - изменение формата текстового файла

СИНТАКСИС


newform  [-s] [-iспециф_табул] [-oспециф_табул] [-b[число_символов]]

         [-e[число_символов]] [-p[число_символов]] [-a[число_символов]]

         [-f] [-cсимвол] [-l[длина]] [файл ...]

ОПИСАНИЕ
Команда newform читает строки из указанных файлов или, если файлы не заданы, со стандартного ввода, выполняет переформатирование этих строк и помещает результат на стандартный вывод. Переформатирование происходит в соответствии с заданными в командной строке опциями.

Все опции, кроме -s, могут появляться в командной строке в любом порядке, повторяться, между ними могут вклиниваться имена файлов. Обработка опций осуществляется в том порядке, в каком они заданы. Это означает, например, что результаты форматирования для последовательности опций -e15 -l60 отличны от результатов для последовательности -l60 -e15. Опции применяются ко всем файлам, имена которых присутствуют в командной строке.

-s

Начальные символы каждой строки, вплоть до первого символа табуляции, отсекаются и в количестве, не превышающем 8, помещаются в конец строки. Если отсечено более 8 символов (не считая табуляции), то 8-й символ заменяется на *, а последующие символы отбрасываются. Первый символ табуляции отбрасывается всегда.

Если эта опция применяется к файлу, в котором хотя бы одна строка не содержит символа табуляции, то выдается сообщение об ошибке и происходит выход из программы. Программа хранит отсеченные символы, пока к данной строке не будут применены все опции. После этого хранимые символы присоединяются к концу обработанной строки.

Рассмотрим в качестве примера файл f1, каждая строка которого начинается с последовательности цифр, а далее следует один или несколько символов табуляции вперемежку с текстом. Пусть требуется преобразовать его таким образом, чтобы каждая строка начиналась с текста, все символы табуляции кроме первого были заменены пробелами, длина строки была бы сначала доведена до 72 символов (путем отбрасывания лишних символов или дополнения конца строки пробелами), а начиная с 73-й позиции была размещена последовательность цифр, с которой начинается исходная строка. Это достигается выполнением команды:


   newform  -s -i -l -a -e f1

-iспециф_табул

Спецификация табуляции при вводе: символы табуляции заменяются на пробелы в соответствии с заданной спецификацией, которая воспринимается в любой из форм, описанных в tabs(1). Кроме того, специф_табул может быть задана как --, и тогда предполагается, что собственно спецификация табуляции находится в первой строке, считанной со стандартного ввода [см. fspec(4)]. Если специф_табул не задана, то принимается, что она равна -8 (значение по умолчанию). При специф_табул, равной -0, предполагается отсутствие в тексте символов табуляции; в случае их обнаружения они обрабатываются как при специф_табул, равной -1.

-oспециф_табул

Спецификация табуляции при выводе: пробелы заменяются символами табуляции в соответствии с заданной спецификацией, аналогичной по форме -iспециф_табул. Если специф_табул не задана, то принимается, что она равна -8. При специф_табул, равной -0, пробелы при выводе символами табуляции не заменяются.

-b[число_символов]

Отсечь от начала строки указанное число_символов в случае, если длина строки превышает номинальную (см. -l). По умолчанию (когда число_символов не указано) начальные символы отсекаются в количестве, необходимом для получения строки номинальной длины. Опцию -b можно использовать, например, для удаления порядковых номеров строк из программы на КОБОЛе (файл f2), что делается следующим образом:


   newform  -l1 -b7 f2

Использование опции -l1 обусловлено необходимостью установки номинальной длины, меньшей чем длина любой существующей строки, с тем чтобы активировать опцию -b.

-e[число_символов]

Аналогично -b с тем отличием, что символы отсекаются от конца строки.

-p[число_символов]

Добавить в начало строк с длиной, меньшей номинальной, указанное число одинаковых символов (см. -c). Если число_символов не указано, строки дополняются до номинальной длины.

-a[число_символов]

Аналогично -p с тем отличием, что пополняется конец строки.

-f

Поместить строку в формате спецификации табуляции на стандартный вывод до всех других строк. Выводимая спецификация задается последней опцией -o. Если опция -o не была указана ни разу, помещается принимаемая по умолчанию спецификация -8.

-cсимвол

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

-l[длина]

Установить номинальную длину строки. Если длина опущена, то номинальная длина строки принимается равной 72. Если опция -l не задана вовсе, то номинальная длина принимается равной 80. Следует заметить, что каждый символ табуляции и забоя рассматривается как единичный символ (для замены символов табуляции пробелами необходимо воспользоваться опцией -i).

СМ. ТАКЖЕ
csplit(1), tabs(1).
fspec(4) в Справочнике программиста.

КОДЫ ЗАВЕРШЕНИЯ


	0    Нормальное завершение.

	1    Зафиксированы ошибки.

ДИАГНОСТИКА
Появление любой диагностики означает фатальную ошибку.

usage: ...: Команда вызвана с недопустимой опцией.
not -s format: Обнаружена строка, не содержащая символа табуляции.
can't open file: Не открывается файл.
internal line too long: Строка, будучи расширена путем замены символов табуляции пробелами или иным способом, не поместилась во внутренний рабочий буфер из 512 байт.
tabspec in error: Спецификация табуляции имеет недопустимый формат или позиции табуляции заданы не в порядке возрастания.
tabspec indirection illegal: Спецификация табуляции, считанная из файла (либо со стандартного ввода), не может содержать ссылку на спецификацию в другом файле.

СЮРПРИЗЫ
Командой newform обычно отслеживают только физические символы; однако в случае опций -i и -o отслеживаются также символы забоя, чтобы символы табуляции отмечали надлежащие логические колонки.

Командой newform не выдается приглашение пользователю, если спецификация табуляции должна считываться со стандартного ввода (при использовании опций -i-- или -o--).

Если используется опция -f, а из опций -o последней была указана -o-- и ей предшествовала какая-либо из опций -i-- или -o--, то формат строки спецификации табуляции будет некорректным.