cpp/string/basic string - Revision history

Cooky: ~

2025-02-19T00:06:27Z

← Older revision		Revision as of 00:06, 19 February 2025
Line 29:		Line 29:
	If any of {{tt\|Traits::char_type}} and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}, the program is ill-formed.		If any of {{tt\|Traits::char_type}} and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}, the program is ill-formed.

	{{~~rrev~~\|since=c++20\|		{{cpp/is_constexpr\|since=c++20\|transient=yes}}
	~~Member functions of {{tt\|std::basic_string}} are {{c/core\|constexpr}}: it is possible to create and use {{tt\|std::string}} objects in the evaluation of a constant expression.~~

	~~However, {{tt\|std::string}} objects generally cannot be {{c/core\|constexpr}}, because any dynamically allocated storage must be released in the same evaluation of constant expression.~~
	}}

	Several typedefs for common character types are provided:		Several typedefs for common character types are provided:

Xmcgcg: Added LWG issue #2861 DR.

2024-11-11T02:05:06Z

Added LWG issue #2861 DR.

← Older revision		Revision as of 02:05, 11 November 2024
Line 39:		Line 39:
	{{dsc header\|string}}		{{dsc header\|string}}
	{{dsc hitem\|Type\|Definition}}		{{dsc hitem\|Type\|Definition}}
	{{dsc\|{{lc\|std::string}}\|{{c/core\|std::basic_string<char>}}}}		{{dsc\|{{tt\|std::string}}\|{{c/core\|std::basic_string<char>}}}}
	{{dsc\|{{lc\|std::wstring}}\|{{c/core\|std::basic_string<wchar_t>}}}}		{{dsc\|{{tt\|std::wstring}}\|{{c/core\|std::basic_string<wchar_t>}}}}
	{{dsc\|{{lc\|std::u8string}} {{mark c++20}}\|{{c/core\|std::basic_string<char8_t>}}}}		{{dsc\|{{tt\|std::u8string}} {{mark c++20}}\|{{c/core\|std::basic_string<char8_t>}}}}
	{{dsc\|{{lc\|std::u16string}} {{mark c++11}}\|{{c/core\|std::basic_string<char16_t>}}}}		{{dsc\|{{tt\|std::u16string}} {{mark c++11}}\|{{c/core\|std::basic_string<char16_t>}}}}
	{{dsc\|{{lc\|std::u32string}} {{mark c++11}}\|{{c/core\|std::basic_string<char32_t>}}}}		{{dsc\|{{tt\|std::u32string}} {{mark c++11}}\|{{c/core\|std::basic_string<char32_t>}}}}
	{{dsc\|{{lc\|std::pmr::string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char>}}}}		{{dsc\|{{tt\|std::pmr::string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char>}}}}
	{{dsc\|{{lc\|std::pmr::wstring}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<wchar_t>}}}}		{{dsc\|{{tt\|std::pmr::wstring}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<wchar_t>}}}}
	{{dsc\|{{lc\|std::pmr::u8string}} {{mark c++20}}\|{{c/core\|std::pmr::basic_string<char8_t>}}}}		{{dsc\|{{tt\|std::pmr::u8string}} {{mark c++20}}\|{{c/core\|std::pmr::basic_string<char8_t>}}}}
	{{dsc\|{{lc\|std::pmr::u16string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char16_t>}}}}		{{dsc\|{{tt\|std::pmr::u16string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char16_t>}}}}
	{{dsc\|{{lc\|std::pmr::u32string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char32_t>}}}}		{{dsc\|{{tt\|std::pmr::u32string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char32_t>}}}}
	{{dsc end}}		{{dsc end}}

Line 58:		Line 58:
	{{par end}}		{{par end}}

	===~~Member~~ types===		===Nested types===
	{{dsc begin}}		{{dsc begin}}
	{{dsc hitem\|~~Member type~~\|Definition}}		{{dsc hitem\|Type\|Definition}}
	{{dsc\|{{tt\|traits_type}}\|{{tt\|Traits}}}}		{{dsc\|{{tt\|traits_type}}\|{{tt\|Traits}}}}
	{{dsc\|{{tt\|value_type}}\|{{tt\|CharT~~}}{{mark unreviewed dr\|LWG\|2861~~}}}}		{{dsc\|{{tt\|value_type}}\|{{tt\|CharT}}}}
	{{dsc inc\|cpp/container/dsc allocator_type\|basic_string}}		{{dsc inc\|cpp/container/dsc allocator_type\|basic_string}}
	{{dsc inc\|cpp/container/dsc size_type\|basic_string}}		{{dsc inc\|cpp/container/dsc size_type\|basic_string}}
Line 74:		Line 74:
	{{dsc inc\|cpp/container/dsc reverse_iterator\|basic_string}}		{{dsc inc\|cpp/container/dsc reverse_iterator\|basic_string}}
	{{dsc inc\|cpp/container/dsc const_reverse_iterator\|basic_string}}		{{dsc inc\|cpp/container/dsc const_reverse_iterator\|basic_string}}
			{{dsc end}}

			===Data members===
			{{dsc begin}}
			{{cpp/string/basic string/dsc npos}}
	{{dsc end}}		{{dsc end}}

Line 139:		Line 144:
	{{dsc inc\|cpp/string/basic_string/dsc contains}}		{{dsc inc\|cpp/string/basic_string/dsc contains}}
	{{dsc inc\|cpp/string/basic_string/dsc substr}}		{{dsc inc\|cpp/string/basic_string/dsc substr}}

	~~{{dsc h1\|Constants}}~~
	~~{{dsc inc\|cpp/string/basic_string/dsc npos}}~~
	{{dsc end}}		{{dsc end}}

Line 235:		Line 237:
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=530\|std=C++98\|before=contiguity of the storage for elements of {{tt\|basic_string}}<br>was accidently made not required by {{wg21\|LWG259}}\|after=required again}}		{{dr list item\|wg=lwg\|dr=530\|std=C++98\|before=contiguity of the storage for elements of {{tt\|basic_string}}<br>was accidently made not required by {{wg21\|LWG259}}\|after=required again}}
			{{dr list item\|wg=lwg\|dr=2861\|std=C++98\|before={{tt\|value_type}} was {{tt\|Traits::char_type}}\|after=changed to {{tt\|CharT}}}}
	{{dr list item\|wg=lwg\|dr=2994\|paper=P1148R0\|std=C++98\|before=the behavior is undefined if any of {{tt\|Traits::char_type}}<ref>The {{tt\|Traits::char_type}} case is fixed in {{stddoc\|P1148R0}}.</ref><br>and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}\|after=the program is<br>ill-formed in this case}}		{{dr list item\|wg=lwg\|dr=2994\|paper=P1148R0\|std=C++98\|before=the behavior is undefined if any of {{tt\|Traits::char_type}}<ref>The {{tt\|Traits::char_type}} case is fixed in {{stddoc\|P1148R0}}.</ref><br>and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}\|after=the program is<br>ill-formed in this case}}
	{{dr list end}}		{{dr list end}}

Cubbi: iterator invalidation from https://eel.is/c++draft/string.classes#string.require-4

2024-07-31T19:07:27Z

iterator invalidation from https://eel.is/c++draft/string.classes#string.require-4

← Older revision		Revision as of 19:07, 31 July 2024
Line 174:		Line 174:

	===[[cpp/string/basic_string/deduction_guides\|Deduction guides]] {{mark since c++17}}===		===[[cpp/string/basic_string/deduction_guides\|Deduction guides]] {{mark since c++17}}===

			===Iterator invalidation===
			References, pointers, and iterators referring to the elements of a {{tt\|basic_string}} may be invalidated by any standard library function taking a reference to non-const {{tt\|basic_string}} as an argument, such as {{lc\|std::getline}}, {{lc\|std::swap}}, or {{ltt\|cpp/string/basic_string/operator_ltltgtgt\|operator>>}}, and by calling non-const member functions, except {{ltt\|cpp/string/basic_string/operator_at\|operator[]}}, {{rlt\|at}}, {{rlt\|data}}, {{rlt\|front}}, {{rlt\|back}}, {{rlt\|begin}}, {{rlt\|rbegin}}, {{rlt\|end}}, and {{rlt\|rend}}.

	===Notes===		===Notes===

Fruderica: /* Defect reports */ explain LWG530 - the contiguity was required before LWG259

2024-01-10T12:38:47Z

Defect reports: explain LWG530 - the contiguity was required before LWG259

← Older revision		Revision as of 12:38, 10 January 2024
Line 231:		Line 231:
	===Defect reports===		===Defect reports===
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=530\|std=C++98\|before=contiguity of the storage for elements of {{tt\|basic_string}} was not required\|after=required}}		{{dr list item\|wg=lwg\|dr=530\|std=C++98\|before=contiguity of the storage for elements of {{tt\|basic_string}}<br>was accidently made not required by {{wg21\|LWG259}}\|after=required again}}
	{{dr list item\|wg=lwg\|dr=2994\|paper=P1148R0\|std=C++98\|before=the behavior is undefined if any of {{tt\|Traits::char_type}}<ref>The {{tt\|Traits::char_type}} case is fixed in {{stddoc\|P1148R0}}.</ref><br>and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}\|after=the program is<br>ill-formed in this case}}		{{dr list item\|wg=lwg\|dr=2994\|paper=P1148R0\|std=C++98\|before=the behavior is undefined if any of {{tt\|Traits::char_type}}<ref>The {{tt\|Traits::char_type}} case is fixed in {{stddoc\|P1148R0}}.</ref><br>and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}\|after=the program is<br>ill-formed in this case}}
	{{dr list end}}		{{dr list end}}

Andreas Krug: fmt

2023-12-25T18:17:33Z

fmt

← Older revision		Revision as of 18:17, 25 December 2023
Line 191:		Line 191:
	===Example===		===Example===
	{{example		{{example
	\|
	\|code=		\|code=
	#include <iostream>		#include <iostream>

YexuanXiao at 15:20, 22 December 2023

2023-12-22T15:20:51Z

← Older revision		Revision as of 15:20, 22 December 2023
Line 21:		Line 21:
	{{dcl end}}		{{dcl end}}

	The class template {{tt\|basic_string}} stores and manipulates sequences of [[cpp/language/types#Character types\|character]]-like objects, which are non-array objects of ~~[[cpp/~~named req/TrivialType~~\|trivial]] [[cpp/~~named req/StandardLayoutType~~\|standard-layout]] type~~. The class is dependent neither on the character type nor on the nature of operations on that type. The definitions of the operations are supplied via the {{tt\|Traits}} template parameter - a specialization of {{lc\|std::char_traits}} or a compatible traits class.		The class template {{tt\|basic_string}} stores and manipulates sequences of [[cpp/language/types#Character types\|character]]-like objects, which are non-array objects of {{named req\|TrivialType}} and {{named req\|StandardLayoutType}}. The class is dependent neither on the character type nor on the nature of operations on that type. The definitions of the operations are supplied via the {{tt\|Traits}} template parameter - a specialization of {{lc\|std::char_traits}} or a compatible traits class.

	The elements of a {{tt\|basic_string}} are stored contiguously, that is, for a {{tt\|basic_string}} {{c\|s}}, {{c\|1=&(s.begin() + n) == &s.begin() + n}} for any {{c\|n}} in {{range\|0\|s.size()}}{{rev inl\|since=c++11\|, and {{c\|1=*(s.begin() + s.size())}} has value {{c\|1=CharT()}} (a null terminator)}}; or, equivalently, a pointer to {{c\|s[0]}} can be passed to functions that expect a pointer to the first element of {{rev inl\|until=c++11\|an array}}{{rev inl\|since=c++11\|a null-terminated array}} of {{tt\|CharT}}.		The elements of a {{tt\|basic_string}} are stored contiguously, that is, for a {{tt\|basic_string}} {{c\|s}}, {{c\|1=&(s.begin() + n) == &s.begin() + n}} for any {{c\|n}} in {{range\|0\|s.size()}}{{rev inl\|since=c++11\|, and {{c\|1=*(s.begin() + s.size())}} has value {{c\|1=CharT()}} (a null terminator)}}; or, equivalently, a pointer to {{c\|s[0]}} can be passed to functions that expect a pointer to the first element of {{rev inl\|until=c++11\|an array}}{{rev inl\|since=c++11\|a null-terminated array}} of {{tt\|CharT}}.

Ybab321: /* Notes */ +ftms

2023-12-18T09:52:59Z

Notes: +ftms

← Older revision		Revision as of 09:52, 18 December 2023
Line 180:		Line 180:
	{{ftm begin\|std=1\|value=1\|comment=1\|sort=1}}		{{ftm begin\|std=1\|value=1\|comment=1\|sort=1}}
	{{ftm\|std=C++14\|value=201304L\|__cpp_lib_string_udls\|[[#Literals\|User-defined literals for string types]]}}		{{ftm\|std=C++14\|value=201304L\|__cpp_lib_string_udls\|[[#Literals\|User-defined literals for string types]]}}
			{{ftm\|std=C++20\|value=201711L\|__cpp_lib_starts_ends_with\|{{rlt\|starts_with}}, {{rlt\|ends_with}}}}
			{{ftm\|std=C++20\|value=201907L\|__cpp_lib_constexpr_string\|Constexpr for {{tt\|std::basic_string}}}}
			{{ftm\|std=C++20\|value=201907L\|__cpp_lib_char8_t\|{{tt\|std::u8string}}}}
			{{ftm\|std=C++20\|value=202002L\|__cpp_lib_erase_if\|{{rlt\|erase2\|erase}}, {{rlt\|erase2\|erase_if}}}}
	{{ftm\|std=C++23\|value=202011L\|__cpp_lib_string_contains\|{{rlt\|contains}}}}		{{ftm\|std=C++23\|value=202011L\|__cpp_lib_string_contains\|{{rlt\|contains}}}}
	{{ftm\|std=C++23\|value=202110L\|__cpp_lib_string_resize_and_overwrite\|{{rlt\|resize_and_overwrite}}}}		{{ftm\|std=C++23\|value=202110L\|__cpp_lib_string_resize_and_overwrite\|{{rlt\|resize_and_overwrite}}}}
	{{ftm~~\|__cpp_lib_containers_ranges\|value=202202L~~\|std=C++23\|Member functions for construction, insertion, and replacement that accept {{ls\|cpp/ranges/to#container compatible range}}}}		{{ftm\|std=C++23\|value=202202L\|__cpp_lib_containers_ranges\|Member functions for construction, insertion, and replacement that accept {{ls\|cpp/ranges/to#container compatible range}}}}
	{{ftm end}}		{{ftm end}}

Xmcgcg: Added LWG issue #2994 DR.

2023-11-03T07:05:16Z

Added LWG issue #2994 DR.

← Older revision		Revision as of 07:05, 3 November 2023
Line 21:		Line 21:
	{{dcl end}}		{{dcl end}}

	The class template {{tt\|basic_string}} stores and manipulates sequences of [[cpp/language/types#Character types\|character]]-like objects, which are non-array objects of [[cpp/named req/TrivialType\|trivial]] [[cpp/named req/StandardLayoutType\|standard-layout]] type. The class is dependent neither on the character type nor on the nature of operations on that type. The definitions of the operations are supplied via the {{tt\|Traits}} template parameter - a specialization of {{lc\|std::char_traits}} or a compatible traits class. ~~{{tt\|Traits::char_type}} and {{tt\|CharT}} must name the same type; otherwise the program is ill-formed. {{mark unreviewed dr\|LWG\|P1148}}~~		The class template {{tt\|basic_string}} stores and manipulates sequences of [[cpp/language/types#Character types\|character]]-like objects, which are non-array objects of [[cpp/named req/TrivialType\|trivial]] [[cpp/named req/StandardLayoutType\|standard-layout]] type. The class is dependent neither on the character type nor on the nature of operations on that type. The definitions of the operations are supplied via the {{tt\|Traits}} template parameter - a specialization of {{lc\|std::char_traits}} or a compatible traits class.

	The elements of a {{tt\|basic_string}} are stored contiguously, that is, for a {{tt\|basic_string}} {{c\|s}}, {{c\|1=&(s.begin() + n) == &s.begin() + n}} for any {{c\|n}} in {{range\|0\|s.size()}}{{rev inl\|since=c++11\|, and {{c\|1=*(s.begin() + s.size())}} has value {{c\|1=CharT()}} (a null terminator)}}; or, equivalently, a pointer to {{c\|s[0]}} can be passed to functions that expect a pointer to the first element of {{rev inl\|until=c++11\|an array}}{{rev inl\|since=c++11\|a null-terminated array}} of {{tt\|CharT}}.		The elements of a {{tt\|basic_string}} are stored contiguously, that is, for a {{tt\|basic_string}} {{c\|s}}, {{c\|1=&(s.begin() + n) == &s.begin() + n}} for any {{c\|n}} in {{range\|0\|s.size()}}{{rev inl\|since=c++11\|, and {{c\|1=*(s.begin() + s.size())}} has value {{c\|1=CharT()}} (a null terminator)}}; or, equivalently, a pointer to {{c\|s[0]}} can be passed to functions that expect a pointer to the first element of {{rev inl\|until=c++11\|an array}}{{rev inl\|since=c++11\|a null-terminated array}} of {{tt\|CharT}}.

	{{tt\|std::basic_string}} satisfies the requirements of {{named req\|AllocatorAwareContainer}} (except that customized {{tt\|construct}}/{{tt\|destroy}} are not used for construction/destruction of elements), {{named req\|SequenceContainer}}{{rev inl\|since=c++17\| and {{named req\|ContiguousContainer}}}}.		{{tt\|std::basic_string}} satisfies the requirements of {{named req\|AllocatorAwareContainer}} (except that customized {{tt\|construct}}/{{tt\|destroy}} are not used for construction/destruction of elements), {{named req\|SequenceContainer}}{{rev inl\|since=c++17\| and {{named req\|ContiguousContainer}}}}.

			If any of {{tt\|Traits::char_type}} and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}, the program is ill-formed.

	{{rrev\|since=c++20\|		{{rrev\|since=c++20\|
Line 227:		Line 229:
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=530\|std=C++98\|before=contiguity of the storage for elements of {{tt\|basic_string}} was not required\|after=required}}		{{dr list item\|wg=lwg\|dr=530\|std=C++98\|before=contiguity of the storage for elements of {{tt\|basic_string}} was not required\|after=required}}
			{{dr list item\|wg=lwg\|dr=2994\|paper=P1148R0\|std=C++98\|before=the behavior is undefined if any of {{tt\|Traits::char_type}}<ref>The {{tt\|Traits::char_type}} case is fixed in {{stddoc\|P1148R0}}.</ref><br>and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}\|after=the program is<br>ill-formed in this case}}
	{{dr list end}}		{{dr list end}}
			<references/>

	===See also===		===See also===

D41D8CD98F: /* Member functions */ reorder

2023-11-02T02:29:18Z

Member functions: reorder

← Older revision		Revision as of 02:29, 2 November 2023
Line 106:		Line 106:
	{{dsc inc\|cpp/string/basic_string/dsc shrink_to_fit}}		{{dsc inc\|cpp/string/basic_string/dsc shrink_to_fit}}

	{{dsc h2\|~~Operations~~}}		{{dsc h2\|Modifiers}}
	{{dsc inc\|cpp/string/basic_string/dsc clear}}		{{dsc inc\|cpp/string/basic_string/dsc clear}}
	{{dsc inc\|cpp/string/basic_string/dsc insert}}		{{dsc inc\|cpp/string/basic_string/dsc insert}}
Line 116:		Line 116:
	{{dsc inc\|cpp/string/basic_string/dsc append_range}}		{{dsc inc\|cpp/string/basic_string/dsc append_range}}
	{{dsc inc\|cpp/string/basic_string/dsc operator+{{=}}}}		{{dsc inc\|cpp/string/basic_string/dsc operator+{{=}}}}
	~~{{dsc inc\|cpp/string/basic_string/dsc compare}}~~
	~~{{dsc inc\|cpp/string/basic_string/dsc starts_with}}~~
	~~{{dsc inc\|cpp/string/basic_string/dsc ends_with}}~~
	~~{{dsc inc\|cpp/string/basic_string/dsc contains}}~~
	{{dsc inc\|cpp/string/basic_string/dsc replace}}		{{dsc inc\|cpp/string/basic_string/dsc replace}}
	{{dsc inc\|cpp/string/basic_string/dsc replace_with_range}}		{{dsc inc\|cpp/string/basic_string/dsc replace_with_range}}
	~~{{dsc inc\|cpp/string/basic_string/dsc substr}}~~
	{{dsc inc\|cpp/string/basic_string/dsc copy}}		{{dsc inc\|cpp/string/basic_string/dsc copy}}
	{{dsc inc\|cpp/string/basic_string/dsc resize}}		{{dsc inc\|cpp/string/basic_string/dsc resize}}
Line 135:		Line 130:
	{{dsc inc\|cpp/string/basic_string/dsc find_last_of}}		{{dsc inc\|cpp/string/basic_string/dsc find_last_of}}
	{{dsc inc\|cpp/string/basic_string/dsc find_last_not_of}}		{{dsc inc\|cpp/string/basic_string/dsc find_last_not_of}}

			{{dsc h2\|Operations}}
			{{dsc inc\|cpp/string/basic_string/dsc compare}}
			{{dsc inc\|cpp/string/basic_string/dsc starts_with}}
			{{dsc inc\|cpp/string/basic_string/dsc ends_with}}
			{{dsc inc\|cpp/string/basic_string/dsc contains}}
			{{dsc inc\|cpp/string/basic_string/dsc substr}}

	{{dsc h1\|Constants}}		{{dsc h1\|Constants}}

Space Mission: #

2023-10-26T21:42:05Z

← Older revision		Revision as of 21:42, 26 October 2023
Line 178:		Line 178:
	{{ftm\|std=C++23\|value=202011L\|__cpp_lib_string_contains\|{{rlt\|contains}}}}		{{ftm\|std=C++23\|value=202011L\|__cpp_lib_string_contains\|{{rlt\|contains}}}}
	{{ftm\|std=C++23\|value=202110L\|__cpp_lib_string_resize_and_overwrite\|{{rlt\|resize_and_overwrite}}}}		{{ftm\|std=C++23\|value=202110L\|__cpp_lib_string_resize_and_overwrite\|{{rlt\|resize_and_overwrite}}}}
	{{ftm\|__cpp_lib_containers_ranges\|value=202202L\|std=C++23\|Member functions for construction, insertion, and replacement that accept {{ls\|cpp/ranges/to\|container compatible range}}}}		{{ftm\|__cpp_lib_containers_ranges\|value=202202L\|std=C++23\|Member functions for construction, insertion, and replacement that accept {{ls\|cpp/ranges/to#container compatible range}}}}
	{{ftm end}}		{{ftm end}}

← Older revision		Revision as of 02:05, 11 November 2024
Line 39:		Line 39:
	{{dsc header\|string}}		{{dsc header\|string}}
	{{dsc hitem\|Type\|Definition}}		{{dsc hitem\|Type\|Definition}}
	{{dsc\|{{lc\|std::string}}\|{{c/core\|std::basic_string<char>}}}}		{{dsc\|{{tt\|std::string}}\|{{c/core\|std::basic_string<char>}}}}
	{{dsc\|{{lc\|std::wstring}}\|{{c/core\|std::basic_string<wchar_t>}}}}		{{dsc\|{{tt\|std::wstring}}\|{{c/core\|std::basic_string<wchar_t>}}}}
	{{dsc\|{{lc\|std::u8string}} {{mark c++20}}\|{{c/core\|std::basic_string<char8_t>}}}}		{{dsc\|{{tt\|std::u8string}} {{mark c++20}}\|{{c/core\|std::basic_string<char8_t>}}}}
	{{dsc\|{{lc\|std::u16string}} {{mark c++11}}\|{{c/core\|std::basic_string<char16_t>}}}}		{{dsc\|{{tt\|std::u16string}} {{mark c++11}}\|{{c/core\|std::basic_string<char16_t>}}}}
	{{dsc\|{{lc\|std::u32string}} {{mark c++11}}\|{{c/core\|std::basic_string<char32_t>}}}}		{{dsc\|{{tt\|std::u32string}} {{mark c++11}}\|{{c/core\|std::basic_string<char32_t>}}}}
	{{dsc\|{{lc\|std::pmr::string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char>}}}}		{{dsc\|{{tt\|std::pmr::string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char>}}}}
	{{dsc\|{{lc\|std::pmr::wstring}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<wchar_t>}}}}		{{dsc\|{{tt\|std::pmr::wstring}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<wchar_t>}}}}
	{{dsc\|{{lc\|std::pmr::u8string}} {{mark c++20}}\|{{c/core\|std::pmr::basic_string<char8_t>}}}}		{{dsc\|{{tt\|std::pmr::u8string}} {{mark c++20}}\|{{c/core\|std::pmr::basic_string<char8_t>}}}}
	{{dsc\|{{lc\|std::pmr::u16string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char16_t>}}}}		{{dsc\|{{tt\|std::pmr::u16string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char16_t>}}}}
	{{dsc\|{{lc\|std::pmr::u32string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char32_t>}}}}		{{dsc\|{{tt\|std::pmr::u32string}} {{mark c++17}}\|{{c/core\|std::pmr::basic_string<char32_t>}}}}
	{{dsc end}}		{{dsc end}}

Line 58:		Line 58:
	{{par end}}		{{par end}}

	===~~Member~~ types===		===Nested types===
	{{dsc begin}}		{{dsc begin}}
	{{dsc hitem\|~~Member type~~\|Definition}}		{{dsc hitem\|Type\|Definition}}
	{{dsc\|{{tt\|traits_type}}\|{{tt\|Traits}}}}		{{dsc\|{{tt\|traits_type}}\|{{tt\|Traits}}}}
	{{dsc\|{{tt\|value_type}}\|{{tt\|CharT~~}}{{mark unreviewed dr\|LWG\|2861~~}}}}		{{dsc\|{{tt\|value_type}}\|{{tt\|CharT}}}}
	{{dsc inc\|cpp/container/dsc allocator_type\|basic_string}}		{{dsc inc\|cpp/container/dsc allocator_type\|basic_string}}
	{{dsc inc\|cpp/container/dsc size_type\|basic_string}}		{{dsc inc\|cpp/container/dsc size_type\|basic_string}}
Line 74:		Line 74:
	{{dsc inc\|cpp/container/dsc reverse_iterator\|basic_string}}		{{dsc inc\|cpp/container/dsc reverse_iterator\|basic_string}}
	{{dsc inc\|cpp/container/dsc const_reverse_iterator\|basic_string}}		{{dsc inc\|cpp/container/dsc const_reverse_iterator\|basic_string}}
			{{dsc end}}

			===Data members===
			{{dsc begin}}
			{{cpp/string/basic string/dsc npos}}
	{{dsc end}}		{{dsc end}}

Line 139:		Line 144:
	{{dsc inc\|cpp/string/basic_string/dsc contains}}		{{dsc inc\|cpp/string/basic_string/dsc contains}}
	{{dsc inc\|cpp/string/basic_string/dsc substr}}		{{dsc inc\|cpp/string/basic_string/dsc substr}}

	~~{{dsc h1\|Constants}}~~
	~~{{dsc inc\|cpp/string/basic_string/dsc npos}}~~
	{{dsc end}}		{{dsc end}}

Line 235:		Line 237:
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=530\|std=C++98\|before=contiguity of the storage for elements of {{tt\|basic_string}}<br>was accidently made not required by {{wg21\|LWG259}}\|after=required again}}		{{dr list item\|wg=lwg\|dr=530\|std=C++98\|before=contiguity of the storage for elements of {{tt\|basic_string}}<br>was accidently made not required by {{wg21\|LWG259}}\|after=required again}}
			{{dr list item\|wg=lwg\|dr=2861\|std=C++98\|before={{tt\|value_type}} was {{tt\|Traits::char_type}}\|after=changed to {{tt\|CharT}}}}
	{{dr list item\|wg=lwg\|dr=2994\|paper=P1148R0\|std=C++98\|before=the behavior is undefined if any of {{tt\|Traits::char_type}}<ref>The {{tt\|Traits::char_type}} case is fixed in {{stddoc\|P1148R0}}.</ref><br>and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}\|after=the program is<br>ill-formed in this case}}		{{dr list item\|wg=lwg\|dr=2994\|paper=P1148R0\|std=C++98\|before=the behavior is undefined if any of {{tt\|Traits::char_type}}<ref>The {{tt\|Traits::char_type}} case is fixed in {{stddoc\|P1148R0}}.</ref><br>and {{tt\|Allocator::char_type}} is different from {{tt\|CharT}}\|after=the program is<br>ill-formed in this case}}
	{{dr list end}}		{{dr list end}}

← Older revision		Revision as of 09:52, 18 December 2023
Line 180:		Line 180:
	{{ftm begin\|std=1\|value=1\|comment=1\|sort=1}}		{{ftm begin\|std=1\|value=1\|comment=1\|sort=1}}
	{{ftm\|std=C++14\|value=201304L\|__cpp_lib_string_udls\|[[#Literals\|User-defined literals for string types]]}}		{{ftm\|std=C++14\|value=201304L\|__cpp_lib_string_udls\|[[#Literals\|User-defined literals for string types]]}}
			{{ftm\|std=C++20\|value=201711L\|__cpp_lib_starts_ends_with\|{{rlt\|starts_with}}, {{rlt\|ends_with}}}}
			{{ftm\|std=C++20\|value=201907L\|__cpp_lib_constexpr_string\|Constexpr for {{tt\|std::basic_string}}}}
			{{ftm\|std=C++20\|value=201907L\|__cpp_lib_char8_t\|{{tt\|std::u8string}}}}
			{{ftm\|std=C++20\|value=202002L\|__cpp_lib_erase_if\|{{rlt\|erase2\|erase}}, {{rlt\|erase2\|erase_if}}}}
	{{ftm\|std=C++23\|value=202011L\|__cpp_lib_string_contains\|{{rlt\|contains}}}}		{{ftm\|std=C++23\|value=202011L\|__cpp_lib_string_contains\|{{rlt\|contains}}}}
	{{ftm\|std=C++23\|value=202110L\|__cpp_lib_string_resize_and_overwrite\|{{rlt\|resize_and_overwrite}}}}		{{ftm\|std=C++23\|value=202110L\|__cpp_lib_string_resize_and_overwrite\|{{rlt\|resize_and_overwrite}}}}
	{{ftm~~\|__cpp_lib_containers_ranges\|value=202202L~~\|std=C++23\|Member functions for construction, insertion, and replacement that accept {{ls\|cpp/ranges/to#container compatible range}}}}		{{ftm\|std=C++23\|value=202202L\|__cpp_lib_containers_ranges\|Member functions for construction, insertion, and replacement that accept {{ls\|cpp/ranges/to#container compatible range}}}}
	{{ftm end}}		{{ftm end}}

← Older revision		Revision as of 02:29, 2 November 2023
Line 106:		Line 106:
	{{dsc inc\|cpp/string/basic_string/dsc shrink_to_fit}}		{{dsc inc\|cpp/string/basic_string/dsc shrink_to_fit}}

	{{dsc h2\|~~Operations~~}}		{{dsc h2\|Modifiers}}
	{{dsc inc\|cpp/string/basic_string/dsc clear}}		{{dsc inc\|cpp/string/basic_string/dsc clear}}
	{{dsc inc\|cpp/string/basic_string/dsc insert}}		{{dsc inc\|cpp/string/basic_string/dsc insert}}
Line 116:		Line 116:
	{{dsc inc\|cpp/string/basic_string/dsc append_range}}		{{dsc inc\|cpp/string/basic_string/dsc append_range}}
	{{dsc inc\|cpp/string/basic_string/dsc operator+{{=}}}}		{{dsc inc\|cpp/string/basic_string/dsc operator+{{=}}}}
	~~{{dsc inc\|cpp/string/basic_string/dsc compare}}~~
	~~{{dsc inc\|cpp/string/basic_string/dsc starts_with}}~~
	~~{{dsc inc\|cpp/string/basic_string/dsc ends_with}}~~
	~~{{dsc inc\|cpp/string/basic_string/dsc contains}}~~
	{{dsc inc\|cpp/string/basic_string/dsc replace}}		{{dsc inc\|cpp/string/basic_string/dsc replace}}
	{{dsc inc\|cpp/string/basic_string/dsc replace_with_range}}		{{dsc inc\|cpp/string/basic_string/dsc replace_with_range}}
	~~{{dsc inc\|cpp/string/basic_string/dsc substr}}~~
	{{dsc inc\|cpp/string/basic_string/dsc copy}}		{{dsc inc\|cpp/string/basic_string/dsc copy}}
	{{dsc inc\|cpp/string/basic_string/dsc resize}}		{{dsc inc\|cpp/string/basic_string/dsc resize}}
Line 135:		Line 130:
	{{dsc inc\|cpp/string/basic_string/dsc find_last_of}}		{{dsc inc\|cpp/string/basic_string/dsc find_last_of}}
	{{dsc inc\|cpp/string/basic_string/dsc find_last_not_of}}		{{dsc inc\|cpp/string/basic_string/dsc find_last_not_of}}

			{{dsc h2\|Operations}}
			{{dsc inc\|cpp/string/basic_string/dsc compare}}
			{{dsc inc\|cpp/string/basic_string/dsc starts_with}}
			{{dsc inc\|cpp/string/basic_string/dsc ends_with}}
			{{dsc inc\|cpp/string/basic_string/dsc contains}}
			{{dsc inc\|cpp/string/basic_string/dsc substr}}

	{{dsc h1\|Constants}}		{{dsc h1\|Constants}}