doc: (cstr) strupcase, strdowncase, strcount
This commit is contained in:
parent
5585cc2d87
commit
a8641e4c33
36
lib/cstr.c
36
lib/cstr.c
|
@ -12,7 +12,9 @@
|
||||||
*
|
*
|
||||||
* @return a pointer to the beginning of the trimmed string. the string is not
|
* @return a pointer to the beginning of the trimmed string. the string is not
|
||||||
* copied, and the returned pointer points to somewhere within the
|
* copied, and the returned pointer points to somewhere within the
|
||||||
* original string.
|
* original string. returns null on error.
|
||||||
|
*
|
||||||
|
* @errno EINVAL: `str` is a null pointer
|
||||||
*/
|
*/
|
||||||
char *
|
char *
|
||||||
strtrim (char *str)
|
strtrim (char *str)
|
||||||
|
@ -31,7 +33,9 @@ strtrim (char *str)
|
||||||
*
|
*
|
||||||
* @return a pointer to the beginning of the trimmed string. the string is not
|
* @return a pointer to the beginning of the trimmed string. the string is not
|
||||||
* copied, and the returned pointer points to somewhere within the
|
* copied, and the returned pointer points to somewhere within the
|
||||||
* original string.
|
* original string. returns null on error.
|
||||||
|
*
|
||||||
|
* @errno EINVAL: `str` is a null pointer
|
||||||
*/
|
*/
|
||||||
char *
|
char *
|
||||||
strtriml (char *str)
|
strtriml (char *str)
|
||||||
|
@ -51,7 +55,9 @@ strtriml (char *str)
|
||||||
*
|
*
|
||||||
* @param str: the string to trim
|
* @param str: the string to trim
|
||||||
*
|
*
|
||||||
* @return the new string length
|
* @return the new string length, or -1 on error.
|
||||||
|
*
|
||||||
|
* @errno EINVAL: `str` is a null pointer
|
||||||
*/
|
*/
|
||||||
ssize_t
|
ssize_t
|
||||||
strtrimr (char *str)
|
strtrimr (char *str)
|
||||||
|
@ -68,6 +74,16 @@ strtrimr (char *str)
|
||||||
return i;
|
return i;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* count number of occurances of a character within a string.
|
||||||
|
*
|
||||||
|
* @param str: the string to search in
|
||||||
|
* @param c: the character to search for
|
||||||
|
*
|
||||||
|
* @return the amount of occurances, or -1 on error.
|
||||||
|
*
|
||||||
|
* @errno EINVAL: `str` is a null pointer
|
||||||
|
*/
|
||||||
ssize_t
|
ssize_t
|
||||||
strcount (const char *str, char c)
|
strcount (const char *str, char c)
|
||||||
{
|
{
|
||||||
|
@ -83,6 +99,13 @@ strcount (const char *str, char c)
|
||||||
return count;
|
return count;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* transform all uppercase letters of a string into lowercase letters.
|
||||||
|
*
|
||||||
|
* @param str: the string to convert
|
||||||
|
*
|
||||||
|
* @errno EINVAL: `str` is a null pointer
|
||||||
|
*/
|
||||||
void
|
void
|
||||||
strdowncase (char *str)
|
strdowncase (char *str)
|
||||||
{
|
{
|
||||||
|
@ -97,6 +120,13 @@ strdowncase (char *str)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* transform all lowercase letters of a string into uppercase letters.
|
||||||
|
*
|
||||||
|
* @param str: the string to convert
|
||||||
|
*
|
||||||
|
* @errno EINVAL: `str` is a null pointer
|
||||||
|
*/
|
||||||
void
|
void
|
||||||
strupcase (char *str)
|
strupcase (char *str)
|
||||||
{
|
{
|
||||||
|
|
|
@ -5,10 +5,10 @@
|
||||||
#include <sys/types.h>
|
#include <sys/types.h>
|
||||||
|
|
||||||
char *strtrim (char *str); /* trim whitespace of a cstring (both beginning and end) */
|
char *strtrim (char *str); /* trim whitespace of a cstring (both beginning and end) */
|
||||||
char *strtriml (char *str); /* trim whitespace of a cstring on the left (beginning of string). */
|
char *strtriml (char *str); /* trim whitespace of a cstring on the left (beginning of string) */
|
||||||
ssize_t strtrimr (char *str); /* trim whitespace of a cstring on the right (end of string) */
|
ssize_t strtrimr (char *str); /* trim whitespace of a cstring on the right (end of string) */
|
||||||
ssize_t strcount (const char *str, char c);
|
ssize_t strcount (const char *str, char c); /* count number of occurances of a character within a string */
|
||||||
void strdowncase (char *str);
|
void strdowncase (char *str); /* transform all uppercase letters of a string into lowercase letters */
|
||||||
void strupcase (char *str);
|
void strupcase (char *str); /* transform all lowercase letters of a string into uppercase letters */
|
||||||
|
|
||||||
#endif // CUTILS_CSTR_H_
|
#endif // CUTILS_CSTR_H_
|
||||||
|
|
Loading…
Reference in New Issue