printf(3)             LPC Library Functions             printf(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  "compata-
             bility".

     "|"     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 '\n'  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.

MudOS                Last change: 5 Sep 1994                    1

printf(3)             LPC Library Functions             printf(3)

     "@"     the  argument  is  an  array.    the   corresponding
             format_info  (minus the "@") is applyed to each ele-
             ment 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)

MudOS                Last change: 5 Sep 1994                    2