124 lines
3.9 KiB
C
124 lines
3.9 KiB
C
|
|
||
|
|
/*-------------------------------------------------------------------------*/
|
||
|
|
/**
|
||
|
|
@file strlib.h
|
||
|
|
@author N. Devillard
|
||
|
|
@date Jan 2001
|
||
|
|
@version
|
||
|
|
@brief Various string handling routines to complement the C lib.
|
||
|
|
|
||
|
|
This modules adds a few complementary string routines usually missing
|
||
|
|
in the standard C library.
|
||
|
|
*/
|
||
|
|
/*--------------------------------------------------------------------------*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef _STRLIB_H_
|
||
|
|
#define _STRLIB_H_
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------
|
||
|
|
Includes
|
||
|
|
---------------------------------------------------------------------------*/
|
||
|
|
|
||
|
|
#include <stdio.h>
|
||
|
|
#include <stdlib.h>
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
#if __cplusplus
|
||
|
|
extern "C"{
|
||
|
|
#endif
|
||
|
|
#endif /* __cplusplus */
|
||
|
|
|
||
|
|
/*---------------------------------------------------------------------------
|
||
|
|
Function codes
|
||
|
|
---------------------------------------------------------------------------*/
|
||
|
|
|
||
|
|
/*-------------------------------------------------------------------------*/
|
||
|
|
/**
|
||
|
|
@brief Convert a string to lowercase.
|
||
|
|
@param s String to convert.
|
||
|
|
@return ptr to statically allocated string.
|
||
|
|
|
||
|
|
This function returns a pointer to a statically allocated string
|
||
|
|
containing a lowercased version of the input string. Do not free
|
||
|
|
or modify the returned string! Since the returned string is statically
|
||
|
|
allocated, it will be modified at each function call (not re-entrant).
|
||
|
|
*/
|
||
|
|
/*--------------------------------------------------------------------------*/
|
||
|
|
char * strlwc(const char * s);
|
||
|
|
|
||
|
|
/*-------------------------------------------------------------------------*/
|
||
|
|
/**
|
||
|
|
@brief Convert a string to uppercase.
|
||
|
|
@param s String to convert.
|
||
|
|
@return ptr to statically allocated string.
|
||
|
|
|
||
|
|
This function returns a pointer to a statically allocated string
|
||
|
|
containing an uppercased version of the input string. Do not free
|
||
|
|
or modify the returned string! Since the returned string is statically
|
||
|
|
allocated, it will be modified at each function call (not re-entrant).
|
||
|
|
*/
|
||
|
|
/*--------------------------------------------------------------------------*/
|
||
|
|
char * strupc(char * s);
|
||
|
|
|
||
|
|
/*-------------------------------------------------------------------------*/
|
||
|
|
/**
|
||
|
|
@brief Skip blanks until the first non-blank character.
|
||
|
|
@param s String to parse.
|
||
|
|
@return Pointer to char inside given string.
|
||
|
|
|
||
|
|
This function returns a pointer to the first non-blank character in the
|
||
|
|
given string.
|
||
|
|
*/
|
||
|
|
/*--------------------------------------------------------------------------*/
|
||
|
|
char * strskp(char * s);
|
||
|
|
|
||
|
|
/*-------------------------------------------------------------------------*/
|
||
|
|
/**
|
||
|
|
@brief Remove blanks at the end of a string.
|
||
|
|
@param s String to parse.
|
||
|
|
@return ptr to statically allocated string.
|
||
|
|
|
||
|
|
This function returns a pointer to a statically allocated string,
|
||
|
|
which is identical to the input string, except that all blank
|
||
|
|
characters at the end of the string have been removed.
|
||
|
|
Do not free or modify the returned string! Since the returned string
|
||
|
|
is statically allocated, it will be modified at each function call
|
||
|
|
(not re-entrant).
|
||
|
|
*/
|
||
|
|
/*--------------------------------------------------------------------------*/
|
||
|
|
char * strcrop(char * s);
|
||
|
|
|
||
|
|
/*-------------------------------------------------------------------------*/
|
||
|
|
/**
|
||
|
|
@brief Remove blanks at the beginning and the end of a string.
|
||
|
|
@param s String to parse.
|
||
|
|
@return ptr to statically allocated string.
|
||
|
|
|
||
|
|
This function returns a pointer to a statically allocated string,
|
||
|
|
which is identical to the input string, except that all blank
|
||
|
|
characters at the end and the beg. of the string have been removed.
|
||
|
|
Do not free or modify the returned string! Since the returned string
|
||
|
|
is statically allocated, it will be modified at each function call
|
||
|
|
(not re-entrant).
|
||
|
|
*/
|
||
|
|
/*--------------------------------------------------------------------------*/
|
||
|
|
char * strstrip(char * s) ;
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
#if __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
#endif /* __cplusplus */
|
||
|
|
|
||
|
|
|
||
|
|
#endif
|