[v3] locale cache PR 7076,8761

[Phil Edwards]

On Mon, Jun 30, 2003 at 12:37:24AM -0400, Jerry Quinn wrote:
> +  // __locale_cache objects hold information extracted from facets in
> +  // a form optimized for parsing and formatting.  They are stored in
> +  // a locale's facet array and accessed via __use_cache<_Facet>.
> +  //
> +  // The intent twofold: to avoid the costs of creating a locale
> +  // object and to avoid calling the virtual functions in a locale's
> +  // facet to look up data.
> +  class __locale_cache_base
> +  {
> +    friend class std::locale::_Impl;
> +    friend class locale;
> +
> +  public:
> +    virtual
> +    ~__locale_cache_base() { }
> +
> +  };

Just a side note:  if and when it's convenient to do so, please consider
writing such comments as doxygen hooks, surrounded by maintainer-only
hooks, e.g.,

    /**
     *  @if maint
     *  __local_cache objects hold....
     *
     *  ...up data.
     *  @endif
    */
    class __locale_cache_base

This way, they'll show up in the maintainer's-reference version of
the doxygen pages, where we can click on cross-references, hunt down
dependancies, etc, etc.


Phil

-- 
If ye love wealth greater than liberty, the tranquility of servitude greater
than the animating contest for freedom, go home and leave us in peace.  We seek
not your counsel, nor your arms.  Crouch down and lick the hand that feeds you;
and may posterity forget that ye were our countrymen.            - Samuel Adams