cpp/string/basic string/replace with range - Revision history

Space Mission: ##

2023-10-27T01:57:16Z

← Older revision		Revision as of 01:57, 27 October 2023
Line 24:		Line 24:
	{{par begin}}		{{par begin}}
	{{par\|first, last\|range of characters that is going to be replaced}}		{{par\|first, last\|range of characters that is going to be replaced}}
	{{par\|rg\|a {{ls\|cpp/ranges/to\|container compatible range}}}}		{{par\|rg\|a {{ls\|cpp/ranges/to#container compatible range}}}}
	{{par end}}		{{par end}}

Line 39:		Line 39:

	===Notes===		===Notes===
	{{feature test macro\|__cpp_lib_containers_ranges\|value=202202L\|std=C++23\|member functions that accept {{ls\|cpp/ranges/to\|container compatible range}}}}		{{feature test macro\|__cpp_lib_containers_ranges\|value=202202L\|std=C++23\|member functions that accept {{ls\|cpp/ranges/to#container compatible range}}}}

	===Example===		===Example===

Space Mission: /* Example */ +

2023-08-09T02:20:33Z

Example: +

@@ Line 42: / Line 42: @@
 ===Example===
-{{example}}
+{{example
 ===See also===

Space Mission: /* Exceptions */ .

2023-07-26T19:45:59Z

Exceptions: .

← Older revision		Revision as of 19:45, 26 July 2023
Line 34:		Line 34:

	===Exceptions===		===Exceptions===
	~~Throws~~ {{~~lc\|std::length_error}} if the resulting~~ string ~~size would exceed {{rlpf\|max_size~~}}.		{{cpp/string/basic_string/length error note}}

	{{cpp/strong exception safety guarantee}}		{{cpp/strong exception safety guarantee}}

Space Mission: ~link

2023-06-11T16:06:57Z

~link

← Older revision		Revision as of 16:06, 11 June 2023
Line 24:		Line 24:
	{{par begin}}		{{par begin}}
	{{par\|first, last\|range of characters that is going to be replaced}}		{{par\|first, last\|range of characters that is going to be replaced}}
	{{par\|rg\|a [[cpp/ranges/to\|container-compatible range]]}}		{{par\|rg\|a {{ls\|cpp/ranges/to\|container compatible range}}}}
	{{par end}}		{{par end}}

Line 39:		Line 39:

	===Notes===		===Notes===
	{{feature test macro\|__cpp_lib_containers_ranges\|value=202202L\|std=C++23\|member functions that accept [[cpp/ranges/to\|container-compatible range]]}}		{{feature test macro\|__cpp_lib_containers_ranges\|value=202202L\|std=C++23\|member functions that accept {{ls\|cpp/ranges/to\|container compatible range}}}}

	===Example===		===Example===

Space Mission: /* Notes */ +FTM

2023-06-11T15:41:12Z

Notes: +FTM

← Older revision		Revision as of 15:41, 11 June 2023
Line 1:		Line 1:
	{{cpp/string/basic_string/title\|replace_with_range}}		{{cpp/string/basic_string/title\|replace_with_range}}
	{{cpp/string/basic_string/navbar}}		{{cpp/string/basic_string/navbar}}
	{{~~dcl begin}}~~		{{ddcl\|since=c++23\|1=
	~~{{dcl\|num=1~~\|since=c++23\|1=
	template< container-compatible-range<CharT> R >		template< container-compatible-range<CharT> R >
	constexpr std::basic_string& replace_with_range( const_iterator first,		constexpr std::basic_string& replace_with_range( const_iterator first,
Line 8:		Line 7:
	R&& rg );		R&& rg );
	}}		}}
	~~{{dcl end}}~~

	Replaces the characters in the range {{range\|first\|last}} with the characters from the range {{c\|rg}}.		Replaces the characters in the range {{range\|first\|last}} with the characters from the range {{c\|rg}}.
Line 26:		Line 24:
	{{par begin}}		{{par begin}}
	{{par\|first, last\|range of characters that is going to be replaced}}		{{par\|first, last\|range of characters that is going to be replaced}}
	{{par\|rg\|a [[cpp/ranges/to\|''container-compatible-range'']]}}		{{par\|rg\|a [[cpp/ranges/to\|container-compatible range]]}}
	{{par end}}		{{par end}}

Line 39:		Line 37:

	{{cpp/strong exception safety guarantee}}		{{cpp/strong exception safety guarantee}}

			===Notes===
			{{feature test macro\|__cpp_lib_containers_ranges\|value=202202L\|std=C++23\|member functions that accept [[cpp/ranges/to\|container-compatible range]]}}

	===Example===		===Example===

Andreas Krug: fmt, {{c}}

2023-06-09T21:32:03Z

fmt, {{c}}

← Older revision		Revision as of 21:32, 9 June 2023
Line 10:		Line 10:
	{{dcl end}}		{{dcl end}}

	Replaces the characters in the range {{range\|first\|last}} with the characters from the range {{tt\|rg}}		Replaces the characters in the range {{range\|first\|last}} with the characters from the range {{c\|rg}}.


	Equivalent to		Equivalent to
	{{source\|1=		{{source\|1=
	return replace( first,		return replace(first,
	last,		last,
	std::basic_string(		std::basic_string(
	std::from_range,		std::from_range,
	std::forward<R>(rg),		std::forward<R>(rg),
	get_allocator()));		get_allocator())
			);
	}}		}}

Line 26:		Line 26:
	{{par begin}}		{{par begin}}
	{{par\|first, last\|range of characters that is going to be replaced}}		{{par\|first, last\|range of characters that is going to be replaced}}
	{{par\|rg\|A [[cpp/ranges/to\|''container-compatible-range'']].}}		{{par\|rg\|a [[cpp/ranges/to\|''container-compatible-range'']]}}
	{{par end}}		{{par end}}

Cubbi: +

2023-06-09T21:13:33Z

New page

{{cpp/string/basic_string/title|replace_with_range}}
{{cpp/string/basic_string/navbar}}
{{dcl begin}}
{{dcl|num=1|since=c++23|1=
template< container-compatible-range<CharT> R >
constexpr std::basic_string& replace_with_range( const_iterator first,
const_iterator last,
R&& rg );
}}
{{dcl end}}

Replaces the characters in the range {{range|first|last}} with the characters from the range {{tt|rg}}

Equivalent to
{{source|1=
return replace( first,
last,
std::basic_string(
std::from_range,
std::forward<R>(rg),
get_allocator()));
}}

===Parameters===
{{par begin}}
{{par|first, last|range of characters that is going to be replaced}}
{{par|rg|A [[cpp/ranges/to|''container-compatible-range'']].}}
{{par end}}

===Return value===
{{c|*this}}

===Complexity===
Linear in size of {{c|rg}}.

===Exceptions===
Throws {{lc|std::length_error}} if the resulting string size would exceed {{rlpf|max_size}}.

{{cpp/strong exception safety guarantee}}

===Example===
{{example}}

===See also===
{{dsc begin}}
{{dsc inc|cpp/string/basic_string/dsc replace}}
{{dsc end}}

{{langlinks|de|es|fr|it|ja|pl|pt|ru|zh}}