Manpage of ascii2binary
Section: User Commands (1)
Updated: February, 2007
Return to Main Contents
ascii2binary - Convert ASCII numbers to binary
reads input consisting of a sequence of ASCII textual representations of numbers,
separated by whitespace, and produces as output the binary equivalents.
The type (unsigned integer, signed integer, or floating point number) and size
of the binary output is selected by means of command line flags. The default is
Input is checked both for format errors and to ensure that the number requested
can be represented in a number of the requested binary type and size.
The input formats supported are exactly those supported by
for floating point numbers, by
for signed integers, and by
for unsigned integers, except that, unlike
floating point numbers may have thousands separators.
This means that by default integers may be decimal, octal, or hexadecimal, determined by
the usual conventions. The command line flag
may be used to specify another base for integer conversions.
COMMAND LINE FLAGS
Long options may not be available on some systems.
- -b|--base <base>
set base in range [2,36] for integer conversions. The base may be either an integer or:
print help message
- -L|locale <locale>
Set the LC_NUMERIC facet of the locale to <locale>.
print sizes of types on current machine and related information
- -t|--type <type>
set type and size of output
The following are the possible output types. Note that some types may not be
available on some machines.
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
print a summary of the exit status codes.
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.
- 4 RANGE ERROR
This means that the input may be well-formed but cannot be represented
as the required type. For example, if the input is the string 983 and
ascii2binary is requested to convert this into an unsigned byte, ascii2binary
will exit with a RANGE ERROR because 983 exceeds the maximum value representable in an
unsigned byte, which is 255.
- 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 decimal integer.
Bill Poser (firstname.lastname@example.org)
GNU General Public License
binary2ascii(1), strtod(3), strtoll(3), strtoull(3)
- INPUT FORMAT
- COMMAND LINE FLAGS
- EXIT STATUS
- SEE ALSO
This document was created by
using the manual pages.
Time: 05:03:05 GMT, February 13, 2007