cpp/string/basic string/operator at - Revision history

Space Mission: {{rrev multi}}.

2025-03-28T05:08:36Z

{{rrev multi}}.

← Older revision		Revision as of 05:08, 28 March 2025
Line 13:		Line 13:

	@1@ {{rel\|		@1@ {{rel\|
	{{~~rev begin}}~~		{{rrev multi\|until1=c++11\|rev1=
	~~{{rev~~\|~~until~~=c++11\|
	The behavior is undefined.		The behavior is undefined.
	}}		\|rev2=
	~~{{rev~~\|~~since~~=~~c++11\|~~
	Returns a reference to {{c\|CharT()}}, if the object referred by the returned reference is modified to any value other than {{c\|CharT()}}, the behavior is undefined.		Returns a reference to {{c\|CharT()}}, if the object referred by the returned reference is modified to any value other than {{c\|CharT()}}, the behavior is undefined.
	}}		}}
	~~{{rev end}}~~
	}}		}}

Xmcgcg: Minor tweak.

2025-03-28T02:17:11Z

Minor tweak.

← Older revision		Revision as of 02:17, 28 March 2025
Line 12:		Line 12:
	Returns a reference to the character at specified location {{c\|pos}} if {{c\|pos < size()}}, or if {{c\|1=pos == size()}}:		Returns a reference to the character at specified location {{c\|pos}} if {{c\|pos < size()}}, or if {{c\|1=pos == size()}}:

	@1@		@1@ {{rel\|
	{{rel\|
	{{rev begin}}		{{rev begin}}
	{{rev\|until=c++11\|		{{rev\|until=c++11\|

Space Mission: Apply {{rel}}.

2025-03-28T01:33:24Z

Apply {{rel}}.

← Older revision		Revision as of 01:33, 28 March 2025
Line 12:		Line 12:
	Returns a reference to the character at specified location {{c\|pos}} if {{c\|pos < size()}}, or if {{c\|1=pos == size()}}:		Returns a reference to the character at specified location {{c\|pos}} if {{c\|pos < size()}}, or if {{c\|1=pos == size()}}:

	@1@ ~~<div style="position: relative; bottom: 1.2em; margin-top: -0.4em; margin-bottom: -1.2em;">~~{{rev begin}}		@1@
			{{rel\|
			{{rev begin}}
	{{rev\|until=c++11\|		{{rev\|until=c++11\|
	The behavior is undefined.		The behavior is undefined.
Line 19:		Line 21:
	Returns a reference to {{c\|CharT()}}, if the object referred by the returned reference is modified to any value other than {{c\|CharT()}}, the behavior is undefined.		Returns a reference to {{c\|CharT()}}, if the object referred by the returned reference is modified to any value other than {{c\|CharT()}}, the behavior is undefined.
	}}		}}
	{{rev end}}~~</div>~~		{{rev end}}
			}}

	@2@ Returns a reference to {{c\|CharT()}}.		@2@ Returns a reference to {{c\|CharT()}}.

			{{p}}
	{{cpp/hardened ub if\|since=c++26\|{{c\|pos > size()}} is {{c\|true}}}}		{{cpp/hardened ub if\|since=c++26\|{{c\|pos > size()}} is {{c\|true}}}}

Space Mission: /* Defect reports */ + link to synopsis.

2025-03-27T21:51:19Z

Defect reports: + link to synopsis.

← Older revision		Revision as of 21:51, 27 March 2025
Line 2:		Line 2:
	{{cpp/string/basic_string/navbar}}		{{cpp/string/basic_string/navbar}}
	{{dcl begin}}		{{dcl begin}}
	{{dcla~~\|anchor=no~~\|num=1\|constexpr=c++20\|		{{dcla\|num=1\|constexpr=c++20\|
	CharT& operator[]( size_type pos );		CharT& operator[]( size_type pos );
	}}		}}
Line 68:		Line 68:
	===Defect reports===		===Defect reports===
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=259\|std=C++98\|before=overload {{v\|1}} could return const lvalue<br>{{c\|data()[pos]}}, which was ill-formed\|after=changed to return<br>{{c\|*(begin() + pos)}}}}		{{dr list item\|wg=lwg\|dr=259\|std=C++98\|before=overload {{vl\|1}} could return const lvalue<br>{{c\|data()[pos]}}, which was ill-formed\|after=changed to return<br>{{c\|*(begin() + pos)}}}}
	{{dr list item\|wg=lwg\|dr=2475\|std=C++11\|before=if {{c\|1=pos == size()}}, the behavior of modifying the<br>object referred by the returned reference was undefined\|after=well-defined if<br>modified to {{c\|CharT()}}}}		{{dr list item\|wg=lwg\|dr=2475\|std=C++11\|before=if {{c\|1=pos == size()}}, the behavior of modifying the<br>object referred by the returned reference was undefined\|after=well-defined if<br>modified to {{c\|CharT()}}}}
	{{dr list end}}		{{dr list end}}
Line 77:		Line 77:
	{{dsc inc\|cpp/string/basic_string/dsc front}}		{{dsc inc\|cpp/string/basic_string/dsc front}}
	{{dsc inc\|cpp/string/basic_string/dsc back}}		{{dsc inc\|cpp/string/basic_string/dsc back}}
	{{dsc inc\|cpp/string/basic_string_view/dsc ~~{{SUBPAGENAMEE}}~~}}		{{dsc inc\|cpp/string/basic_string_view/dsc operator at}}
	{{dsc end}}		{{dsc end}}

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

Xmcgcg: Applied P3471R4 (Standard Library Hardening). This page uses
to allow a revbox following @@, I will create a template for that if there is no objection.

2025-03-27T08:33:38Z

Applied P3471R4 (Standard Library Hardening). This page uses <div style="position: relative; bottom: 1.2em; margin-top: -0.4em; margin-bottom: -1.2em;"> to allow a revbox following @@, I will create a template for that if there is no objection.

← Older revision		Revision as of 08:33, 27 March 2025
Line 10:		Line 10:
	{{dcl end}}		{{dcl end}}

	Returns a reference to the character at specified location {{c\|pos}} if {{c\|pos < size()}}, or ~~a reference to {{c\|CharT()}}~~ if {{c\|1=pos == size()}}~~. No bounds checking is performed.~~		Returns a reference to the character at specified location {{c\|pos}} if {{c\|pos < size()}}, or if {{c\|1=pos == size()}}:

	If {{c\|~~pos > size~~()}}, the behavior is undefined.		@1@ <div style="position: relative; bottom: 1.2em; margin-top: -0.4em; margin-bottom: -1.2em;">{{rev begin}}
			{{rev\|until=c++11\|
			The behavior is undefined.
			}}
			{{rev\|since=c++11\|
			Returns a reference to {{c\|CharT()}}, if the object referred by the returned reference is modified to any value other than {{c\|CharT()}}, the behavior is undefined.
			}}
			{{rev end}}</div>

	~~For overload {{v\|1}}, if~~ {{c\|~~1=pos == size~~()}}~~, the behavior is undefined~~{{~~rev inl~~\|since=c++11\| ~~if the object referred by the returned reference is modified to any value other than~~ {{c\|~~CharT~~()}}}}.		@2@ Returns a reference to {{c\|CharT()}}.


			{{cpp/hardened ub if\|since=c++26\|{{c\|pos > size()}} is {{c\|true}}}}

	===Parameters===		===Parameters===
Line 22:		Line 32:

	===Return value===		===Return value===
	~~Reference~~ to ~~the requested element~~ if {{c\|pos < size()}}, or a reference to {{c\|CharT()}} if {{c\|1=pos == size()}}.		@1@ {{c\|*(begin() + pos)}} if {{c\|pos < size()}}{{rev inl\|since=c++11\|, or a reference to {{c\|CharT()}} if {{c\|1=pos == size()}}}}.

			@2@ {{c\|*(begin() + pos)}} if {{c\|pos < size()}}, or a reference to {{c\|CharT()}} if {{c\|1=pos == size()}}.

	===Complexity===		===Complexity===
Line 56:		Line 68:
	===Defect reports===		===Defect reports===
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=259\|std=C++98\|before=~~non-const~~ overload could return const lvalue {{c\|data()[pos]}}, which was ill-formed\|after=changed to return<br>{{c\|*(begin() + pos)}}}}		{{dr list item\|wg=lwg\|dr=259\|std=C++98\|before=overload {{v\|1}} could return const lvalue<br>{{c\|data()[pos]}}, which was ill-formed\|after=changed to return<br>{{c\|*(begin() + pos)}}}}
	{{dr list item\|wg=lwg\|dr=2475\|std=C++11\|before=if {{c\|1=pos == size()}}, the behavior of modifying the<br>object referred by the returned reference was undefined\|after=well-defined if<br>modified to {{c\|CharT()}}}}		{{dr list item\|wg=lwg\|dr=2475\|std=C++11\|before=if {{c\|1=pos == size()}}, the behavior of modifying the<br>object referred by the returned reference was undefined\|after=well-defined if<br>modified to {{c\|CharT()}}}}
	{{dr list end}}		{{dr list end}}

Ybab321: /* Return value */ simplify return value description for normal case, per other containers

2025-01-10T13:24:57Z

Return value: simplify return value description for normal case, per other containers

← Older revision		Revision as of 13:24, 10 January 2025
Line 22:		Line 22:

	===Return value===		===Return value===
	~~{{c\|*(begin() + pos)}}~~ if {{c\|pos < size()}}, or a reference to {{c\|CharT()}} if {{c\|1=pos == size()}}.		Reference to the requested element if {{c\|pos < size()}}, or a reference to {{c\|CharT()}} if {{c\|1=pos == size()}}.

	===Complexity===		===Complexity===

Space Mission: fmt.

2024-05-30T18:23:16Z

fmt.

← Older revision		Revision as of 18:23, 30 May 2024
Line 2:		Line 2:
	{{cpp/string/basic_string/navbar}}		{{cpp/string/basic_string/navbar}}
	{{dcl begin}}		{{dcl begin}}
	{{~~dcl~~\|num=1\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|		{{dcla\|anchor=no\|num=1\|constexpr=c++20\|
	CharT& operator[]( size_type pos );		CharT& operator[]( size_type pos );
	}}		}}
	{{~~dcl~~\|num=2\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|		{{dcla\|anchor=no\|num=2\|constexpr=c++20\|
	const CharT& operator[]( size_type pos ) const;		const CharT& operator[]( size_type pos ) const;
	}}		}}

Space Mission: /* Synopsis */ +constexpr since

2024-04-22T13:45:23Z

Synopsis: +constexpr since

← Older revision		Revision as of 13:45, 22 April 2024
Line 2:		Line 2:
	{{cpp/string/basic_string/navbar}}		{{cpp/string/basic_string/navbar}}
	{{dcl begin}}		{{dcl begin}}
	{{dcl ~~rev multi~~\|num=1		{{dcl\|num=1\|notes={{mark constexpr since c++20}}\|
	\|~~until1~~=c++20\|~~dcl1=~~
	CharT& operator[]( size_type pos );		CharT& operator[]( size_type pos );
	~~\|dcl2=~~
	~~constexpr CharT& operator[]( size_type pos );~~
	}}		}}
	{{dcl ~~rev multi~~\|num=2		{{dcl\|num=2\|notes={{mark constexpr since c++20}}\|
	\|~~until1~~=c++20\|~~dcl1=~~
	const CharT& operator[]( size_type pos ) const;		const CharT& operator[]( size_type pos ) const;
	~~\|dcl2=~~
	~~constexpr const CharT& operator[]( size_type pos ) const;~~
	}}		}}
	{{dcl end}}		{{dcl end}}

Fruderica: /* Defect reports */

2024-01-10T12:31:44Z

Defect reports

← Older revision		Revision as of 12:31, 10 January 2024
Line 62:		Line 62:
	===Defect reports===		===Defect reports===
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=259\|std=C++98\|before=non-const overload could return const lvalue {{c\|data()[pos]}}, which was ill-formed\|after=changed to<br>{{c\|*(begin() + pos)}}}}		{{dr list item\|wg=lwg\|dr=259\|std=C++98\|before=non-const overload could return const lvalue {{c\|data()[pos]}}, which was ill-formed\|after=changed to return<br>{{c\|*(begin() + pos)}}}}
	{{dr list item\|wg=lwg\|dr=2475\|std=C++11\|before=if {{c\|1=pos == size()}}, the behavior of modifying the<br>object referred by the returned reference was undefined\|after=well-defined if<br>modified to {{c\|CharT()}}}}		{{dr list item\|wg=lwg\|dr=2475\|std=C++11\|before=if {{c\|1=pos == size()}}, the behavior of modifying the<br>object referred by the returned reference was undefined\|after=well-defined if<br>modified to {{c\|CharT()}}}}
	{{dr list end}}		{{dr list end}}

Fruderica: /* Defect reports */ simply the wording for LWG259

2024-01-10T12:30:55Z

Defect reports: simply the wording for LWG259

← Older revision		Revision as of 12:30, 10 January 2024
Line 62:		Line 62:
	===Defect reports===		===Defect reports===
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=259\|std=C++98\|before={{c\|data()[pos]~~}} was returned if {{c\|pos < size()}}<br>(its type is {{tt\|const CharT&~~}}, which ~~conflicts with {{tt\|reference}})~~\|after=changed to<br>{{c\|*(begin() + pos)}}}}		{{dr list item\|wg=lwg\|dr=259\|std=C++98\|before=non-const overload could return const lvalue {{c\|data()[pos]}}, which was ill-formed\|after=changed to<br>{{c\|*(begin() + pos)}}}}
	{{dr list item\|wg=lwg\|dr=2475\|std=C++11\|before=if {{c\|1=pos == size()}}, the behavior of modifying the<br>object referred by the returned reference was undefined\|after=well-defined if<br>modified to {{c\|CharT()}}}}		{{dr list item\|wg=lwg\|dr=2475\|std=C++11\|before=if {{c\|1=pos == size()}}, the behavior of modifying the<br>object referred by the returned reference was undefined\|after=well-defined if<br>modified to {{c\|CharT()}}}}
	{{dr list end}}		{{dr list end}}