wctrans(3c) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

wctrans(3c)

wctrans(3C)              Standard C Library Functions              wctrans(3C)

NAME
       wctrans, wctrans_l - define character mapping

SYNOPSIS
       #include <wctype.h>

       wctrans_t wctrans(const char *charclass);

       wctrans_t wctrans_l(const char *charclass, locale_t locale);

DESCRIPTION
       The  wctrans()  function  is  defined for valid character mapping names
       identified in the current locale. The charclass is a string identifying
       a generic character mapping name for which codeset-specific information
       is required. The following character mapping names are defined  in  all
       locales:  "tolower"  and "toupper". See the wctrans_ja(3C) man page for
       character mapping names defined in Japanese locales.


       The function returns a value of type wctrans_t, which can  be  used  as
       the  second  argument  to  subsequent  calls of towctrans(3C) and towc‐
       trans_l(3C). The wctrans() function determines values of wctrans_t  ac‐
       cording  to  the  rules of the coded character set defined by character
       mapping information in the current locale (category LC_CTYPE).


       The wctrans_l() function is equivalent to the wctrans()  function,  ex‐
       cept  that  the  locale data used is from the locale represented by lo‐
       cale.


       The values returned by wctrans() are  valid  until  a  call  to  setlo‐
       cale(3C) that modifies the category LC_CTYPE.


       The  behavior is undefined if the locale argument to wctrans_l() is the
       special locale object LC_GLOBAL_LOCALE or is not a valid locale  object
       handle.

RETURN VALUES
       The wctrans() and wctrans_l() functions return 0 if the given character
       mapping  name  is not valid for the current locale (category LC_CTYPE),
       otherwise they return a non-zero object of type wctrans_t that  can  be
       used in calls to towctrans(3C) and towctrans_l(3C).

ERRORS
       These functions may fail if:

       EINVAL    The  character  mapping  name  pointed to by charclass is not
                 valid in the current locale or in the locale  represented  by
                 locale.


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

       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ CSIEnabled _ Interface StabilityCommitted _ MT-LevelMT-
       Safe _ StandardSee standards(7).


SEE ALSO
       duplocale(3C),  freelocale(3C),  newlocale(3C),  setlocale(3C),   towc‐
       trans(3C), wctrans_ja(3C), uselocale(3C), attributes(7), standards(7)


       Handling Characters and Character Strings in Internationalizing and Lo‐
       calizing Applications in Oracle Solaris

HISTORY
       The  wctrans_l()  function  was  added to Solaris in the Oracle Solaris
       11.4.0 release.


       The wctrans() function was added to Solaris in the Solaris 7 release.

Oracle Solaris 11.4               25 Nov 2024                      wctrans(3C)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3