135 lines
2.8 KiB
C
135 lines
2.8 KiB
C
#include "cstr.h"
|
|
#include <ctype.h>
|
|
#include <errno.h>
|
|
#include <string.h>
|
|
|
|
/**
|
|
* trim whitespace of a cstring (both beginning and end). a null terminator
|
|
* will be placed after the last non-whitespace character. this modifies the
|
|
* string.
|
|
*
|
|
* @param str: the string to trim
|
|
*
|
|
* @return a pointer to the beginning of the trimmed string. the string is not
|
|
* copied, and the returned pointer points to somewhere within the
|
|
* original string.
|
|
*/
|
|
char *
|
|
strtrim (char str[static 1])
|
|
{
|
|
strtrimr (str);
|
|
return strtriml (str);
|
|
}
|
|
|
|
/**
|
|
* trim whitespace of a cstring on the left (beginning of string). the original
|
|
* string will be preserved.
|
|
*
|
|
* @param str: the string to trim
|
|
*
|
|
* @return a pointer to the beginning of the trimmed string. the string is not
|
|
* copied, and the returned pointer points to somewhere within the
|
|
* original string.
|
|
*/
|
|
char *
|
|
strtriml (char str[static 1])
|
|
{
|
|
while (*str && isspace (*str))
|
|
str++;
|
|
|
|
return str;
|
|
}
|
|
|
|
/**
|
|
* trim whitespace of a cstring on the right (end of string). a null terminator
|
|
* will be placed after the last non-whitespace character. this modifies the
|
|
* string.
|
|
*
|
|
* @param str: the string to trim
|
|
*
|
|
* @return the new string length.
|
|
*/
|
|
size_t
|
|
strtrimr (char str[static 1])
|
|
{
|
|
size_t len, i;
|
|
|
|
i = len = strlen (str);
|
|
while (i <= len && isspace (str[i - 1]))
|
|
i--;
|
|
str[i] = '\0';
|
|
|
|
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 of `c` in `str`
|
|
*/
|
|
size_t
|
|
strcount (const char str[static 1], char c)
|
|
{
|
|
size_t count;
|
|
|
|
count = 0;
|
|
while (*str)
|
|
if (*str++ == c)
|
|
count += 1;
|
|
|
|
return count;
|
|
}
|
|
|
|
/**
|
|
* transform all uppercase letters of a string into lowercase letters.
|
|
*
|
|
* @param str: the string to convert
|
|
*/
|
|
void
|
|
strdowncase (char str[static 1])
|
|
{
|
|
while (*str)
|
|
{
|
|
if (isupper (*str))
|
|
*str += 0x20;
|
|
str++;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* transform all lowercase letters of a string into uppercase letters.
|
|
*
|
|
* @param str: the string to convert
|
|
*/
|
|
void
|
|
strupcase (char str[static 1])
|
|
{
|
|
while (*str)
|
|
{
|
|
if (islower (*str))
|
|
*str -= 0x20;
|
|
str++;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* check if a string only consists of whitespace characters. whitespaces
|
|
* include the following characters: ' ', '\n', '\r', '\t', '\v', '\f'.
|
|
*
|
|
* @param str: the string to check
|
|
*
|
|
* @return true if the string only consists of whitespace characters, or false
|
|
* if other characters are present.
|
|
*/
|
|
bool
|
|
strisblank (const char str[static 1])
|
|
{
|
|
while (*str)
|
|
if (!isspace (*str++))
|
|
return false;
|
|
return true;
|
|
}
|