FMCATGETS(3)                                         FMCATGETS(3)



  NAME
       FmCatGetS, FmCatGetSAlloc, FmCatGetSRealloc - read a string
       from a list of message catalogs


  SYNOPSIS
       char *FmCatGetS (setno,msgno,defaultvalue)
       int setno;
       int msgno;
       char *defaultvalue;

       char *FmCatGetSAlloc (setno,msgno,defaultvalue)
       int setno;
       int msgno;
       char *defaultvalue;

       char *
       FmCatGetSRealloc (ptr,setno,msgno,defaultvalue)
       char *ptr;
       int setno;
       int msgno;
       char *defaultvalue;

  DESCRIPTION
       FmCatGetS returns an internationalized message.  The set
       number is in setno and the message number is in msgno.  If
       no message is found, it returns defaultvalue.  The catalogs
       opened by FmCatOpen are checked in reverse order.

       Messages returned by FmCatGetS are in read-only memory-
       mapped I/O space.  They must be copied if their contents are
       to be changed.

       FmCatGetSAlloc is like FmCatGetS, except that strdup (3) is
       used to copy the string to dynamically allocated space
       before being returned.  FmCatGetSRealloc may be used to
       reallocate a string returned previously by FmCatGetSAlloc by
       passing the string in ptr.  If ptr is NULL, FmCatGetSRealloc
       behaves like FmCatGetSAlloc.



  Page 1                                           (printed 9/3/91)

  FMCATGETS(3)                                         FMCATGETS(3)



  SEE ALSO
       catopen(3), catgets(3), strdup(3), FmCatOpen(3)








































  Page 2                                           (printed 9/3/91)