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%2Fstrchr.html | 45 +++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 devdocs/c/string%2Fbyte%2Fstrchr.html (limited to 'devdocs/c/string%2Fbyte%2Fstrchr.html') diff --git a/devdocs/c/string%2Fbyte%2Fstrchr.html b/devdocs/c/string%2Fbyte%2Fstrchr.html new file mode 100644 index 00000000..39e66671 --- /dev/null +++ b/devdocs/c/string%2Fbyte%2Fstrchr.html @@ -0,0 +1,45 @@ +

strchr

Defined in header <string.h> 
char *strchr( const char *str, int ch );
+		 (1) 
/*QChar*/ *strchr( /*QChar*/ *str, int ch );
+		 (2) (since C23)
+1) Finds the first occurrence of ch (after conversion to char as if by (char)ch) in the null-terminated byte string pointed to by str (each character interpreted as unsigned char). The terminating null character is considered to be a part of the string and can be found when searching for '\0'.
+2) Type-generic function equivalent to (1). Let T be an unqualified character object type. If a macro definition of each of these generic functions is suppressed to access an actual function (e.g. if (strchr) or a function pointer is used), the actual function declaration (1) becomes visible.

The behavior is undefined if str is not a pointer to a null-terminated byte string.

+

Parameters

+ + +
str - pointer to the null-terminated byte string to be analyzed
ch - character to search for

Return value

Pointer to the found character in str, or null pointer if no such character is found.

+

Example

#include <stdio.h>
+#include <string.h>
+ 
+int main(void)
+{
+  const char *str = "Try not. Do, or do not. There is no try.";
+  char target = 'T';
+  const char *result = str;
+ 
+  while((result = strchr(result, target)) != NULL) {
+    printf("Found '%c' starting at '%s'\n", target, result);
+    ++result; // Increment result, otherwise we'll find target at the same location
+  }
+}

Output:

+
Found 'T' starting at 'Try not. Do, or do not. There is no try.'
+Found 'T' starting at 'There is no try.'

References

See also

+ + + +
searches an array for the first occurrence of a character
(function)
finds the last occurrence of a character
(function)
finds the first location of any character in one string, in another string
(function)
C++ documentation for strchr
+

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

+
-- cgit v1.2.3