
sprintf(3)             C LIBRARY FUNCTIONS             sprintf(3)

NAME
     printf, sprintf - formatted output conversion

SYNOPSIS
     void printf(string format, ...)
     string sprintf(string format, ...)

DESCRIPTION
     An implementation of (s)printf() for LPC, with quite  a  few
     extensions Implemented by Lynscar (Sean A Reith).

     This version supports the following as modifiers:

     " "   pad positive integers with a space.

     "+"   pad positive integers with a plus sign.

     "-"   left adjusted within field size.
           NB: std (s)printf() defaults to  right  justification,
           which  is  unnatural in the context of a mainly string
           based language but has been retained for  "compatabil-
           ity".

     "|"   centered within field size.

     "="   column mode if strings are greater  than  field  size.
           This  is only meaningful with strings, all other types
           ignore this. Columns are auto-magically word wrapped.

     "#"   table mode, print a list of '0 separated 'words' in  a
           table  within  the  field  size.  only meaningful with
           strings.

     n     specifies the field size, a '*' specifies to  use  the
           corresponding   arg  as  the  field  size.   If  n  is
           prepended with a zero, then is padded zeros,  else  it
           is padded with spaces (or specified pad string).

     "."n  precision of n, simple strings truncate after this (if
           precision  is greater than field size, then field size
           = precision), tables  use  precision  to  specify  the
           number  of  columns  (if  precision not specified then
           tables calculate a best fit), all other  types  ignore
           this.

     ":"n  n specifies the  fs  _and_  the  precision,  if  n  is
           prepended  by  a  zero  then  it  is padded with zeros
           instead of spaces.

     "@"   the  argument  is   an   array.    the   corresponding

Sun Release 4.1           Last change:                          1

sprintf(3)             C LIBRARY FUNCTIONS             sprintf(3)

           format_info (minus the "@") is applyed to each element
           of the array.

     "'X'" The char(s) between the single-quotes are used to  pad
           to  field size (defaults to space) (if both a zero (in
           front of field size) and a pad string  are  specified,
           the   one  specified  second  overrules).   NOTE:   to
           include "'" in the pad string, you must use  "\'"  (as
           the backslash has to be escaped past the interpreter),
           similarly, to include "

     The following are the possible type specifiers.

     %       in which case no arguments are  interpreted,  and  a
             "%" is inserted, and all modifiers are ignored.

     O       the argument is an LPC datatype.

     s       the argument is a string.

     d, i    the integer arg is printed in decimal.

     c       the integer arg is to be printed as a character.

     o       the integer arg is printed in octal.

     x       the integer arg is printed in hex.

     X       the integer arg is printed in hex (with A-F in capi-
             tals).

     f       floating point number

RETURN VALUES
     sprintf() returns the formatted string.

AUTHOR
     Sean A. Reith (Lynscar)

SEE ALSO
     sscanf(3)

Sun Release 4.1           Last change:                          2

