fmt.3

Introduction to Library Functions                          FMT(3)

NAME
     fmt - string formatting routines

SYNOPSIS
     #include <ast.h> #include <ls.h>

     char*      fmtbase(long number, int base, int prefix); char*
     fmtdev(struct stat* st); char*      fmtelapsed(unsigned long
     count, int persec)  char*       fmterror(int  errno);  char*
     fmtesc(const  char*  string);  char*      fmtfs(struct stat*
     st); char*      fmtgid(int gid);  char*       fmtmatch(const
     char* re); char*      fmtmode(int mode, int external); char*
     fmtperm(int perm); char*       fmtre(const  char*  pattern);
     char*        fmtsignal(int  sig);  char*       fmttime(const
     char* format, time_t tm); char*      fmtuid(int uid);

DESCRIPTION
     These routines return a pointer to a  formatted  string  for
     various  numeric  and  string  entities.   Some routines may
     cache information to speed up the next call.   Most  of  the
     routines  return a pointer to a private buffer, the contents
     of which are overwritten on the next call to  that  routine.
     Most fmt routines have a corresponding str routine that con-
     verts in the other direction.  There is nothing  spectacular
     about  this  collection other than that it provides a single
     place where the exact format is spelled out.

     fmtbase formats a base base representation for  number.   If
     prefix  != 0 then the base prefix is included in the format-
     ted string.  If number == 0 or base == 0 then the output  is
     signed base 10.

     fmtdev returns the device handle name specified by the  stat
     structure  st.   This is the device information displayed by
     ls -l.

     fmtelapsed  formats  the  elapsed  time  for  (count/persec)
     seconds.   The two largest time units are used, limiting the
     return value length to at most 6 characters.  The units are:

     s    seconds

     m    minutes

     h    hours

     days

     weeks

     M    months

SunOS 5.10                Last change:                          1

Introduction to Library Functions                          FMT(3)

     Y    years

     S    scores

     fmterror returns the system error message text for the error
     number errno.

     fmtesc formats non-ASCII characters in string into C-style \
     sequences.   These  sequences  are  understood by chresc and
     chrtoi.

     fmtfs returns the file system type name corresponding to the
     stat structure st.

     fmtgid returns the group name for gid.

     fmtmatch returns the strmatch  equivalent  pattern  for  the
     regular  expression  pattern  re.  0 is returned for invalid
     re.

     fmtmode returns the ls -l mode string for the file mode bits
     in mode.  If external != 0 then mode is modecanon(3) canoni-
     cal.

     fmtperm returns the chmod permission string for the  permis-
     sion bits in perm.

     fmtre returns the regular expression equivalent pattern  for
     the  strmatch  pattern  pattern.   0 is returned for invalid
     pattern.

     fmtsignal returns the signal name, sans SIG, for the  signal
     number  sig.   If sig < 0 then the description text for -sig
     is returned.

     fmttime        returns        the         results         of
     tmfmt(buf,sizeof(buf),format,tm) in the private buffer buf.

     fmtuid returns the user name for uid.

SEE ALSO
     modecanon(3), str(3)

SunOS 5.10                Last change:                          2

Generated by GNU enscript 1.6.4.