Quick Reference

Algorithms
Finders and Formatters
Iterators
Classification

Algorithms

Table 9.1. Case Conversion

Algorithm name	Description	Functions
`to_upper`	Convert a string to upper case	to_upper_copy() to_upper()
`to_lower`	Convert a string to lower case	to_lower_copy() to_lower()

Table 9.2. Trimming

Algorithm name	Description	Functions
`trim_left`	Remove leading spaces from a string	trim_left_copy_if() trim_left_if() trim_left_copy() trim_left()
`trim_right`	Remove trailing spaces from a string	trim_right_copy_if() trim_right_if() trim_right_copy() trim_right()
`trim`	Remove leading and trailing spaces from a string	trim_copy_if() trim_if() trim_copy() trim()

Table 9.3. Predicates

Algorithm name	Description	Functions
`starts_with`	Check if a string is a prefix of the other one	starts_with() istarts_with()
`ends_with`	Check if a string is a suffix of the other one	ends_with() iends_with()
`contains`	Check if a string is contained of the other one	contains() icontains()
`equals`	Check if two strings are equal	equals() iequals()
`all`	Check if all elements of a string satisfy the given predicate	all()

Table 9.4. Find algorithms

Algorithm name	Description	Functions
find_first	Find the first occurrence of a string in the input	find_first() ifind_first()
find_last	Find the last occurrence of a string in the input	find_last() ifind_last()
find_nth	Find the nth (zero-indexed) occurrence of a string in the input	find_nth() ifind_nth()
find_head	Retrieve the head of a string	find_head()
find_tail	Retrieve the tail of a string	find_tail()
find_token	Find first matching token in the string	find_token()
find_regex	Use the regular expression to search the string	find_regex()
find	Generic find algorithm	find()

Table 9.5. Erase/Replace

Algorithm name	Description	Functions
replace/erase_first	Replace/Erase the first occurrence of a string in the input	replace_first() replace_first_copy() ireplace_first() ireplace_first_copy() erase_first() erase_first_copy() ierase_first() ierase_first_copy()
replace/erase_last	Replace/Erase the last occurrence of a string in the input	replace_last() replace_last_copy() ireplace_last() ireplace_last_copy() erase_last() erase_last_copy() ierase_last() ierase_last_copy()
replace/erase_nth	Replace/Erase the nth (zero-indexed) occurrence of a string in the input	replace_nth() replace_nth_copy() ireplace_nth() ireplace_nth_copy() erase_nth() erase_nth_copy() ierase_nth() ierase_nth_copy()
replace/erase_all	Replace/Erase the all occurrences of a string in the input	replace_all() replace_all_copy() ireplace_all() ireplace_all_copy() erase_all() erase_all_copy() ierase_all() ierase_all_copy()
replace/erase_head	Replace/Erase the head of the input	replace_head() replace_head_copy() erase_head() erase_head_copy()
replace/erase_tail	Replace/Erase the tail of the input	replace_tail() replace_tail_copy() erase_tail() erase_tail_copy()
replace/erase_regex	Replace/Erase a substring matching the given regular expression	replace_regex() replace_regex_copy() erase_regex() erase_regex_copy()
replace/erase_regex_all	Replace/Erase all substrings matching the given regular expression	replace_all_regex() replace_all_regex_copy() erase_all_regex() erase_all_regex_copy()
find_format	Generic replace algorithm	find_format() find_format_copy() find_format_all() find_format_all_copy()()

Table 9.6. Split

Algorithm name	Description	Functions
find_all	Find/Extract all matching substrings in the input	find_all() ifind_all() find_all_regex()
split	Split input into parts	split() split_regex()

Finders and Formatters

Table 9.7. Finders

Finder	Description	Generators
first_finder	Search for the first match of the string in an input	first_finder()
last_finder	Search for the last match of the string in an input	last_finder()
nth_finder	Search for the nth (zero-indexed) match of the string in an input	nth_finder()
head_finder	Retrieve the head of an input	head_finder()
tail_finder	Retrieve the tail of an input	tail_finder()
token_finder	Search for a matching token in an input	token_finder()
range_finder	Do no search, always returns the given range	range_finder()
regex_finder	Search for a substring matching the given regex	regex_finder()

Table 9.8. Formatters

Formatter	Description	Generators
const_formatter	Constant formatter. Always return the specified string	const_formatter()
identity_formatter	Identity formatter. Return unmodified input input	identity_formatter()
empty_formatter	Null formatter. Always return an empty string	empty_formatter()
regex_formatter	Regex formatter. Format regex match using the specification in the format string	regex_formatter()

Iterators

Table 9.9. Find Iterators

Iterator name	Description	Iterator class
find_iterator	Iterates through matching substrings in the input	find_iterator
split_iterator	Iterates through gaps between matching substrings in the input	split_iterator

Classification

Table 9.10. Predicates

Predicate name	Description	Generator
is_classified	Generic `ctype` mask based classification	is_classified()
is_space	Recognize spaces	is_space()
is_alnum	Recognize alphanumeric characters	is_alnum()
is_alpha	Recognize letters	is_alpha()
is_cntrl	Recognize control characters	is_cntrl()
is_digit	Recognize decimal digits	is_digit()
is_graph	Recognize graphical characters	is_graph()
is_lower	Recognize lower case characters	is_lower()
is_print	Recognize printable characters	is_print()
is_punct	Recognize punctuation characters	is_punct()
is_upper	Recognize uppercase characters	is_upper()
is_xdigit	Recognize hexadecimal digits	is_xdigit()