Quick Start
You are viewing the master version of this library.
The master and develop pages are shown here to provide access to the newest in-development in-progress documentation. See the "Documentation" link on this page.
Other aspects of the page will reflect the previous official version, or not be available until the next release.
Contributors: This Release
Boost.Locale
Part of the Boost C++ Libraries.
Boost.Locale is a library that provides high quality localization facilities in a C++ way. It was originally designed a part of CppCMS - a C++ Web Framework project and then contributed to Boost.
Boost.Locale gives powerful tools for development of cross-platform localized software - the software that talks to users in their language.
Provided Features:
- Correct case conversion, case folding and normalization.
- Collation (sorting), including support for 4 Unicode collation levels.
- Date, time, timezone and calendar manipulations, formatting and parsing, including transparent support for calendars other than Gregorian.
- Boundary analysis for characters, words, sentences and line-breaks.
- Number formatting, spelling and parsing.
- Monetary formatting and parsing.
- Powerful message formatting (string translation) including support for plural forms, using GNU catalogs.
- Character set conversion.
- Transparent support for 8-bit character sets like Latin1
- Support for
charandwchar_t - Experimental support for C++11
char16_tandchar32_tstrings and streams.
Boost.Locale enhances and unifies the standard library's API the way it becomes useful and convenient for development of cross-platform and "cross-culture" software.
In order to achieve this goal Boost.Locale uses the-state-of-the-art Unicode and Localization library: ICU - International Components for Unicode.
Boost.Locale creates the natural glue between the C++ locales framework, iostreams, and the powerful ICU library.
Boost.Locale provides non-ICU based localization support as well. It is based on the operating system native API or on the standard C++ library support. Sacrificing some less important features, Boost.Locale becomes less powerful but lighter and easier to deploy and use library.
License
Distributed under the Boost Software License, Version 1.0.
Properties / Requirements
- C++11
- ICU 4.8.1 or newer for full feature support. ICU 50.1 is not supported, please use a newer version.
- Formatted with clang-format, see
tools/format_sources.sh
Build Status
| Branch | GH Actions | Appveyor | Drone | codecov.io | Deps | Docs | Tests |
|---|---|---|---|---|---|---|---|
master |
 |
 |
 |
 |
 |
 |
|
develop |
 |
 |
 |
 |
 |
 |
Directories
| Name | Purpose |
|---|---|
doc |
Documentation |
examples |
Examples |
include |
Headers |
src |
Source files |
test |
Unit tests |
More information
- Ask questions
- Report bugs: Be sure to mention Boost version, platform and compiler you're using. A small compilable code sample to reproduce the problem is always good as well.
- Submit your patches as pull requests against develop branch. Note that by submitting patches you agree to license your modifications under the Boost Software License, Version 1.0.
- Discussions about the library are held on the Boost developers mailing list. Be sure to read the discussion policy before posting and add the
[locale]tag at the beginning of the subject line.
<h1>Boost.Locale</h1> <p>Part of the <a href="http://github.com/boostorg">Boost C++ Libraries</a>.</p> <p>Boost.Locale is a library that provides high quality localization facilities in a C++ way. It was originally designed a part of <a href="http://cppcms.sourceforge.net/">CppCMS</a> - a C++ Web Framework project and then contributed to Boost.</p> <p>Boost.Locale gives powerful tools for development of cross-platform localized software - the software that talks to users in their language.</p> <p>Provided Features:</p> <ul> <li>Correct case conversion, case folding and normalization.</li> <li>Collation (sorting), including support for 4 Unicode collation levels.</li> <li>Date, time, timezone and calendar manipulations, formatting and parsing, including transparent support for calendars other than Gregorian.</li> <li>Boundary analysis for characters, words, sentences and line-breaks.</li> <li>Number formatting, spelling and parsing.</li> <li>Monetary formatting and parsing.</li> <li>Powerful message formatting (string translation) including support for plural forms, using GNU catalogs.</li> <li>Character set conversion.</li> <li>Transparent support for 8-bit character sets like Latin1</li> <li>Support for <code>char</code> and <code>wchar_t</code></li> <li>Experimental support for C++11 <code>char16_t</code> and <code>char32_t</code> strings and streams.</li> </ul> <p>Boost.Locale enhances and unifies the standard library's API the way it becomes useful and convenient for development of cross-platform and "cross-culture" software.</p> <p>In order to achieve this goal Boost.Locale uses the-state-of-the-art Unicode and Localization library: ICU - International Components for Unicode.</p> <p>Boost.Locale creates the natural glue between the C++ locales framework, iostreams, and the powerful ICU library.</p> <p>Boost.Locale provides non-ICU based localization support as well. It is based on the operating system native API or on the standard C++ library support. Sacrificing some less important features, Boost.Locale becomes less powerful but lighter and easier to deploy and use library.</p> <h3>License</h3> <p>Distributed under the <a href="https://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</p> <h3>Properties / Requirements</h3> <ul> <li>C++11</li> <li>ICU 4.8.1 or newer for full feature support. ICU 50.1 is not supported, please use a newer version.</li> <li>Formatted with clang-format, see <a href="https://github.com/boostorg/locale/blob/develop/tools/format_sources.sh"><code>tools/format_sources.sh</code></a></li> </ul> <h3>Build Status</h3> <table> <thead> <tr> <th align="center">Branch</th> <th align="left">GH Actions</th> <th align="left">Appveyor</th> <th align="left">Drone</th> <th align="left">codecov.io</th> <th align="left">Deps</th> <th align="left">Docs</th> <th align="left">Tests</th> </tr> </thead> <tbody> <tr> <td align="center"><a href="https://github.com/boostorg/locale/tree/master"><code>master</code></a></td> <td align="left"><a href="https://github.com/boostorg/locale/actions/workflows/ci.yml"><img src="https://github.com/boostorg/locale/actions/workflows/ci.yml/badge.svg?branch=master" alt="CI" /></a></td> <td align="left"><a href="https://ci.appveyor.com/project/Flamefire/locale/branch/master"><img src="https://ci.appveyor.com/api/projects/status/github/boostorg/locale?branch=master&svg=true" alt="Build status" /></a></td> <td align="left"><a href="https://drone.cpp.al/boostorg/locale"><img src="https://drone.cpp.al/api/badges/boostorg/locale/status.svg?ref=refs/heads/master" alt="Build Status" /></a></td> <td align="left"><a href="https://codecov.io/gh/boostorg/locale/branch/master"><img src="https://codecov.io/gh/boostorg/locale/branch/master/graph/badge.svg" alt="codecov" /></a></td> <td align="left"><a href="https://pdimov.github.io/boostdep-report/master/locale.html"><img src="https://img.shields.io/badge/deps-master-brightgreen.svg" alt="Deps" /></a></td> <td align="left"><a href="https://www.boost.org/doc/libs/master/libs/locale/doc/html/index.html"><img src="https://img.shields.io/badge/docs-master-brightgreen.svg" alt="Documentation" /></a></td> <td align="left"><a href="https://regression.boost.org/master/developer/locale.html"><img src="https://img.shields.io/badge/matrix-master-brightgreen.svg" alt="Enter the Matrix" /></a></td> </tr> <tr> <td align="center"><a href="https://github.com/boostorg/locale/tree/develop"><code>develop</code></a></td> <td align="left"><a href="https://github.com/boostorg/locale/actions/workflows/ci.yml"><img src="https://github.com/boostorg/locale/actions/workflows/ci.yml/badge.svg?branch=develop" alt="CI" /></a></td> <td align="left"><a href="https://ci.appveyor.com/project/Flamefire/locale/branch/develop"><img src="https://ci.appveyor.com/api/projects/status/github/boostorg/locale?branch=develop&svg=true" alt="Build status" /></a></td> <td align="left"><a href="https://drone.cpp.al/boostorg/locale"><img src="https://drone.cpp.al/api/badges/boostorg/locale/status.svg?ref=refs/heads/develop" alt="Build Status" /></a></td> <td align="left"><a href="https://codecov.io/gh/boostorg/locale/branch/develop"><img src="https://codecov.io/gh/boostorg/locale/branch/develop/graph/badge.svg" alt="codecov" /></a></td> <td align="left"><a href="https://pdimov.github.io/boostdep-report/develop/locale.html"><img src="https://img.shields.io/badge/deps-develop-brightgreen.svg" alt="Deps" /></a></td> <td align="left"><a href="https://www.boost.org/doc/libs/develop/libs/locale/doc/html/index.html"><img src="https://img.shields.io/badge/docs-develop-brightgreen.svg" alt="Documentation" /></a></td> <td align="left"><a href="https://regression.boost.org/develop/developer/locale.html"><img src="https://img.shields.io/badge/matrix-develop-brightgreen.svg" alt="Enter the Matrix" /></a></td> </tr> </tbody> </table> <h3>Directories</h3> <table> <thead> <tr> <th align="left">Name</th> <th align="left">Purpose</th> </tr> </thead> <tbody> <tr> <td align="left"><code>doc</code></td> <td align="left">Documentation</td> </tr> <tr> <td align="left"><code>examples</code></td> <td align="left">Examples</td> </tr> <tr> <td align="left"><code>include</code></td> <td align="left">Headers</td> </tr> <tr> <td align="left"><code>src</code></td> <td align="left">Source files</td> </tr> <tr> <td align="left"><code>test</code></td> <td align="left">Unit tests</td> </tr> </tbody> </table> <h3>More information</h3> <ul> <li><a href="http://stackoverflow.com/questions/ask?tags=c%2B%2B,boost,boost-locale">Ask questions</a></li> <li><a href="https://github.com/boostorg/locale/issues">Report bugs</a>: Be sure to mention Boost version, platform and compiler you're using. A small compilable code sample to reproduce the problem is always good as well.</li> <li>Submit your patches as pull requests against <strong>develop</strong> branch. Note that by submitting patches you agree to license your modifications under the <a href="https://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</li> <li>Discussions about the library are held on the <a href="http://www.boost.org/community/groups.html#main">Boost developers mailing list</a>. Be sure to read the <a href="http://www.boost.org/community/policy.html">discussion policy</a> before posting and add the <code>[locale]</code> tag at the beginning of the subject line.</li> </ul>
-
Code Commits Commits authored to any Boost repository. With 1 contribution, you will earn the bronze badge for Code Commits.
-
Documentation Doc contributions using standardised Boost tooling (Antora / BoostLook). With 1 contribution, you will earn the bronze badge for Documentation.
-
Library Authoring Authored an original Boost library accepted into the collection. With 1 contribution, you will earn the bronze badge for Library Authoring.
-
Library Maintenance Number of libraries actively maintained. With 1 contribution, you will earn the bronze badge for Library Maintenance.
-
Library Review Formal review submissions on Boost proposals. With 1 contribution, you will earn the bronze badge for Library Review.
-
Library Versioning Authored new versions / releases of Boost libraries. With 10 contributions, you will earn the bronze badge for Library Versioning.
-
Mailing List Participation Participation on the Boost developers mailing list. With 1 contribution, you will earn the bronze badge for Mailing List Participation.
-
News Posts Published Articles / news posts published on Boost.org. With 1 contribution, you will earn the bronze badge for News Posts Published.
<h1>Boost.Locale</h1> <p>Part of the <a href="http://github.com/boostorg">Boost C++ Libraries</a>.</p> <p>Boost.Locale is a library that provides high quality localization facilities in a C++ way. It was originally designed a part of <a href="http://cppcms.sourceforge.net/">CppCMS</a> - a C++ Web Framework project and then contributed to Boost.</p> <p>Boost.Locale gives powerful tools for development of cross-platform localized software - the software that talks to users in their language.</p> <p>Provided Features:</p> <ul> <li>Correct case conversion, case folding and normalization.</li> <li>Collation (sorting), including support for 4 Unicode collation levels.</li> <li>Date, time, timezone and calendar manipulations, formatting and parsing, including transparent support for calendars other than Gregorian.</li> <li>Boundary analysis for characters, words, sentences and line-breaks.</li> <li>Number formatting, spelling and parsing.</li> <li>Monetary formatting and parsing.</li> <li>Powerful message formatting (string translation) including support for plural forms, using GNU catalogs.</li> <li>Character set conversion.</li> <li>Transparent support for 8-bit character sets like Latin1</li> <li>Support for <code>char</code> and <code>wchar_t</code></li> <li>Experimental support for C++11 <code>char16_t</code> and <code>char32_t</code> strings and streams.</li> </ul> <p>Boost.Locale enhances and unifies the standard library's API the way it becomes useful and convenient for development of cross-platform and "cross-culture" software.</p> <p>In order to achieve this goal Boost.Locale uses the-state-of-the-art Unicode and Localization library: ICU - International Components for Unicode.</p> <p>Boost.Locale creates the natural glue between the C++ locales framework, iostreams, and the powerful ICU library.</p> <p>Boost.Locale provides non-ICU based localization support as well. It is based on the operating system native API or on the standard C++ library support. Sacrificing some less important features, Boost.Locale becomes less powerful but lighter and easier to deploy and use library.</p> <h3>License</h3> <p>Distributed under the <a href="https://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</p> <h3>Properties / Requirements</h3> <ul> <li>C++11</li> <li>ICU 4.8.1 or newer for full feature support. ICU 50.1 is not supported, please use a newer version.</li> <li>Formatted with clang-format, see <a href="https://github.com/boostorg/locale/blob/develop/tools/format_sources.sh"><code>tools/format_sources.sh</code></a></li> </ul> <h3>Build Status</h3> <table> <thead> <tr> <th align="center">Branch</th> <th align="left">GH Actions</th> <th align="left">Appveyor</th> <th align="left">Drone</th> <th align="left">codecov.io</th> <th align="left">Deps</th> <th align="left">Docs</th> <th align="left">Tests</th> </tr> </thead> <tbody> <tr> <td align="center"><a href="https://github.com/boostorg/locale/tree/master"><code>master</code></a></td> <td align="left"><a href="https://github.com/boostorg/locale/actions/workflows/ci.yml"><img src="https://github.com/boostorg/locale/actions/workflows/ci.yml/badge.svg?branch=master" alt="CI" /></a></td> <td align="left"><a href="https://ci.appveyor.com/project/Flamefire/locale/branch/master"><img src="https://ci.appveyor.com/api/projects/status/github/boostorg/locale?branch=master&svg=true" alt="Build status" /></a></td> <td align="left"><a href="https://drone.cpp.al/boostorg/locale"><img src="https://drone.cpp.al/api/badges/boostorg/locale/status.svg?ref=refs/heads/master" alt="Build Status" /></a></td> <td align="left"><a href="https://codecov.io/gh/boostorg/locale/branch/master"><img src="https://codecov.io/gh/boostorg/locale/branch/master/graph/badge.svg" alt="codecov" /></a></td> <td align="left"><a href="https://pdimov.github.io/boostdep-report/master/locale.html"><img src="https://img.shields.io/badge/deps-master-brightgreen.svg" alt="Deps" /></a></td> <td align="left"><a href="https://www.boost.org/doc/libs/master/libs/locale/doc/html/index.html"><img src="https://img.shields.io/badge/docs-master-brightgreen.svg" alt="Documentation" /></a></td> <td align="left"><a href="https://regression.boost.org/master/developer/locale.html"><img src="https://img.shields.io/badge/matrix-master-brightgreen.svg" alt="Enter the Matrix" /></a></td> </tr> <tr> <td align="center"><a href="https://github.com/boostorg/locale/tree/develop"><code>develop</code></a></td> <td align="left"><a href="https://github.com/boostorg/locale/actions/workflows/ci.yml"><img src="https://github.com/boostorg/locale/actions/workflows/ci.yml/badge.svg?branch=develop" alt="CI" /></a></td> <td align="left"><a href="https://ci.appveyor.com/project/Flamefire/locale/branch/develop"><img src="https://ci.appveyor.com/api/projects/status/github/boostorg/locale?branch=develop&svg=true" alt="Build status" /></a></td> <td align="left"><a href="https://drone.cpp.al/boostorg/locale"><img src="https://drone.cpp.al/api/badges/boostorg/locale/status.svg?ref=refs/heads/develop" alt="Build Status" /></a></td> <td align="left"><a href="https://codecov.io/gh/boostorg/locale/branch/develop"><img src="https://codecov.io/gh/boostorg/locale/branch/develop/graph/badge.svg" alt="codecov" /></a></td> <td align="left"><a href="https://pdimov.github.io/boostdep-report/develop/locale.html"><img src="https://img.shields.io/badge/deps-develop-brightgreen.svg" alt="Deps" /></a></td> <td align="left"><a href="https://www.boost.org/doc/libs/develop/libs/locale/doc/html/index.html"><img src="https://img.shields.io/badge/docs-develop-brightgreen.svg" alt="Documentation" /></a></td> <td align="left"><a href="https://regression.boost.org/develop/developer/locale.html"><img src="https://img.shields.io/badge/matrix-develop-brightgreen.svg" alt="Enter the Matrix" /></a></td> </tr> </tbody> </table> <h3>Directories</h3> <table> <thead> <tr> <th align="left">Name</th> <th align="left">Purpose</th> </tr> </thead> <tbody> <tr> <td align="left"><code>doc</code></td> <td align="left">Documentation</td> </tr> <tr> <td align="left"><code>examples</code></td> <td align="left">Examples</td> </tr> <tr> <td align="left"><code>include</code></td> <td align="left">Headers</td> </tr> <tr> <td align="left"><code>src</code></td> <td align="left">Source files</td> </tr> <tr> <td align="left"><code>test</code></td> <td align="left">Unit tests</td> </tr> </tbody> </table> <h3>More information</h3> <ul> <li><a href="http://stackoverflow.com/questions/ask?tags=c%2B%2B,boost,boost-locale">Ask questions</a></li> <li><a href="https://github.com/boostorg/locale/issues">Report bugs</a>: Be sure to mention Boost version, platform and compiler you're using. A small compilable code sample to reproduce the problem is always good as well.</li> <li>Submit your patches as pull requests against <strong>develop</strong> branch. Note that by submitting patches you agree to license your modifications under the <a href="https://www.boost.org/LICENSE_1_0.txt">Boost Software License, Version 1.0</a>.</li> <li>Discussions about the library are held on the <a href="http://www.boost.org/community/groups.html#main">Boost developers mailing list</a>. Be sure to read the <a href="http://www.boost.org/community/policy.html">discussion policy</a> before posting and add the <code>[locale]</code> tag at the beginning of the subject line.</li> </ul>
-
Achievement-based Reflects the depth of your contributions. Accumulate achievements to unlock five tiers; Bronze, Silver, Gold, Platinum and Diamond.
-
Tenure-based Awarded in recognition of your time on the platform. The longer you've been part of the Boost community, the higher the tier you unlock.
-
Boost day celebration A celebration of the day you joined Boost. Awarded annually to mark another year as part of the community.
