FILE2C(1)               FreeBSD General Commands Manual              FILE2C(1)

NAME
     file2c - convert file to c-source

SYNOPSIS
     file2c [-sx] [-n count] [prefix [suffix]]

DESCRIPTION
     The file2c utility reads a file from stdin and writes it to stdout,
     converting each byte to its decimal or hexadecimal representation on the
     fly.  The byte values are separated by a comma.  This also means that the
     last byte value is not followed by a comma.  By default the byte values
     are printed in decimal, but when the -x option is given, the values will
     be printed in hexadecimal.  When -s option is given, each line is printed
     with a leading tab and each comma is followed by a space except for the
     last one on the line.

     If more than 70 characters are printed on the same line, that line is
     ended and the output continues on the next line.  With the -n option this
     can be made to happen after the specified number of byte values have been
     printed.  The length of the line will not be considered anymore.  To have
     all the byte values printed on the same line, give the -n option a
     negative number.

     A prefix and suffix strings can be printed before and after the byte
     values (resp.)  If a suffix is to be printed, a prefix must also be
     specified.  The first non-option word is the prefix, which may optionally
     be followed by a word that is to be used as the suffix.

     This program is typically used to embed binary files into C source files.
     The prefix is used to define an array type and the suffix is used to end
     the C statement.  The -n, -s and -x options are useful when the binary
     data represents a bitmap and the output needs to remain readable and/or
     editable.  Fonts, for example, are a good example of this.

EXAMPLES
     The command:

           date | file2c 'const char date[] = {' ',0};'

     will produce:

           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};

FreeBSD 13.1-RELEASE-p6         March 22, 2007         FreeBSD 13.1-RELEASE-p6