SED(1)                  Справочник основных команд FreeBSD                 SED(1)

НАЗВАНИЕ
	sed - потоковый редактор

СИНТАКСИС
	sed [-Ealn] command [file ...]
	sed [-Ealn] [-e command] [-f command_file] [-i extension] [file ...]

ОПИСАНИЕ
	Утилита sed читает указанный файл, либо стандартный ввод, если файл не
	указан, модифицирует ввод,как указано в списке команд. Затем, вход 
	пишется на стандартный выход.

	Одна команда может быть указана, как первый аргумент sed. Множественные
	команды могут быть указаны использованием опций -e или -f. Все команды 
	применяются в порядке их указания, вне зависимости от их происхождения.

	Доступны следующие опции:

	-E	Интерпретирует регулярные выражения как расширенные (современные),
		регулярные выражения чаще, чем основные регулярные выражения.
		Страница документации наre_format(7) полностью описывает оба 
		формата.

	-a	Файлы перечисленные как параметры функции ``w'' создаются 
		(или удаляются)прежде, чем начнется процесс по умолчанию. Опция -a
		заставляет sed откладывать открытие каждого файла до тех пор, пока
		команда содержащая связную функцию ``w'' не применяется к строке
		ввода.

	-e command
		Добавляет команды редактирования определенные аргументом command,
		к списку команд

	-f command_file
		Добавляет команды редактирования найденные в файле command_file к
		списку команд. Каждая команда редактирования должна быть
		перечислена в отдельной строке.

	-i extension
		Редактирует файлы с замещением, сохраняя резервную копию с 
		указанным расширением. Если расширение не указано (нулевой длины),
		резервная копия не будет сохраняться. Не рекомендуется присваивать
		нулевое расширение к замещаемым файлам, поскольку вы рискуете
		полностью или частично повредить файл, когда место на диске
		исчерпано.

	-l	Cоздает буфер выходных строк.

	-n	По умолчанию, каждая линия ввода выводиться на стандартный вывод,
		после того как были применены все команды. Опция -n отменяет это
		поведение.

	Форма команд sed следующая:

		[address[,address]]function[arguments]

	Пробелы (whitespaces) могут быть вставлены до первого адреса и частями
	функции команды.

	Обычно sed циклически копирует строку ввода, не включая завершающий символ
	новойстроки, в шаблон пробелов, (до тех пор, пока кто-нибудь не оставит
	``D'' функцию) применяет все команды с адресами которые выбрали этот
	шаблон, копирует шаблон на стандартный вывод, добавляя символ новой строки
	и удаляя шаблон.

	Некоторые функции используют hold space, для сохранения всего или части
	шаблона для последующего поиска.

Адреса Sed
	Адрес не обязателен, но если он указан, то адрес должен являться номером
	(который считает строки входных файлов), знаком доллара ('$'), который
	указывает на последнюю введенную строку или контекстный адрес (который
	содержит регулярное выражение, которому предшествует, и следует за ним,
	разделитель).

	Командная строка без адресов выбирает каждый шаблон.Командная строка с
	одним адресом выбирает все шаблоны, которые совпадают с адресом.

	Командная строка с двумя адресами выбирает включительный диапазон.
	Диапазон начинается с первого шаблона который совпадает с первым адресом.
	Конец диапазона следующий шаблон, который совпадает со вторым адресом.
	Если номер второго адреса равно или меньше номера строки первого, в таком
	случае эта строка будет выбрана. В случае, когда второй адрес - 
	контекстный адрес, sed не производит повторногосравнения второго адреса
	с шаблоном, который совпадает с первым адресом. Начиная с первой строки,
	сопровождаемой выбранным диапазоном, sed начинает поиск первого адреса
	снова.

	Редактирование команд может применяться к невыбранным шаблонам, через
	использование символа (``!'').

Регулярные выражения sed
	Регулярные выражения используемые в sed, по умолчанию, являются основными
	регулярными выражениями (смотрите re_format(7), для более детальной
	информации), но вместо них могут использоваться раширенные (новые)
	регулярные выражения, если будет использован флаг -E.Вдобавок, sed имеет
	следующие дополнения к регулярным выражениям:

	1.	В контекстном адресе, любой символ отличный от обратного слеша
		(``\'') или символа новой строки, может использоваться для
		разграничения регулярного выражения. Так же, использование
		обратного слеша перед разграничительным символом, заставляет
		символ являться литерой. Например, в контекстном адресе
		\xabc\xdefx,разграничивающим символом в регулярном выражении
		является ``x'', второй ``x'' будет являться литерой, поэтому
		регулярное выражение будет ``abcxdef''.

	2.	Последовательности \n совпадает с символом новой строки,
		встроенным в шаблон. Вы не можете использовать литеры символа
		новой строки в адресе, или команде подмены.

	Единственной особенностью, присущей регулярным выражениям sed, является
	особенность быть, по умолчанию, по отношению к последему используемому
	регулярному выражению. Если регулярное выражение пустое, то есть, только
	указан разграничивающий символ, в таком случае будет использовано
	последнее использовавшееся регулярное выражение. Последнее регулярное
	выражение определяется как последнее использовавшееся регулярное
	выражение, как часть адреса или команды подмены, во время запуска, а не
	во время компиляции. Например, команда ``/abc/s//XXX/'' заменит ``XXX''
	на шаблон ``abc''.

Функции sed
	В следующем списке команд, максимальное количество разрешенных адресов
	для каждой команды показывается как [0addr], [1addr], или [2addr],
	представляя ноль, один или два адреса. Аргумент text содержит одну или
	более строк. Что бы включить символ новой строки в текст, поставьте
	перед ним символ обратного слеша. Другие символы обратного слеша в
	тексте удаляются и следующие за ними символы рассматриваются как литеры.

	Функции ``r'' и ``w'' берут опциональный параметр файла, который должен
	быть отделен от функционального символа пробелом (whitespace). Каждый
	файл, заданный как аргумент для sed'а, создается (или содержимое его
	урезается) прежде, чем начнется любая обработка ввода.

	Функции ``b'', ``r'', ``s'', ``t'', ``w'', ``y'', ``!'', и ``:''
	принимают дополнительные аргументы. Следующий пример показывает, какие
	аргументы должны быть отделены из символов функций, пробелами
	(whitespaces).

	Две функции составляют список функций. Список функций sed разделяется
	символами новой строки, как показано в следующим примере:

		{ function
		  function
		  ...
		  function
		}

	``{'' может предворяться пробелом и сопровождаться пробелом. Функции
	могут предворяться пробелом. Звершающая ``}'' может пердворяться
	символом новой строки или пробелом.

	[2addr] function-list
		Запускает список функций только, когда выбран шаблон.

	[1addr]a\
	text	Записывает text в стандартный вывод незамедлительно, до
		попыток прочитать строку ввода, используется ли функция
		``N'' или начинается новый цикл.

	[2addr]b[label]
		Разветвляет функцию ``:'' определенным лейблом. Если
		лейбл не указан, разветвление происходит в конце скрипта.

	[2addr]c\
	text	Удаляет шаблон. С 0 или 1 адреса, или диапазон 2 адресов,
		text выводится на стандартный вывод.

	[2addr]d
		Удаляет шаблон и начинает новый цикл.

	[2addr]D
		Удаляет начальный сегмент шаблона через первый символ
		новой строки и начинает новый цикл.

	[2addr]g
		Заменяет содержимое шаблона содержимым hold space.

	[2addr]G
		Добавляет символ новой строки, сопровождаемый содержимым
		hold space.

	[2addr]h
		Замещает содержимое hold space, сождержимым шаблона.

	[2addr]H
		Добавляет символ новой строки, сопровождаемы содержимым
		шаблона

	[1addr]i\
	text	Записывает text на стандартный вывод.

	[2addr]l
		(Буква эль). Записывает шаблон на стандартный вывод в
		визуально однозначной форме. Эта форма следующая:

			обратный слэш 		\\
			сигнал 			\a
			form-feed 		\f
			возврат каретки		\r
			табуляция			\t
			вертикальня табуляция	\v

		Непечатные символы записываются, как трехзначные
		восмеричные номера (предваряемые обратным слешем) для
		каждого байта в символе (наиболее важные байты сначала).
		Длинные строки переносятся с указанием точки переноса в
		виде обратного слеша сопровождаемого символом новой
		строки. Конец каждой строки указан символом ``$''.

	[2addr]n
		Записывает шаблон на стандартный вывод если вывод по
		умолчанию не был переопределен, и заменяте шаблон
		следующей строкой ввода.

	[2addr]N
		Добавляет следующую строку к шаблону, используя
		встроенный символ новой строки, для разделения
		добавляемого материала от оригинального содержимого.

	[2addr]p
		Записывает шаблон на стандартный вывод.

	[2addr]P
		Записывает шаблон до первого символа новой строки,
		на стандартный вывод.

	[1addr]q
		Разветвляет конец скрипта и выходит без загрузки
		нового цикла.

	[1addr]r file
		Копирует содержимое file на стандартный вывод сразу
		же, прежде чем произойдет следующая попытка чтения
		строки. Если file не может быть прочитан, по любой
		причине, он тихо игнорируется и состояние ошибки
		не устанавливается.

	[2addr]s/regular expression/replacement/flags
		Подменяет, замещаемую строку, первым регулярным
		выражением в шаблоне. Любой символ отличный от
		обратного слеша или символа новой строки может быть
		использован вместо обратного слеша или символа новой
		строки, вместо слеша, что бы разделить регулярное
		выражение и замещение. Внутри регулярного выражения
		и замещения, разделитель регулярных выражений сам
		может быть использован как литера, если он предварен
		обратным слешем.

		Амперсанд (``&'') появляется в замене, если замещаемая
		строка совпадает с регулярным выражением. Особое значение
		``&'' в этом контексте может быть изменено, предварением
		амперсанда обратным слешем. Строка ``\#'', где ``#'' цифра,
		которая замещается текстом совпавшим с передачей обратного
		выражения.

		Строка может быть разделена добавлением символа новой строки
		в нее. Для определения символа новой строки в замещаемой
		строке, предварите ее обратным слешем.

		Значение flags в заменяемой функции - ноль или одна из
		следующих:
			N	Создавать замену только для N' повторений
				регулярного выражения в шаблоне.

			g	Создавать замену для всех неперекрывающих
				совпадений регулярного выражения,не только
				для первого.

			p	Записывать шаблон на стандартный вывод,
				если сделано замещение. Если замещаемая
				строка совпадает с замещаемой, она все еще
				расценивается как замещение.

			w	Добавляет шаблон к file если замещение
				произошло. Если замещаемая строка совпадает
				с замещаемой, она все еще расценивается как
				замещение.

	[2addr]t [label]
		Разветвление функции ``:'' лейбл, если любая замена была
		сделана с момента нового чтения строки ввода или запуска
		функции ``t''. Если лейбл не определен,разветвление идет до
		конца скрипта.

	[2addr]w file
		Добавляет шаблон к file.

	[2addr]x
		Меняет содержимое шаблона и hold spaces.

	[2addr]y/string1/string2/
		Замещает все повторения символа в string1 в шаблоне с
		соответствующими символами из string2. Любой символ, отличный
		от обратного слеша или символа новой строки может
		использоваться вместо обратного слеша или символа новой строки
		для разделения строк. Внутри string1 и string2 обратный слеш
		сопровождается любым символам отличным от символа новой строки,
		который является литерой и обратный слеш сопровождаемый ``n''
		замещается символом новой строки.

	[2addr]!function
	[2addr]!function-list
		Применяет функцию или список функций только для строк которые
		не выбраны адресом.

	[0addr]:label
		Эта функция ничего не делает, она вызывает лейбл в котором 
		команды ``b'' и ``t'' могут разветвляться.

	[1addr]=
		Записывает номер строки на стандартный вывод спопровождаемый
		символом новой строки.

	[0addr]
		Игнорирует пустые строки.

	[0addr]#
		``#'' и остаток строки игнорируются (расценивается как
		коментарий), с единственным исключением что если первые два
		символа в файле являются ``#n'', вывод по умолчанию
		подавляется. То же самое, что и определение опции -n в
		командной строке.

ОКРУЖЕНИЕ
	Переменные COLUMNS, LANG, LC_ALL, LC_CTYPE и LC_COLLATE препятствуют
	запуску sed ,как описано в environ(7).

СОСТОЯНИЕ ВЫХОДА
	Утилита sed выходит с установкой 0 если выход прошел успешно, и >0
	если возникли

СМОТРИ ТАКЖЕ
	awk(1), ed(1), grep(1), regex(3), re_format(7)

СТАНДАРТ
	Утилита sed, как ожидается, будет в наборе спецификаций EEE Std 1003.2
	(``POSIX.2'')

	Опции -E, -a и -i не стандартны для расширений FreeBSD и могут быть
	недоступны для других операционных систем.

ИСТОРИЯ
	Команда sed написана L. E. McMahon, появилась в Version 7 AT&T UNIX.

ОШИБКИ
	Мультибайтовые символы, содержащие значение 0x5C (ASCII `\') могут быть
	распознаны некорректно как продолжение символов строки в аргументах
	команд `a'', ``c'' и ``i''. Мультибайтовые символы не могут
	использоваться как разделители с командами ``s'' и ``y''.

FreeBSD 6.2                      10 Мая, 2005                      FreeBSD 6.2