cpp/string/basic string/assign - Revision history

Space Mission: /* Defect reports */ {{vl}}

2024-12-18T07:14:09Z

Defect reports: {{vl}}

← Older revision		Revision as of 07:14, 18 December 2024
Line 31:		Line 31:
	size_type pos, size_type count );		size_type pos, size_type count );
	}}		}}
	{{dcla\|since=c++14\|constexpr=c++20\|1=		{{dcla\|anchor=Version_8\|since=c++14\|constexpr=c++20\|1=
	basic_string& assign( const basic_string& str,		basic_string& assign( const basic_string& str,
	size_type pos, size_type count = npos);		size_type pos, size_type count = npos);
Line 171:		Line 171:
	{{dr list begin}}		{{dr list begin}}
	{{dr list item\|wg=lwg\|dr=847\|std=C++98\|before=there was no exception safety guarantee\|after=added strong exception safety guarantee}}		{{dr list item\|wg=lwg\|dr=847\|std=C++98\|before=there was no exception safety guarantee\|after=added strong exception safety guarantee}}
	{{dr list item\|wg=lwg\|dr=2063\|std=C++11\|before=non-normative note stated that overload {{v\|2}}<br>can be implemented by swapping\|after=corrected to require move assignment}}		{{dr list item\|wg=lwg\|dr=2063\|std=C++11\|before=non-normative note stated that overload {{vl\|2}}<br>can be implemented by swapping\|after=corrected to require move assignment}}
	{{dr list item\|wg=lwg\|dr=2250\|std=C++98\|before=the behavior of overload {{v\|8}} was<br>undefined if {{c\|pos > str.size()}} is {{c\|true}}\|after=always throws an exception in this case}}		{{dr list item\|wg=lwg\|dr=2250\|std=C++98\|before=the behavior of overload {{vl\|8}} was<br>undefined if {{c\|pos > str.size()}} is {{c\|true}}\|after=always throws an exception in this case}}
	{{dr list item\|wg=lwg\|dr=2579\|std=C++98\|before=overload {{v\|1}} and the copy assignment<br>operator had different effects\|after=they have the same effect}}		{{dr list item\|wg=lwg\|dr=2579\|std=C++98\|before=overload {{vl\|1}} and the copy assignment<br>operator had different effects\|after=they have the same effect}}
	{{dr list item\|wg=lwg\|dr=2946\|std=C++17\|before=overload {{v\|6}} caused ambiguity in some cases\|after=avoided by making it a template}}		{{dr list item\|wg=lwg\|dr=2946\|std=C++17\|before=overload {{vl\|6}} caused ambiguity in some cases\|after=avoided by making it a template}}
	{{dr list end}}		{{dr list end}}

Xmcgcg: Overhauled the description: 1. Rearranged the overloads. 2. Formalized the behaviors of overloads 6-8. 3. Added LWG2250 (part 9/16) DR and updated the wording of other DRs.

2024-12-16T02:32:34Z

Overhauled the description: 1. Rearranged the overloads. 2. Formalized the behaviors of overloads 6-8. 3. Added LWG2250 (part 9/16) DR and updated the wording of other DRs.

Show changes

Space Mission: /* Synopsis */ "notes=" ⇒ "constexpr="

2024-05-29T22:49:28Z

Synopsis: "notes=" ⇒ "constexpr="

← Older revision		Revision as of 22:49, 29 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\|
	basic_string& assign( size_type count, CharT ch );		basic_string& assign( size_type count, CharT ch );
	}}		}}
	{{~~dcl~~\|num=2\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|		{{dcla\|anchor=no\|num=2\|constexpr=c++20\|
	basic_string& assign( const basic_string& str );		basic_string& assign( const basic_string& str );
	}}		}}
Line 15:		Line 15:
	size_type pos, size_type count = npos);		size_type pos, size_type count = npos);
	}}		}}
	{{~~dcl~~\|num=4\|since=c++11\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|		{{dcla\|anchor=no\|num=4\|since=c++11\|constexpr=c++20\|
	basic_string& assign( basic_string&& str ) noexcept(/* see below */);		basic_string& assign( basic_string&& str ) noexcept(/* see below */);
	}}		}}
	{{~~dcl~~\|num=5\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|		{{dcla\|anchor=no\|num=5\|constexpr=c++20\|
	basic_string& assign( const CharT* s, size_type count );		basic_string& assign( const CharT* s, size_type count );
	}}		}}
	{{~~dcl~~\|num=6\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|		{{dcla\|anchor=no\|num=6\|constexpr=c++20\|
	basic_string& assign( const CharT* s );		basic_string& assign( const CharT* s );
	}}		}}
	{{~~dcl~~\|num=7\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|		{{dcla\|anchor=no\|num=7\|constexpr=c++20\|
	template< class InputIt >		template< class InputIt >
	basic_string& assign( InputIt first, InputIt last );		basic_string& assign( InputIt first, InputIt last );
	}}		}}
	{{~~dcl~~\|num=8\|since=c++11\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|		{{dcla\|anchor=no\|num=8\|since=c++11\|constexpr=c++20\|
	basic_string& assign( std::initializer_list<CharT> ilist );		basic_string& assign( std::initializer_list<CharT> ilist );
	}}		}}
	{{~~dcl~~\|num=9\|since=c++17\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|		{{dcla\|anchor=no\|num=9\|since=c++17\|constexpr=c++20\|
	template< class StringViewLike >		template< class StringViewLike >
	basic_string& assign( const StringViewLike& t );		basic_string& assign( const StringViewLike& t );
	}}		}}
	{{~~dcl~~\|num=10\|since=c++17\|~~notes~~=~~{{mark constexpr since~~ c++20}}\|1=		{{dcla\|anchor=no\|num=10\|since=c++17\|constexpr=c++20\|1=
	template< class StringViewLike >		template< class StringViewLike >
	basic_string& assign( const StringViewLike& t,		basic_string& assign( const StringViewLike& t,

Space Mission: /* Synopsis */ +noexcept/constexpr since...

2024-04-22T19:00:22Z

Synopsis: +noexcept/constexpr since...

← Older revision		Revision as of 19:00, 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}}\|
	\|~~dcl1~~=
	basic_string& assign( size_type count, CharT ch );		basic_string& assign( size_type count, CharT ch );
	~~\|since2=c++20\|dcl2=~~
	~~constexpr basic_string& assign( size_type count, CharT ch );~~
	}}		}}
	{{dcl ~~rev multi~~\|num=2		{{dcl\|num=2\|notes={{mark constexpr since c++20}}\|
	\|~~dcl1~~=
	basic_string& assign( const basic_string& str );		basic_string& assign( const basic_string& str );
	~~\|since2=c++20\|dcl2=~~
	~~constexpr basic_string& assign( const basic_string& str );~~
	}}		}}
	{{dcl rev multi\|num=3		{{dcl rev multi\|num=3\|dcl1=
	\|dcl1=
	basic_string& assign( const basic_string& str,		basic_string& assign( const basic_string& str,
	size_type pos, size_type count );		size_type pos, size_type count );
	\|since2=c++14\|dcl2=		\|since2=c++14\|notes2={{mark constexpr since c++20}}\|dcl2=
	basic_string& assign( const basic_string& str,		basic_string& assign( const basic_string& str,
	size_type pos, size_type count = npos);		size_type pos, size_type count = npos);
	~~\|since3=c++20\|dcl3=~~
	~~constexpr basic_string& assign( const basic_string& str,~~
	~~size_type pos, size_type count = npos);~~
	}}		}}
	{{dcl ~~rev multi~~\|num=4		{{dcl\|num=4\|since=c++11\|notes={{mark constexpr since c++20}}\|
	\|~~since1~~=c++11\|~~dcl1~~=
	basic_string& assign( basic_string&& str ) noexcept(/* see below */);		basic_string& assign( basic_string&& str ) noexcept(/* see below */);
	~~\|since2=c++20\|dcl2=~~
	~~constexpr basic_string& assign( basic_string&& str )~~
	~~noexcept(/* see below */);~~
	}}		}}
	{{dcl ~~rev multi~~\|num=5		{{dcl\|num=5\|notes={{mark constexpr since c++20}}\|
	\|~~dcl1~~=
	basic_string& assign( const CharT* s, size_type count );		basic_string& assign( const CharT* s, size_type count );
	~~\|since2=c++20\|dcl2=~~
	~~constexpr basic_string& assign( const CharT* s, size_type count );~~
	}}		}}
	{{dcl ~~rev multi~~\|num=6		{{dcl\|num=6\|notes={{mark constexpr since c++20}}\|
	\|~~dcl1~~=
	basic_string& assign( const CharT* s );		basic_string& assign( const CharT* s );
	~~\|since2=c++20\|dcl2=~~
	~~constexpr basic_string& assign( const CharT* s );~~
	}}		}}
	{{dcl ~~rev multi~~\|num=7		{{dcl\|num=7\|notes={{mark constexpr since c++20}}\|
	\|~~dcl1~~=
	template< class InputIt >		template< class InputIt >
	basic_string& assign( InputIt first, InputIt last );		basic_string& assign( InputIt first, InputIt last );
	~~\|since2=c++20\|dcl2=~~
	~~template< class InputIt >~~
	~~constexpr basic_string& assign( InputIt first, InputIt last );~~
	}}		}}
	{{dcl ~~rev multi~~\|num=8		{{dcl\|num=8\|since=c++11\|notes={{mark constexpr since c++20}}\|
	\|~~since1~~=c++11\|~~dcl1~~=
	basic_string& assign( std::initializer_list<CharT> ilist );		basic_string& assign( std::initializer_list<CharT> ilist );
	~~\|since2=c++20\|dcl2=~~
	~~constexpr basic_string& assign( std::initializer_list<CharT> ilist );~~
	}}		}}
	{{dcl ~~rev multi~~\|num=9		{{dcl\|num=9\|since=c++17\|notes={{mark constexpr since c++20}}\|
	\|~~since1~~=c++17\|~~dcl1~~=
	template< class StringViewLike >		template< class StringViewLike >
	basic_string& assign( const StringViewLike& t );		basic_string& assign( const StringViewLike& t );
	~~\|since2=c++20\|dcl2=~~
	~~template< class StringViewLike >~~
	~~constexpr basic_string& assign( const StringViewLike& t );~~
	}}		}}
	{{dcl ~~rev multi~~\|num=10		{{dcl\|num=10\|since=c++17\|notes={{mark constexpr since c++20}}\|1=
	\|~~since1~~=c++17\|~~dcl1~~=
	template< class StringViewLike >		template< class StringViewLike >
	basic_string& assign( const StringViewLike& t,		basic_string& assign( const StringViewLike& t,
	size_type pos, size_type count = npos);		size_type pos, size_type count = npos);
	~~\|since2=c++20\|dcl2=~~
	~~template< class StringViewLike >~~
	~~constexpr basic_string& assign( const StringViewLike& t,~~
	~~size_type pos, size_type count = npos);~~
	}}		}}
	{{dcl end}}		{{dcl end}}
Line 119:		Line 83:
	===Complexity===		===Complexity===
	@1@ Linear in {{c\|count}}.		@1@ Linear in {{c\|count}}.

	@2@ Linear in size of {{c\|str}}.		@2@ Linear in size of {{c\|str}}.

	@3@ Linear in {{c\|count}}.		@3@ Linear in {{c\|count}}.

	@4@ Constant. If {{c\|alloc}} is given and {{c\|1=alloc != other.get_allocator()}}, then linear.		@4@ Constant. If {{c\|alloc}} is given and {{c\|1=alloc != other.get_allocator()}}, then linear.

	@5@ Linear in {{c\|count}}.		@5@ Linear in {{c\|count}}.

	@6@ Linear in size of {{c\|s}}.		@6@ Linear in size of {{c\|s}}.

	@7@ Linear in distance between {{c\|first}} and {{c\|last}}.		@7@ Linear in distance between {{c\|first}} and {{c\|last}}.

	@8@ Linear in size of {{c\|ilist}}.		@8@ Linear in size of {{c\|ilist}}.

	@9@ Linear in size of {{c\|t}}.		@9@ Linear in size of {{c\|t}}.

Xmcgcg: Removed the second revision of overload (4), the noexcept condition was added by LWG 2063.

2023-08-17T09:57:14Z

Removed the second revision of overload (4), the noexcept condition was added by LWG 2063.

← Older revision		Revision as of 09:57, 17 August 2023
Line 27:		Line 27:
	{{dcl rev multi\|num=4		{{dcl rev multi\|num=4
	\|since1=c++11\|dcl1=		\|since1=c++11\|dcl1=
	~~basic_string& assign( basic_string&& str );~~
	~~\|since2=c++17\|dcl2=~~
	basic_string& assign( basic_string&& str ) noexcept(/* see below */);		basic_string& assign( basic_string&& str ) noexcept(/* see below */);
	\|~~since3~~=c++20\|~~dcl3~~=		\|since2=c++20\|dcl2=
	constexpr basic_string& assign( basic_string&& str )		constexpr basic_string& assign( basic_string&& str )
	noexcept(/* see below */);		noexcept(/* see below */);
Line 139:		Line 137:

	===Exceptions===		===Exceptions===
	~~{{rrev\|since=c++17\|~~
	@4@ {{noexcept\|std::allocator_traits<Allocator>::		@4@ {{noexcept\|std::allocator_traits<Allocator>::
	propagate_on_container_move_assignment::value {{!!}}		propagate_on_container_move_assignment::value {{!!}}
	std::allocator_traits<Allocator>::is_always_equal::value}}		std::allocator_traits<Allocator>::is_always_equal::value}}
	}}

	{{cpp/string/basic_string/length error note}}		{{cpp/string/basic_string/length error note}}

Space Mission: /* Exceptions */

2023-07-26T19:42:03Z

Exceptions

← Older revision		Revision as of 19:42, 26 July 2023
Line 139:		Line 139:

	===Exceptions===		===Exceptions===
	~~If the operation would result in {{lc\|size()}} {{tt\|>}} {{lc\|max_size()}}, throws {{lc\|std::length_error}}.~~

	{{rrev\|since=c++17\|		{{rrev\|since=c++17\|
	@4@ {{noexcept\|std::allocator_traits<Allocator>::		@4@ {{noexcept\|std::allocator_traits<Allocator>::
Line 146:		Line 144:
	std::allocator_traits<Allocator>::is_always_equal::value}}		std::allocator_traits<Allocator>::is_always_equal::value}}
	}}		}}

			{{cpp/string/basic_string/length error note}}

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

Space Mission: /* Complexity */ +@9@

2023-07-26T18:47:40Z

Complexity: +@9@

← Older revision		Revision as of 18:47, 26 July 2023
Line 135:		Line 135:

	@8@ Linear in size of {{c\|ilist}}.		@8@ Linear in size of {{c\|ilist}}.

			@9@ Linear in size of {{c\|t}}.

	===Exceptions===		===Exceptions===

Space Mission: /* See also */ ++

2023-06-11T15:31:07Z

Andreas Krug: fmt, capitalized 1st letter, .

2023-05-31T08:01:47Z

fmt, capitalized 1st letter, .

← Older revision		Revision as of 08:01, 31 May 2023
Line 62:		Line 62:
	{{dcl rev multi\|num=9		{{dcl rev multi\|num=9
	\|since1=c++17\|dcl1=		\|since1=c++17\|dcl1=
	template < class StringViewLike >		template< class StringViewLike >
	basic_string& assign( const StringViewLike& t );		basic_string& assign( const StringViewLike& t );
	\|since2=c++20\|dcl2=		\|since2=c++20\|dcl2=
	template < class StringViewLike >		template< class StringViewLike >
	constexpr basic_string& assign( const StringViewLike& t );		constexpr basic_string& assign( const StringViewLike& t );
	}}		}}
	{{dcl rev multi\|num=10		{{dcl rev multi\|num=10
	\|since1=c++17\|dcl1=		\|since1=c++17\|dcl1=
	template < class StringViewLike >		template< class StringViewLike >
	basic_string& assign( const StringViewLike& t,		basic_string& assign( const StringViewLike& t,
	size_type pos, size_type count = npos);		size_type pos, size_type count = npos);
	\|since2=c++20\|dcl2=		\|since2=c++20\|dcl2=
	template < class StringViewLike >		template< class StringViewLike >
	constexpr basic_string& assign( const StringViewLike& t,		constexpr basic_string& assign( const StringViewLike& t,
	size_type pos, size_type count = npos);		size_type pos, size_type count = npos);
Line 120:		Line 120:

	===Complexity===		===Complexity===
	@1@ ~~linear~~ in {{c\|count}}		@1@ Linear in {{c\|count}}.

	@2@ ~~linear~~ in size of {{c\|str}}		@2@ Linear in size of {{c\|str}}.

	@3@ ~~linear~~ in {{c\|count}}		@3@ Linear in {{c\|count}}.

	@4@ ~~constant~~. If {{c\|alloc}} is given and {{c\|1=alloc != other.get_allocator()}}, then linear.		@4@ Constant. If {{c\|alloc}} is given and {{c\|1=alloc != other.get_allocator()}}, then linear.

	@5@ ~~linear~~ in {{c\|count}}		@5@ Linear in {{c\|count}}.

	@6@ ~~linear~~ in size of {{c\|s}}		@6@ Linear in size of {{c\|s}}.

	@7@ ~~linear~~ in distance between {{c\|first}} and {{c\|last}}		@7@ Linear in distance between {{c\|first}} and {{c\|last}}.

	@8@ ~~linear~~ in size of {{c\|ilist}}		@8@ Linear in size of {{c\|ilist}}.

	===Exceptions===		===Exceptions===
Line 164:		Line 164:
	// assign(const basic_string& str)		// assign(const basic_string& str)
	s.assign(c);		s.assign(c);
	std::cout << c << " == " << s <<'\n'; // "Exemplary == Exemplary"		std::cout << c << " == " << s << '\n'; // "Exemplary == Exemplary"

	// assign(const basic_string& str, size_type pos, size_type count)		// assign(const basic_string& str, size_type pos, size_type count)

Xmcgcg: Minor tweak.

2023-05-30T03:29:49Z

Minor tweak.

← Older revision		Revision as of 03:29, 30 May 2023
Line 166:		Line 166:
	std::cout << c << " == " << s <<'\n'; // "Exemplary == Exemplary"		std::cout << c << " == " << s <<'\n'; // "Exemplary == Exemplary"

	// assign(basic_string ~~const~~& str, size_type pos, size_type count)		// assign(const basic_string& str, size_type pos, size_type count)
	s.assign(c, 0, c.length() - 1);		s.assign(c, 0, c.length() - 1);
	std::cout << s << '\n'; // "Exemplar";		std::cout << s << '\n'; // "Exemplar";

← Older revision		Revision as of 15:31, 11 June 2023
Line 212:		Line 212:
	===See also===		===See also===
	{{dsc begin}}		{{dsc begin}}
			{{dsc inc\|cpp/string/basic_string/dsc assign_range}}
	{{dsc inc\|cpp/string/basic_string/dsc constructor}}		{{dsc inc\|cpp/string/basic_string/dsc constructor}}
	{{dsc inc\|cpp/string/basic_string/dsc operator{{=}}}}		{{dsc inc\|cpp/string/basic_string/dsc operator{{=}}}}