Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/string/wide/wcspbrk"

From cppreference.com
< cpp‎ | string‎ | wide
m (Text replace - "/sidebar" to "/navbar")
m (str -> src, {{c}}, headers sorted, fmt, langlinks)
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
{{cpp/title| wcspbrk}}
+
{{cpp/title|wcspbrk}}
 
{{cpp/string/wide/navbar}}
 
{{cpp/string/wide/navbar}}
−
{{ddcl list begin}}
+
{{dcl begin}}
−
{{ddcl list header | cwchar}}
+
{{dcl header|cwchar}}
−
{{ddcl list item |
+
{{dcl|
−
const wchar_t* wcspbrk( const wchar_t* dest, const wchar_t* str );
+
const wchar_t* wcspbrk( const wchar_t* dest, const wchar_t* src );
 
}}
 
}}
−
{{ddcl list item |
+
{{dcl|
−
     wchar_t* wcspbrk(      wchar_t* dest, const wchar_t* str );
+
     wchar_t* wcspbrk(      wchar_t* dest, const wchar_t* src );
 
}}
 
}}
−
{{ddcl list end}}
+
{{dcl end}}
  
−
Finds the first character in wide string pointed to by {{tt|dest}}, that is also in wide string pointed to by {{tt|str}}.
+
Finds the first character in wide string pointed to by {{c|dest}}, that is also in wide string pointed to by {{c|src}}.
  
 
===Parameters===
 
===Parameters===
−
{{param list begin}}
+
{{par begin}}
−
{{param list item | dest | pointer to the null-terminated wide string to be analyzed}}
+
{{par|dest|pointer to the null-terminated wide string to be analyzed}}
−
{{param list item | src | pointer to the null-terminated wide string that contains the characters to search for}}
+
{{par|src|pointer to the null-terminated wide string that contains the characters to search for}}
−
{{param list end}}
+
{{par end}}
  
 
===Return value===
 
===Return value===
−
Pointer to the first character in {{tt|dest}}, that is also in {{tt|str}}, or {{c|NULL}} if no such character exists.
+
Pointer to the first character in {{c|dest}}, that is also in {{c|src}}, or a null pointer if no such character exists.
 +
 
 +
===Notes===
 +
The name stands for "wide character string pointer break", because it returns a pointer to the first of the separator ("break") characters.
  
 
===Example===
 
===Example===
 
{{example
 
{{example
−
|
+
|code=
−
  | code=
+
#include <cwchar>
−
  | output=
+
#include <iomanip>
 +
#include <iostream>
 +
   
 +
int main()
 +
{
 +
    const wchar_t* str = L"Hello world, friend of mine!";
 +
    const wchar_t* sep = L" ,!";
 +
   
 +
    unsigned int cnt = 0;
 +
    do
 +
    {
 +
        str = std::wcspbrk(str, sep); // find separator
 +
        std::wcout << std::quoted(str) << L'\n';
 +
        if (str)
 +
            str += std::wcsspn(str, sep); // skip separator
 +
        ++cnt; // increment word count
 +
    } while (str && *str);
 +
 +
    std::wcout << L"There are " << cnt << L" words\n";
 +
}
 +
|output=
 +
" world, friend of mine!"
 +
", friend of mine!"
 +
" of mine!"
 +
" mine!"
 +
"!"
 +
There are 5 words
 
}}
 
}}
  
 
===See also===
 
===See also===
−
{{dcl list begin}}
+
{{dsc begin}}
−
{{dcl list template | cpp/string/wide/dcl list wcscspn}}
+
{{dsc inc|cpp/string/wide/dsc wcscspn}}
−
{{dcl list template | cpp/string/wide/dcl list wcschr}}
+
{{dsc inc|cpp/string/wide/dsc wcschr}}
−
{{dcl list see c | c/string/wide/wcspbrk}}
+
{{dsc inc|cpp/string/byte/dsc strpbrk}}
−
{{dcl list end}}
+
{{dsc see c|c/string/wide/wcspbrk}}
 +
{{dsc end}}
 +
 
 +
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}

Latest revision as of 10:01, 10 June 2023

 
C++
 
Strings library
 
Null-terminated wide strings
 
Defined in header <cwchar>
const wchar_t* wcspbrk( const wchar_t* dest, const wchar_t* src );
      wchar_t* wcspbrk(       wchar_t* dest, const wchar_t* src );

Finds the first character in wide string pointed to by dest, that is also in wide string pointed to by src.

Contents

[edit] Parameters

dest - pointer to the null-terminated wide string to be analyzed
src - pointer to the null-terminated wide string that contains the characters to search for

[edit] Return value

Pointer to the first character in dest, that is also in src, or a null pointer if no such character exists.

[edit] Notes

The name stands for "wide character string pointer break", because it returns a pointer to the first of the separator ("break") characters.

[edit] Example

Run this code
#include <cwchar>
#include <iomanip>
#include <iostream>
 
int main()
{
    const wchar_t* str = L"Hello world, friend of mine!";
    const wchar_t* sep = L" ,!";
 
    unsigned int cnt = 0;
    do
    {
        str = std::wcspbrk(str, sep); // find separator
        std::wcout << std::quoted(str) << L'\n';
        if (str)
            str += std::wcsspn(str, sep); // skip separator
        ++cnt; // increment word count
    } while (str && *str);
 
    std::wcout << L"There are " << cnt << L" words\n";
}

Output: 

" world, friend of mine!"
", friend of mine!"
" of mine!"
" mine!"
"!"
There are 5 words

[edit] See also

 returns the length of the maximum initial segment that consists
of only the wide not found in another wide string
(function) [edit]
finds the first occurrence of a wide character in a wide string
(function) [edit]
finds the first location of any character from a set of separators
(function) [edit]
C documentation for wcspbrk
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/string/wide/wcspbrk&oldid=153115"