wcspbrk() function in C++

In this article, we will discuss about wcspbrk() function in C++ with its syntax, parameters, and examples.

What is the wcspbrk() function in C++?

The wcspbrk() built-in C/C++ function is a library function. It finds the set of wide characters in another wide string by searching on the other string. This function is accessible in the <cwchar> file.

This function takes two parameters. The first parameter is the destination, and the second parameter is the result. As the destinations, we look at the null-terminated wide strings. We use a wide string with a null terminator character to store the characters. It returns two values.

Syntax:

It has the following syntax:

Parameters:

Functions has two parameters, and below is the shown template.

• dests: The function defines the wide string pointed by the pointer to be searched with the null terminator.
• srcs: It designates a pointer to a compound terminated with a wide symbol made up of all the characters to find.

Return Value:

It contains two values. They are as follows:

• If one or more than one common characters exist in output and input, the function returns the pointer to the first wide character in dest that is also in srcs.
• Only a null pointer is allocated if there are no wide characters that are located in src and dests.

Example 1:

Let us take an example to illustrate the wcspbrk() function in C++.

Output:

 
The First occurrence in the string: "Programming" is found at the position 2   

Explanation:

• Two wide character arrays are declared: srcStr[] and destStr[]. These are the source and target strings. The L prefix in front of the string literals shows that they are wide-character strings.
• The variable st is a pointer to a wide character data type (wchar_t*). It will be saved as the position of the first character from srcStr in destStr.
• The wcspbrk() function takes destStr and srcStr as its arguments. This function performs searching of the first location of any character from srcStr in destStr and returns the address to this character.
• If there is no character in the intersection, the pointer should be returned as null. If the wcspbrk() determines that the hsearch in srcStr is complete and if it is found inside the destStr, the type of return is the NULL or non-null. It returns the index as the output.
• The output is shown through wcout, which is the wide-character equivalent of cout. It begins the description of the character with its name and position.
• The null pointer return value of wcspbrk() gives rise to a conclusion that no characters from srcStr are in destStr. The program generates a message notifying that the person does not show up in this case.

Example 2:

Let us take an example to illustrate the wcspbrk() function in C++.

Output:

 
There is no common wide character   

Explanation:

• This code gives an example of the wcspbrk() function in C++. It finds the first match of one of the characters by checking it against srcStr inside destStr. The string will be searched for a character corresponding to the destStr string. After a match is found, its associated character position will be calculated and displayed. In case of no match takes place, the message gets displayed on the screen.
• The program will use not only the function <cwchar> for a universal character representation of strings but also the library <iostream> for input/output. This operation's result is returned by invoking wcspbrk(character, pointers); the position is then calculated via pointer operations.

Conclusion:

In conclusion, the C++ wcspbrk() function acts with the two-dimensional array of characters; hence, the character array entered is also returned by the function. It generates a wide-character type that returns an index of the first match of a character set within the string of wide characters. It functions by the same principle as the C language strpbrk() function but is more flexible because it works with code points. The function takes two parameters. The destination location should have a wide string argument where the needed search will occur, and the source area should be a widened string with characters to search.

The function returns a one-sequence pointer of the first coming from the top to the bottom. If there is not a corresponding character, it points to a null row.

To undertake the use of the function wcspbrk(), declare the header <cwchar> to act as the wcout stream, which will output wide characters. It relies on wide characters to find out particular characters of storage in the C++ code.