efl/src/lib/evil/evil_string.h

67 lines
1.9 KiB
C

#ifndef __EVIL_STRING_H__
#define __EVIL_STRING_H__
/**
* @file evil_string.h
* @brief The file that provides functions ported from Unix in string.h.
* @defgroup Evil_String_Group String.h functions.
* @ingroup Evil
*
* This header provides functions ported from Unix in string.h.
*
*
*/
/*
* string related functions
*
*/
/**
* @brief Locate a substring into a string, ignoring case.
*
* @param haystack The string to search in.
* @param needle The substring to find.
* @return
*
* This function locates the string @p needle into the string @p haystack,
* ignoring the case of the characters. It returns apointer to the
* beginning of the substring, or NULL if the substring is not found.
* If @p haystack or @p needle are @c NULL, this function returns @c NULL.
*
* Conformity: Non applicable.
*
* Supported OS: Windows XP.
*/
EAPI char *strcasestr(const char *haystack, const char *needle);
/**
* @brief Implements the strsep function which is used to separate strings.
*
* @param stringp The pointer to the string to search in.
* @param delim The delimiter that contains characters used to find the next token.
* @return a pointer to the next token or NULL;
*
* The strsep() function locates, in the string referenced by *stringp, the
* first occurrence of any character in the string delim (or the terminating
* `\0' character) and replaces it with a `\0'. The location of the next
* character after the delimiter character (or NULL, if the end of the
* string was reached) is stored in *stringp. The original value of
* stringp is returned.
*
* An ``empty'' field (i.e., a character in the string delim occurs as the
* first character of *stringp) can be detected by comparing the location
* referenced by the returned pointer to `\0'.
* If *stringp is initially NULL, strsep() returns NULL.
*
* This function is from LibGW32C.
* @since 1.8
*
*/
EAPI char *strsep(char **stringp, const char *delim);
#endif /* __EVIL_STRING_H__ */