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

FreeBSD Manual Pages

  
 
  

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, dec-
       imal, or	hexadecimal. Signed integers may be written out	only in	binary
       or decimal.  Floating 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(exadeci-
	      mal), 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 delimita-
	      tion is not enabled, floating point numbers will have a  decimal
	      point  and  no  separation  of groups, integers no delimiters at
	      all. With	this option, the decimal separator will	be chosen  ac-
	      cording to the locale (which, for	example, may make it a comma),
	      and non-fractional digits	will be	grouped	and separated  accord-
	      ing  to the rules	for the	locale in force. For American English,
	      this means groups	of three digits	separated 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 us-
	      age 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 exam-
	      ple, if the input	is 0x2A	and a decimal value is called for,  an
	      INPUT ERROR will be returned since 0x2A is not a valid represen-
	      tation of	a decimal integer.

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

LICENSE
       GNU General Public License, version 3

SEE ALSO
       ascii2binary(1)

				  July,	2010		       binary2ascii(1)

NAME | SYNOPSIS | DESCRIPTION | COMMAND LINE FLAGS | INPUT TYPES | EXIT STATUS | AUTHOR | LICENSE | SEE ALSO

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

home | help