[ceph.git] / ceph / src / boost / libs / convert / doc / strtol_converter.qbk

[/
  Copyright (c) Vladimir Batov 2009-2016
  Distributed under the Boost Software License, Version 1.0.
  See copy at http://www.boost.org/LICENSE_1_0.txt.
]

[section:strtol_converter ['boost::cnv::strtol] Converter]

The converter started as a deployment example (with the `std::strtol` family of functions as its conversion engine) and a part of the performance-test set. Surprisingly, the converter showed fairly decent all-around performance (see [link boost_convert.performance.converters_compared Converters Compared]) and, consequently, has been rewritten and extended to provide additional conversion support and formatting. At the moment it seems to be a good choice with moderate formatting facilities and adequate performance.

It should be noted though that the converter is nowhere as mature as `boost::cnv::lexical_cast` or `boost::cnv::stream` and, therefore, bugs are to be expected.

[section Basic Deployment]
[strtol_basic_deployment_header]
[strtol_basic_deployment]
[endsect]

[section Formatting Support]

[section Numeric Base (bin, oct, dec, hex)]
[strtol_numeric_base_header]
[strtol_numeric_base]
[wide_strtol_numeric_base]
[endsect]

[section Field Width, Fill Character and Adjustment]
[strtol_width]
[endsect]

[section Leading Whitespace Characters]
[strtol_skipws]
[wide_strtol_skipws]
[endsect]

[section Floating-Point Precision]
[strtol_precision]
[endsect]
[endsect]

[section Supported String Types]

[section Wide String]
[wide_strtol_numeric_base]
[wide_strtol_skipws]
[endsect]

[section Custom String Types]
[my_string_declaration]
[strtol_user_string]
[endsect]

[endsect]
[endsect]
Commit	Line	Data
7c673cae FG	1	[/
	2	Copyright (c) Vladimir Batov 2009-2016
	3	Distributed under the Boost Software License, Version 1.0.
	4	See copy at http://www.boost.org/LICENSE_1_0.txt.
	5	]
	6
	7	[section:strtol_converter ['boost::cnv::strtol] Converter]
	8
	9	The converter started as a deployment example (with the `std::strtol` family of functions as its conversion engine) and a part of the performance-test set. Surprisingly, the converter showed fairly decent all-around performance (see [link boost_convert.performance.converters_compared Converters Compared]) and, consequently, has been rewritten and extended to provide additional conversion support and formatting. At the moment it seems to be a good choice with moderate formatting facilities and adequate performance.
	10
	11	It should be noted though that the converter is nowhere as mature as `boost::cnv::lexical_cast` or `boost::cnv::stream` and, therefore, bugs are to be expected.
	12
	13	[section Basic Deployment]
	14	[strtol_basic_deployment_header]
	15	[strtol_basic_deployment]
	16	[endsect]
	17
	18	[section Formatting Support]
	19
	20	[section Numeric Base (bin, oct, dec, hex)]
	21	[strtol_numeric_base_header]
	22	[strtol_numeric_base]
	23	[wide_strtol_numeric_base]
	24	[endsect]
	25
	26	[section Field Width, Fill Character and Adjustment]
	27	[strtol_width]
	28	[endsect]
	29
	30	[section Leading Whitespace Characters]
	31	[strtol_skipws]
	32	[wide_strtol_skipws]
	33	[endsect]
	34
	35	[section Floating-Point Precision]
	36	[strtol_precision]
	37	[endsect]
	38	[endsect]
	39
	40	[section Supported String Types]
	41
	42	[section Wide String]
	43	[wide_strtol_numeric_base]
	44	[wide_strtol_skipws]
	45	[endsect]
	46
	47	[section Custom String Types]
	48	[my_string_declaration]
	49	[strtol_user_string]
	50	[endsect]
	51
	52	[endsect]
	53	[endsect]
	54