Man Page facets.3



                       Standard C++ Library
             Copyright 1998, Rogue Wave Software, Inc.



NAME

     facets

      - A family of classes used  to  encapsulate  categories  of
     locale functionality.





DESCRIPTION

     The Standard C++  Localization  library  includes  a  locale
     interface that contains a collection of diverse facets. Each
     facet has localization facilities for  some  specific  area,
     such as character classification or numeric formatting. Each
     facet also falls into one or more  broad  categories.  These
     categories are defined in the locale class, and the standard
     facets fit into these categories as follows.

     CATEGORY       FACETS


     collate        collate, collate_byname

     ctype          ctype, codecvt, ctype_byname, codecvt_byname

     monetary       moneypunct,                moneypunct_byname,
                    money_put, money_get

     numeric        numpunct, numpunct_byname, num_put, num_get

     time           time_put,                    time_put_byname,
                    time_get, time_get_byname

     messages       messages, messages_byname



     A facet must satisfy  two  properties.  First,  it  must  be
     derived  from  the base class locale::facet, either directly
     or  indirectly  (for  example,  facet  ->   ctype<char>   ->
     my_ctype).   Second,  it  must  contain  a  member  of  type
     locale::id. This ensures that the locale  class  can  manage
     its collection of facets properly.






SEE ALSO

     locale, specific facet reference sections