Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
binary2ascii(1) 	     General Commands Manual		 binary2ascii(1)

NAME
     binary2ascii - Convert binary numbers to textual representation

SYNOPSIS
     binary2ascii [flags]

DESCRIPTION
     binary2ascii  reads input consisting of binary numbers and converts them to
     their textual representation.  Command line flags specify the type and size
     of the binary numbers and provide control over the format	of  the  output.
     Unsigned integers may be written out in binary, octal, decimal, or hexadec-
     imal. Signed integers may be written out only in binary or decimal.  Float-
     ing point numbers may be written out only in decimal, either in standard or
     scientific  notation.  (If you want to examine the binary representation of
     floating point numbers, just treat the input  as  a  sequence  of	unsigned
     characters.)

COMMAND LINE FLAGS
     Long options may not be available on some systems.

     -b,--base <base>
	    Base  for  integer	conversions: b(binary),d(ecimal), h(exadecimal),
	    o(ctal), or 2,8,10, or 16.

     -d,--delimit
	    Delimit the output as per the locale. This is the default on systems
	    in which printf(3) supports delimitation. If delimitation is not en-
	    abled, floating point numbers will have a decimal point and no sepa-
	    ration of groups, integers no delimiters at all. With  this  option,
	    the decimal separator will be chosen according to the locale (which,
	    for example, may make it a comma), and non-fractional digits will be
	    grouped  and  separated  according	to  the  rules for the locale in
	    force. For American English, this means groups of three digits sepa-
	    rated by commas, whereas for German in Germany it  means  groups  of
	    three digits separated by periods.

     -D,--do-not-delimit
	    Do not delimit the output as per the -d option.

     -e,--exponential
	    Use exponential (scientific) notation.

     -h,--help
	    print help message

     -l,--linefeed
	    add  a  linefeed  after every 0x0A value if the size is char, short,
	    int, or long, that is, the sizes that might represent a character.

     -L,locale <locale>
	    Set the LC_NUMERIC facet of the locale to <locale>.

     -n,--number <number>
	    number of items to print per line.

     -o,--offset <offset>
	    byte offset at which to start.

     -p,--precision <precision>
	    the precision to use when printing floating point numbers.

     -s,--sizes
	    print sizes of types on current machine and related information

     -t,--type <type>
	    set type and size of input

     -x,--no-hex-mark
	    do not mark hexadecimal output with the prefix 0x.

     -V,--verbose
	    be verbose.

     -v,--version
	    print version information.

     -w,--width
	    minimum field width.

     -X,--explain-exit-codes
	    print a summary of the exit status codes.

     -z,--zero-pad-integers
	    zero pad on left.

     -Z,--do-not-zero-pad-integers
	    do not zero pad on left

INPUT TYPES
     The following are the possible input types. Note that some types may not be
     available on some machines.

     d	double

     f	float

     q long double

     sc signed char

     ss signed short

     si signed int

     sl signed long

     sq signed long long

     uc unsigned char

     us unsigned short

     ui unsigned int

     ul unsigned long

     uq unsigned long long

EXIT STATUS
     The following values are returned on exit:

     0 SUCCESS
	    The input was successfully converted.

     1 INFO The user requested information such as the version number  or  usage
	    synopsis and this has been provided.

     2 SYSTEM ERROR
	    An	error resulted from a failure of the operating system such as an
	    i/o error or inability to allocate storage.

     3 COMMAND LINE ERROR
	    The program was called with invalid  or  inconsistent  command  line
	    flags.

     5 INPUT ERROR
	    This  means that the input was ill-formed, that is that it could not
	    be interpreted as a number of the required type. For example, if the
	    input is 0x2A and a decimal value is called  for,	an  INPUT  ERROR
	    will be returned since 0x2A is not a valid representation of a deci-
	    mal integer.

AUTHOR
     Bill Poser (billposer@alum.mit.edu)

LICENSE
     GNU General Public License, version 3

SEE ALSO
     ascii2binary(1)

				   July, 2010			 binary2ascii(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=binary2ascii&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help