Standard C Library Functions                             cset(3C)



NAME
     cset, csetlen, csetcol, csetno, wcsetno - get information on
     EUC codesets

SYNOPSIS
     #include 

     int csetlen(int codeset);


     int csetcol(int codeset);


     int csetno(unsigned char c);


     #include 

     int wcsetno(wchart pc);


DESCRIPTION
     Both  csetlen()  and  csetcol()  take  a  code  set   number
     codeset, which must be 0, 1, 2, or 3. The csetlen() function
     returns the number of bytes needed to represent a  character
     of  the  given  Extended Unix Code (EUC) code set, excluding
     the single-shift characters S2 and S3 for codesets  2  and
     3.  The  csetcol()  function returns the number of columns a
     character in the given  EUC  code  set  would  take  on  the
     display.


     The csetno() function is implemented as a macro that returns
     a codeset number (0, 1, 2, or 3) for the EUC character whose
     first byte is c. For example,

       #include
       x]=csetcol(csetno(c));



     increments a counter "x" (such as the  cursor  position)  by
     the width of the character whose first byte is c.


     The wcsetno()  function  is  implemented  as  a  macro  that
     returns  a codeset number (0, 1, 2, or 3) for the given pro-
     cess code character pc. For example,

       #include
       #include
       x]=csetcol(wcsetno(pc));



SunOS 5.11          Last change: 16 Nov 2003                    1






Standard C Library Functions                             cset(3C)



     increments a counter "x" (such as the  cursor  position)  by
     the width of the Process Code character pc.

USAGE
     These functions work only for the EUC locales.


     The cset(), csetlen(), csetcol(),  csetno(),  and  wcsetno()
     functions  can be used safely in multithreaded applications,
     as long as setlocale(3C) is not being called to  change  the
     locale.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE                ATRIBUTE VALUE       
     MT-Level                      MT-Safe with exceptions     
    


SEE ALSO
     setlocale(3C) euclen(3C), attributes(5)





























SunOS 5.11          Last change: 16 Nov 2003                    2