# Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. — Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

# Running Examples under Microsoft Windows

All of the examples that come with Boost.Locale are designed for UTF-8 and it is the default encoding used by Boost.Locale.

However, the default narrow encoding under Microsoft Windows is not UTF-8 and the output of the applications would not be displayed correctly in the console.

So in order to use UTF-8 encoding under the Windows console and see the output correctly, do the following:

1. Open a `cmd` window
2. Change the default font to a TrueType font: go to properties->font (right click on title-bar->properties->font) and change the font to a TrueType font like Lucida Console
3. Change the default codepage to 65001 (UTF-8) by running `chcp 65001`

Now all of the examples should display UTF-8 characters correctly (if the font supports them).

Note for Visual Studio users: Microsoft Visual Studio assumes that all source files are encoded using an "ANSI" codepage like 1252. However all examples use UTF-8 encoding by default, so wide character examples would not work under MSVC as-is. In order to force it to treat source files as UTF-8 you need to convert the files to UTF-8 with BOM, which can be done easily by re-saving them from Notepad, which adds a BOM to UTF-8 files by default.