setcat man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

setcat(3C)		 Standard C Library Functions		    setcat(3C)

NAME
       setcat - define default catalog

SYNOPSIS
       #include <pfmt.h>

       char *setcat(const char *catalog);

DESCRIPTION
       The setcat() function defines the default message catalog to be used by
       subsequent calls to gettxt(3C),	lfmt(3C),  or  pfmt(3C)	 that  do  not
       explicitly specify a message catalog.

       The catalog argument must be limited to 14 characters. These characters
       must be selected from a set of  all  characters	values,	 excluding  \0
       (null) and the ASCII codes for / (slash) and : (colon).

       The  setcat()  function assumes that the catalog exists. No checking is
       done on the argument.

       A null pointer passed as an argument will result in  the	 return	 of  a
       pointer	to  the	 current default message catalog name. A pointer to an
       empty string passed as an argument will cancel the default catalog.

       If no default catalog is specified, or if catalog is an invalid catalog
       name, subsequent calls to gettxt(3C), lfmt(3C), or pfmt(3C) that do not
       explicitely specify a catalog name will use Message  not	 found!!\n  as
       default string.

RETURN VALUES
       Upon  successful	 completion, setcat() returns a pointer to the catalog
       name.  Otherwise, it returns a null pointer.

EXAMPLES
       Example 1 Example of setcat() function.

		 setcat("test");
		 gettxt(":10", "hello world\n")

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │MT-Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       gettxt(3C), lfmt(3C),  pfmt(3C),	 setlocale(3C),	 attributes(5),	 envi‐
       ron(5)

SunOS 5.11			  29 Dec 1996			    setcat(3C)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net