Mercurial > hg > vamp-build-and-test
diff DEPENDENCIES/generic/include/boost/locale/localization_backend.hpp @ 16:2665513ce2d3
Add boost headers
author | Chris Cannam |
---|---|
date | Tue, 05 Aug 2014 11:11:38 +0100 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/DEPENDENCIES/generic/include/boost/locale/localization_backend.hpp Tue Aug 05 11:11:38 2014 +0100 @@ -0,0 +1,159 @@ +// +// Copyright (c) 2009-2011 Artyom Beilis (Tonkikh) +// +// Distributed under the Boost Software License, Version 1.0. (See +// accompanying file LICENSE_1_0.txt or copy at +// http://www.boost.org/LICENSE_1_0.txt) +// +#ifndef BOOST_LOCALE_LOCALIZATION_BACKEND_HPP +#define BOOST_LOCALE_LOCALIZATION_BACKEND_HPP +#include <boost/locale/config.hpp> +#include <boost/locale/generator.hpp> +#ifdef BOOST_MSVC +# pragma warning(push) +# pragma warning(disable : 4275 4251 4231 4660) +#endif +#include <string> +#include <locale> +#include <vector> +#include <memory> + +namespace boost { + namespace locale { + + /// + /// \brief this class represents a localization backend that can be used for localizing your application. + /// + /// Backends are usually registered inside the localization backends manager and allow transparent support + /// of different backends, so a user can switch the backend by simply linking the application to the correct one. + /// + /// Backends may support different tuning options, but these are the default options available to the user + /// for all of them + /// + /// -# \c locale - the name of the locale in POSIX format like en_US.UTF-8 + /// -# \c use_ansi_encoding - select system locale using ANSI codepages rather then UTF-8 under Windows + /// by default + /// -# \c message_path - path to the location of message catalogs (vector of strings) + /// -# \c message_application - the name of applications that use message catalogs (vector of strings) + /// + /// Each backend can be installed with a different default priotiry so when you work with two different backends, you + /// can specify priotiry so this backend will be chosen according to their priority. + /// + + class localization_backend { + localization_backend(localization_backend const &); + void operator=(localization_backend const &); + public: + + localization_backend() + { + } + + virtual ~localization_backend() + { + } + + /// + /// Make a polymorphic copy of the backend + /// + virtual localization_backend *clone() const = 0; + + /// + /// Set option for backend, for example "locale" or "encoding" + /// + virtual void set_option(std::string const &name,std::string const &value) = 0; + + /// + /// Clear all options + /// + virtual void clear_options() = 0; + + /// + /// Create a facet for category \a category and character type \a type + /// + virtual std::locale install(std::locale const &base,locale_category_type category,character_facet_type type = nochar_facet) = 0; + + }; // localization_backend + + + /// + /// \brief Localization backend manager is a class that holds various backend and allows creation + /// of their combination or selection + /// + + class BOOST_LOCALE_DECL localization_backend_manager { + public: + /// + /// New empty localization_backend_manager + /// + localization_backend_manager(); + /// + /// Copy localization_backend_manager + /// + localization_backend_manager(localization_backend_manager const &); + /// + /// Assign localization_backend_manager + /// + localization_backend_manager const &operator=(localization_backend_manager const &); + + /// + /// Destructor + /// + ~localization_backend_manager(); + + /// + /// Create new localization backend according to current settings. + /// + std::auto_ptr<localization_backend> get() const; + + /// + /// Add new backend to the manager, each backend should be uniquely defined by its name. + /// + /// This library provides: "icu", "posix", "winapi" and "std" backends. + /// + void add_backend(std::string const &name,std::auto_ptr<localization_backend> backend); + + /// + /// Clear backend + /// + void remove_all_backends(); + + /// + /// Get list of all available backends + /// + std::vector<std::string> get_all_backends() const; + + /// + /// Select specific backend by name for a category \a category. It allows combining different + /// backends for user preferences. + /// + void select(std::string const &backend_name,locale_category_type category = all_categories); + + /// + /// Set new global backend manager, the old one is returned. + /// + /// This function is thread safe + /// + static localization_backend_manager global(localization_backend_manager const &); + /// + /// Get global backend manager + /// + /// This function is thread safe + /// + static localization_backend_manager global(); + private: + class impl; + std::auto_ptr<impl> pimpl_; + }; + + } // locale +} // boost + + +#ifdef BOOST_MSVC +#pragma warning(pop) +#endif + +#endif +// vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 +