From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/string%2Fbyte%2Fstrcspn.html | 39 ++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 devdocs/c/string%2Fbyte%2Fstrcspn.html (limited to 'devdocs/c/string%2Fbyte%2Fstrcspn.html') diff --git a/devdocs/c/string%2Fbyte%2Fstrcspn.html b/devdocs/c/string%2Fbyte%2Fstrcspn.html new file mode 100644 index 00000000..43666174 --- /dev/null +++ b/devdocs/c/string%2Fbyte%2Fstrcspn.html @@ -0,0 +1,39 @@ +

strcspn

Defined in header <string.h> 
size_t strcspn( const char *dest, const char *src );
+

Returns the length of the maximum initial segment of the null-terminated byte string pointed to by dest, that consists of only the characters not found in the null-terminated byte string pointed to by src.

+

The behavior is undefined if either dest or src is not a pointer to a null-terminated byte string.

+

Parameters

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

Return value

The length of the maximum initial segment that contains only characters not found in the null-terminated byte string pointed to by src

+

Notes

The function name stands for "complementary span" because the function searches for characters not found in src, that is the complement of src.

+

Example

#include <string.h>
+#include <stdio.h>
+ 
+int main(void)
+{
+    const char *string = "abcde312$#@";
+    const char *invalid = "*$#";
+ 
+    size_t valid_len = strcspn(string, invalid);
+    if(valid_len != strlen(string))
+       printf("'%s' contains invalid chars starting at position %zu\n",
+               string, valid_len);
+}

Output:

+
'abcde312$#@' contains invalid chars starting at position 8

References

See also

+ + + +
returns the length of the maximum initial segment that consists
of only the characters found in another byte string
(function)
+
(C95)
 returns the length of the maximum initial segment that consists
of only the wide chars not found in another wide string
(function)
finds the first location of any character in one string, in another string
(function)
C++ documentation for strcspn
+

+ © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
+ https://en.cppreference.com/w/c/string/byte/strcspn +

+
-- cgit v1.2.3