cpp/string/basic string/contains - Revision history

Andreas Krug: {{c}}, capitalized 1st letter, fmt

2023-06-01T08:24:09Z

{{c}}, capitalized 1st letter, fmt

← Older revision		Revision as of 08:24, 1 June 2023
Line 18:		Line 18:
	Checks if the string contains the given substring. The substring may be one of the following:		Checks if the string contains the given substring. The substring may be one of the following:

	@1@ a string view {{tt\|sv}} (which may be a result of implicit conversion from another {{tt\|std::basic_string}}).		@1@ A string view {{c\|sv}} (which may be a result of implicit conversion from another {{tt\|std::basic_string}}).
	@2@ a single character {{tt\|ch}}.		@2@ A single character {{c\|ch}}.
	@3@ a null-terminated character string {{tt\|s}}.		@3@ A null-terminated character string {{c\|s}}.

	All three overloads are equivalent to {{c\|1=return find(x) != npos;}}, where {{tt\|x}} is the parameter.		All three overloads are equivalent to {{c\|1=return find(x) != npos;}}, where {{tt\|x}} is the parameter.
Line 46:		Line 46:
	#include <type_traits>		#include <type_traits>

	template <typename SubstrType>		template<typename SubstrType>
	void test_substring(const std::string& str, SubstrType subs)		void test_substring(const std::string& str, SubstrType subs)
	{		{

Space Mission: /* Notes */ plural (due to overloads)

2022-11-14T18:25:41Z

Notes: plural (due to overloads)

← Older revision		Revision as of 18:25, 14 November 2022
Line 35:		Line 35:

	===Notes===		===Notes===
	{{feature test macro\|__cpp_lib_string_contains\|{{tt\|contains}} ~~function~~\|std=C++23\|value=202011L}}		{{feature test macro\|__cpp_lib_string_contains\|{{tt\|contains}} functions\|std=C++23\|value=202011L}}

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

Space Mission: fmt

2022-11-14T17:56:03Z

fmt

← Older revision		Revision as of 17:56, 14 November 2022
Line 1:		Line 1:
	{{cpp/string/basic_string/title \| contains}}		{{cpp/string/basic_string/title\|contains}}
	{{cpp/string/basic_string/navbar}}		{{cpp/string/basic_string/navbar}}
	{{dcl begin}}		{{dcl begin}}
	{{dcl \| num=1 \|since=c++23\|1=		{{dcl\|num=1\|since=c++23\|1=
	constexpr bool contains( std::basic_string_view<CharT,Traits> sv )		constexpr bool
	const noexcept;		contains( std::basic_string_view<CharT,Traits> sv ) const noexcept;
	}}		}}
	{{dcl \| num=2 \|since=c++23\|1=		{{dcl\|num=2\|since=c++23\|1=
	constexpr bool contains( CharT c ) const noexcept;		constexpr bool
			contains( CharT ch ) const noexcept;
	}}		}}
	{{dcl \| num=3 \|since=c++23\|1=		{{dcl\|num=3\|since=c++23\|1=
	constexpr bool contains( const CharT* s ) const;		constexpr bool
			contains( const CharT* s ) const;
	}}		}}
	{{dcl end}}		{{dcl end}}
Line 17:		Line 19:

	@1@ a string view {{tt\|sv}} (which may be a result of implicit conversion from another {{tt\|std::basic_string}}).		@1@ a string view {{tt\|sv}} (which may be a result of implicit conversion from another {{tt\|std::basic_string}}).
	@2@ a single character {{tt\|c}}.		@2@ a single character {{tt\|ch}}.
	@3@ a null-terminated character string {{tt\|s}}.		@3@ a null-terminated character string {{tt\|s}}.

Line 24:		Line 26:
	===Parameters===		===Parameters===
	{{par begin}}		{{par begin}}
	{{par \| sv \| a string view which may be a result of implicit conversion from another {{tt\|std::basic_string}}}}		{{par\|sv\|a string view which may be a result of implicit conversion from another {{tt\|std::basic_string}}}}
	{{par \| c \| a single character}}		{{par\|ch\|a single character}}
	{{par \| s \| a null-terminated character string}}		{{par\|s\|a null-terminated character string}}
	{{par end}}		{{par end}}

Line 37:		Line 39:
	===Example===		===Example===
	{{example		{{example
	\| code=		\|code=
	#include <iomanip>		#include <iomanip>
	#include <iostream>		#include <iostream>
Line 65:		Line 67:
	test_substring(helloWorld, 'x');		test_substring(helloWorld, 'x');
	}		}
	\| output=		\|output=
	"hello world" contains "hello"		"hello world" contains "hello"
	"hello world" does not contain "goodbye"		"hello world" does not contain "goodbye"
Line 74:		Line 76:
	===See also===		===See also===
	{{dsc begin}}		{{dsc begin}}
	{{dsc inc \| cpp/string/basic_string/dsc starts_with}}		{{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 ends_with}}
	{{dsc inc \| cpp/string/basic_string/dsc find}}		{{dsc inc\|cpp/string/basic_string/dsc find}}
	{{dsc inc \| cpp/string/basic_string/dsc substr}}		{{dsc inc\|cpp/string/basic_string/dsc substr}}
	{{dsc inc \| cpp/string/basic_string_view/dsc {{SUBPAGENAMEE}}}}		{{dsc inc\|cpp/string/basic_string_view/dsc {{SUBPAGENAMEE}}}}
	{{dsc end}}		{{dsc end}}

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

Space Mission: /* Notes */ ~FTM

2022-11-14T17:53:30Z

Notes: ~FTM

← Older revision		Revision as of 17:53, 14 November 2022
Line 33:		Line 33:

	===Notes===		===Notes===
	{{feature test macro\|__cpp_lib_string_contains\|std=C++23\|value=202011L}}		{{feature test macro\|__cpp_lib_string_contains\|{{tt\|contains}} function\|std=C++23\|value=202011L}}

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

Space Mission: /* Notes */ ftm

2022-09-09T13:57:37Z

Notes: ftm

← Older revision		Revision as of 13:57, 9 September 2022
Line 33:		Line 33:

	===Notes===		===Notes===
	{{feature test macro\|__cpp_lib_string_contains}}		{{feature test macro\|__cpp_lib_string_contains\|std=C++23\|value=202011L}}

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

Space Mission: /* Example */ upd

2022-07-28T23:19:43Z

Example: upd

← Older revision		Revision as of 23:19, 28 July 2022
Line 38:		Line 38:
	{{example		{{example
	\| code=		\| code=
			#include <iomanip>
	#include <iostream>		#include <iostream>
			#include <string>
	#include <string_view>		#include <string_view>
	#include <~~string~~>		#include <type_traits>

	template <typename SubstrType>		template <typename SubstrType>
	void ~~test_substring_print~~(const std::string& str, SubstrType subs)		void test_substring(const std::string& str, SubstrType subs)
	{		{
	std::~~cout <~~< '\'' << str << "' contains '" ~~<< subs <<~~ "': " <<		constexpr char delim = std::is_scalar_v<SubstrType> ? '\'' : '\"';
	~~str.contains~~(subs) << '\n';		std::cout << std::quoted(str)
			<< (str.contains(subs) ? " contains "
			: " does not contain ")
			<< std::quoted(std::string{subs}, delim) << '\n';
	}		}

	int main()		int main()
	{		{
	std::~~boolalpha(std::cout);~~		using namespace std::literals;
	~~auto helloWorld = std::string("hello world");~~

	~~test_substring_print(helloWorld, std::string_view("hello"));~~

	~~test_substring_print(helloWorld, std::string_view("goodbye"))~~;

	~~test_substring_print(~~helloWorld~~, 'w')~~;		auto helloWorld = "hello world"s;

	~~test_substring_print~~(helloWorld, 'x');		test_substring(helloWorld, "hello"sv);
			test_substring(helloWorld, "goodbye"sv);
			test_substring(helloWorld, 'w');
			test_substring(helloWorld, 'x');
	}		}
	\| output=		\| output=
	'hello world' contains 'hello~~': true~~		"hello world" contains "hello"
	'hello world~~' contains '~~goodbye~~': false~~		"hello world" does not contain "goodbye"
	'hello world' contains 'w'~~: true~~		"hello world" contains 'w'
	'hello world~~' contains~~ 'x'~~: false~~		"hello world" does not contain 'x'
	}}		}}

Space Mission: /* See also */ + basic_string_view::contains counterpart

2022-01-28T17:44:08Z

See also: + basic_string_view::contains counterpart

← Older revision		Revision as of 17:44, 28 January 2022
Line 75:		Line 75:
	{{dsc inc \| cpp/string/basic_string/dsc find}}		{{dsc inc \| cpp/string/basic_string/dsc find}}
	{{dsc inc \| cpp/string/basic_string/dsc substr}}		{{dsc inc \| cpp/string/basic_string/dsc substr}}
			{{dsc inc \| cpp/string/basic_string_view/dsc {{SUBPAGENAMEE}}}}
	{{dsc end}}		{{dsc end}}

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

Space Mission: /* Notes */ + {{feature test macro}}

2022-01-28T17:40:51Z

Notes: + {{feature test macro}}

← Older revision		Revision as of 17:40, 28 January 2022
Line 31:		Line 31:
	===Return value===		===Return value===
	{{c\|true}} if the string contains the provided substring, {{c\|false}} otherwise.		{{c\|true}} if the string contains the provided substring, {{c\|false}} otherwise.

			===Notes===
			{{feature test macro\|__cpp_lib_string_contains}}

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

T. Canens: Reverted edits by 93.100.163.120 (talk) to last revision by Fruderica

2021-10-20T00:53:41Z

Reverted edits by 93.100.163.120 (talk) to last revision by Fruderica

← Older revision		Revision as of 00:53, 20 October 2021
Line 43:		Line 43:
	{		{
	std::cout << '\'' << str << "' contains '" << subs << "': " <<		std::cout << '\'' << str << "' contains '" << subs << "': " <<
	str.contains(subs) << ~~std::endl~~;		str.contains(subs) << '\n';
	}		}

93.100.163.120 at 16:51, 19 October 2021

2021-10-19T16:51:25Z

← Older revision		Revision as of 16:51, 19 October 2021
Line 43:		Line 43:
	{		{
	std::cout << '\'' << str << "' contains '" << subs << "': " <<		std::cout << '\'' << str << "' contains '" << subs << "': " <<
	str.contains(subs) << ~~'\n'~~;		str.contains(subs) << std::endl;
	}		}

← Older revision		Revision as of 17:44, 28 January 2022
Line 75:		Line 75:
	{{dsc inc \| cpp/string/basic_string/dsc find}}		{{dsc inc \| cpp/string/basic_string/dsc find}}
	{{dsc inc \| cpp/string/basic_string/dsc substr}}		{{dsc inc \| cpp/string/basic_string/dsc substr}}
			{{dsc inc \| cpp/string/basic_string_view/dsc {{SUBPAGENAMEE}}}}
	{{dsc end}}		{{dsc end}}

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