[ceph.git] / ceph / src / boost / libs / regex / doc / non_std_strings.qbk

[/ 
  Copyright 2006-2007 John Maddock.
  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).
]

[section:non_std_strings Interfacing With Non-Standard String Types]

The Boost.Regex algorithms and iterators are all iterator-based, 
with convenience overloads of the algorithms provided that convert 
standard library string types to iterator pairs internally.  If you want 
to search a non-standard string type then the trick is to convert that string 
into an iterator pair: so far I haven't come across any string types that 
can't be handled this way, even if they're not officially iterator based.  
Certainly any string type that provides access to it's internal buffer, along 
with it's length, can be converted into a pair of pointers (which can be 
used as iterators).

Some non-standard string types are sufficiently common that wrappers have been 
provided for them already: currently this includes the ICU and MFC string class
types.

[include icu_strings.qbk]
[include mfc_strings.qbk]

[endsect]
Commit	Line	Data
7c673cae FG	1	[/
	2	Copyright 2006-2007 John Maddock.
	3	Distributed under the Boost Software License, Version 1.0.
	4	(See accompanying file LICENSE_1_0.txt or copy at
	5	http://www.boost.org/LICENSE_1_0.txt).
	6	]
	7
	8	[section:non_std_strings Interfacing With Non-Standard String Types]
	9
	10	The Boost.Regex algorithms and iterators are all iterator-based,
	11	with convenience overloads of the algorithms provided that convert
	12	standard library string types to iterator pairs internally. If you want
	13	to search a non-standard string type then the trick is to convert that string
	14	into an iterator pair: so far I haven't come across any string types that
	15	can't be handled this way, even if they're not officially iterator based.
	16	Certainly any string type that provides access to it's internal buffer, along
	17	with it's length, can be converted into a pair of pointers (which can be
	18	used as iterators).
	19
	20	Some non-standard string types are sufficiently common that wrappers have been
	21	provided for them already: currently this includes the ICU and MFC string class
	22	types.
	23
	24	[include icu_strings.qbk]
	25	[include mfc_strings.qbk]
	26
	27	[endsect]
	28
	29
	30