aboutsummaryrefslogtreecommitdiffstats
path: root/src/string
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--src/string/new.c54
1 files changed, 51 insertions, 3 deletions
diff --git a/src/string/new.c b/src/string/new.c
index 56b4e92..01111f7 100644
--- a/src/string/new.c
+++ b/src/string/new.c
@@ -146,7 +146,22 @@ char* (strnchrnul)(const char* string, int c, size_t maxlen)
return string;
}
-char* (memcchr)(const char* segment, int c, int stop, size_t size) /* slibc: completeness */
+/**
+ * Variant of `memchr` that stops searching when it
+ * another specified character.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param segment The memory segment to search.
+ * @param c The sought after character.
+ * @param stop Return `NULL` when this character is found.
+ * @param size The size of the memory segment.
+ * @return Pointer to the first occurrence of `c`,
+ * `NULL` if none were found.
+ *
+ * @since Always.
+ */
+char* (memcchr)(const char* segment, int c, int stop, size_t size)
{
char* s = segment;
for (;;)
@@ -156,7 +171,23 @@ char* (memcchr)(const char* segment, int c, int stop, size_t size) /* slibc: com
return NULL;
}
-char* (strcchr)(const char* string, int c, int stop) /* slibc: completeness */
+/**
+ * Variant of `strchr` that stops searching when it
+ * another specified character.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param string The string to search.
+ * The terminating NUL character is
+ * considered a part of the string.
+ * @param c The sought after character.
+ * @param stop Return `NULL` when this character is found.
+ * @return Pointer to the first occurrence of `c`,
+ * `NULL` if none were found.
+ *
+ * @since Always.
+ */
+char* (strcchr)(const char* string, int c, int stop)
{
for (;;)
if (*string == c)
@@ -165,7 +196,24 @@ char* (strcchr)(const char* string, int c, int stop) /* slibc: completeness */
return NULL;
}
-char* (strcnchr)(const char* string, int c, int stop, size_t maxlen) /* slibc: completeness */
+/**
+ * Variant of `strnchr` that stops searching when it
+ * another specified character.
+ *
+ * This is a slibc extension added for completeness.
+ *
+ * @param string The string to search.
+ * The terminating NUL character is
+ * considered a part of the string.
+ * @param c The sought after character.
+ * @param stop Return `NULL` when this character is found.
+ * @param maxlen The number of bytes to inspect, at most.
+ * @return Pointer to the first occurrence of `c`,
+ * `NULL` if none were found.
+ *
+ * @since Always.
+ */
+char* (strcnchr)(const char* string, int c, int stop, size_t maxlen)
{
for (;;)
if (*string == c)