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

This is the documentation for an old version of Boost. Click here to view this page for the latest version.

Chapter 1. Boost.Convert 2.0

Vladimir Batov

Distributed under the Boost Software License, Version 1.0. See copy at

Table of Contents

Getting Started
Basic Deployment
Flexibility and Adaptability to Change
Basic Conversion-Failure Detection
Better Error Detection
Default Converter
Alternative Interface
Integration of User-Defined Types
Boost.Convert with Standard Algorithms
Converters Compared
Boost.Convert Overhead
The Bigger Picture
Beyond Basic Conversions
Converters in Detail
boost::cnv::lexical_cast Converter
boost::cnv::stream Converter
Formatting Support
Numeric Base
Field Width, Fill Character and Adjustment
Leading Whitespace Characters
Format of Boolean Values
Locale Support
Supported String Types
Wide String
Custom String Types
The Default Constructible Type Requirement
boost::cnv::strtol Converter
Basic Deployment
Formatting Support
Numeric Base (bin, oct, dec, hex)
Field Width, Fill Character and Adjustment
Leading Whitespace Characters
Floating-Point Precision
Supported String Types
Wide String
Custom String Types
Design Notes
Converter Signature
User Interface Signature
Supporting Tools
Supported Compilers
Boost.Convert C++ Reference
Header <boost/convert.hpp>
Header <boost/convert/base.hpp>
Header <boost/convert/lexical_cast.hpp>
Header <boost/convert/parameters.hpp>
Header <boost/convert/printf.hpp>
Header <boost/convert/spirit.hpp>
Header <boost/convert/stream.hpp>
Header <boost/convert/strtol.hpp>
Header <boost/make_default.hpp>

I was using textual configuration files extensively and also was processing and preparing considerable amounts of data in XML. Consequently, I had a need for an extendible library that would provide a uniform interface to convert various data between their internal binary representations and external (predominantly textual) representations.

The boost::lexical_cast library (with its orthogonal and extendible design) looked very promising compared to others (see The String Formatters of Manor Farm by H. Sutter for the discussion of alternatives). Unfortunately,

  • many deployed user types simply did not meet boost::lexical_cast requirements (namely, Default Constructibility);
  • failure to convert a user-provided configuration parameter was not that rare or exceptional to justify the hassle and the overhead of exception processing and, consequently, additional flexibility (if, when and how) to handle conversion failures was needed;
  • additional conversion-related functionality (formatting and locale support) were needed.

The original hope was to see boost::lexical_cast extended to be applicable to a wider range of deployment scenarios. However, after discussions with Kevlin Henney (the boost::lexical_cast author) and in the Boost Developers forum it was collectively decided that the desired extensions were not compatible with the original design and the idea of what boost::lexical_cast embodied and, therefore, a new component with richer interface and functionality was needed. That decision resulted in the development of Boost.Convert described in this document.

Last revised: September 21, 2016 at 14:49:24 GMT