989d921f5d
I'm very pleased to announce the release of our new website and documentation using the new toolchain with Hugo and AsciiDoctor. To get more information about the new toolchain please read the FreeBSD Documentation Project Primer[1], Hugo docs[2] and AsciiDoctor docs[3]. Acknowledgment: Benedict Reuschling <bcr@> Glen Barber <gjb@> Hiroki Sato <hrs@> Li-Wen Hsu <lwhsu@> Sean Chittenden <seanc@> The FreeBSD Foundation [1] https://docs.FreeBSD.org/en/books/fdp-primer/ [2] https://gohugo.io/documentation/ [3] https://docs.asciidoctor.org/home/ Approved by: doceng, core
76 lines
2.5 KiB
Groff
76 lines
2.5 KiB
Groff
.\"----------------------------------------------------------------------------
|
||
.\" "THE BEER-WARE LICENSE" (Revision 42):
|
||
.\" <phk@FreeBSD.org> wrote this file. As long as you retain this notice, you
|
||
.\" can do whatever you want with this file. If we meet some day, and you think
|
||
.\" this stuff is worth it, you can buy me a beer in return. Poul-Henning Kamp
|
||
.\" ---------------------------------------------------------------------------
|
||
.\"
|
||
.\" %FreeBSD: src/usr.bin/file2c/file2c.1,v 1.13.2.1 2007/11/14 19:24:10 ru Exp %
|
||
.\" $FreeBSDru: frdp/doc/ru_RU.KOI8-R/man/man1/file2c.1,v 1.4 2007/11/16 11:31:27 ru Exp $
|
||
.\" $FreeBSD$
|
||
.\"
|
||
.Dd 22 марта 2007
|
||
.Dt FILE2C 1
|
||
.Os
|
||
.Sh НАЗВАНИЕ
|
||
.Nm file2c
|
||
.Nd превратить файл в исходник C
|
||
.Sh СИНТАКСИС
|
||
.Nm
|
||
.Op Fl sx
|
||
.Op Fl n Ar число
|
||
.Op Ar префикс Op Ar суффикс
|
||
.Sh ОПИСАНИЕ
|
||
Утилита
|
||
.Nm
|
||
читает файл из стандартного ввода и пишет его в стандартный вывод, на лету
|
||
превращая каждый байт в его десятичное или шестнадцатеричное представление.
|
||
Значения байт разделяются запятыми.
|
||
За значением последнего байта запятой не следует.
|
||
По умолчанию значения байт выводятся в десятичном виде, но если указана опция
|
||
.Fl x ,
|
||
значения будут выведены в шестнадцатеричном виде.
|
||
Если указана опция
|
||
.Fl s ,
|
||
в начале каждой строки будет выведен символ табуляции, и после каждой
|
||
запятой будет напечатан пробел, кроме последней запятой в строке.
|
||
.Pp
|
||
При выводе свыше 70 знаков на строку, эта строка
|
||
завершается и вывод продолжается со следующей строки.
|
||
Опция
|
||
.Fl n
|
||
позволяет начинать новые строки через указанное количество выведенных
|
||
значений байт.
|
||
При этом длина строки не будет играть роли.
|
||
Для вывода значений всех байт на одной строке можно задать опции
|
||
.Fl n
|
||
отрицательное число.
|
||
.Pp
|
||
Префикс и суффикс могут быть выведены до и после значений байт соответственно.
|
||
Если суффикс должен быть выведен, префикс также должен быть указан.
|
||
Первое слово, не являющееся опцией \[en] префикс, за ним может следовать
|
||
слово, которое следует принять за суффикс.
|
||
.Pp
|
||
Эта программа обычно используется для включения бинарных файлов в исходники C.
|
||
Префикс используется для задания массива, а суффикс используется для завершения
|
||
выражения C.
|
||
Опции
|
||
.Fl n , s
|
||
и
|
||
.Fl x
|
||
полезны, когда бинарные данные представляют собой массив бит и вывод
|
||
должен оставаться читаемым или редактируемым.
|
||
Шрифты \[en] хороший пример такого случая.
|
||
.Sh ПРИМЕРЫ
|
||
Команда:
|
||
.Bd -literal -offset indent
|
||
date | file2c 'const char date[] = {' ',0};'
|
||
.Ed
|
||
.Pp
|
||
выведет:
|
||
.Bd -literal -offset indent
|
||
const char date[] = {
|
||
83,97,116,32,74,97,110,32,50,56,32,49,54,58,50,56,58,48,53,
|
||
32,80,83,84,32,49,57,57,53,10
|
||
,0};
|
||
.Ed
|