1 2/*-------------------------------------------------------------------------*/ 3/** 4 @file strlib.h 5 @author N. Devillard 6 @date Jan 2001 7 @version $Revision: 1.3 $ 8 @brief Various string handling routines to complement the C lib. 9 10 This modules adds a few complementary string routines usually missing 11 in the standard C library. 12*/ 13/*--------------------------------------------------------------------------*/ 14 15/* 16 $Id: strlib.h,v 1.3 2001/10/19 08:31:41 ndevilla Exp $ 17 $Author: ndevilla $ 18 $Date: 2001/10/19 08:31:41 $ 19 $Revision: 1.3 $ 20*/ 21 22#ifndef _STRLIB_H_ 23#define _STRLIB_H_ 24 25/*--------------------------------------------------------------------------- 26 Includes 27 ---------------------------------------------------------------------------*/ 28 29#include <stdio.h> 30#include <stdlib.h> 31 32/*--------------------------------------------------------------------------- 33 Function codes 34 ---------------------------------------------------------------------------*/ 35 36/*-------------------------------------------------------------------------*/ 37/** 38 @brief Convert a string to lowercase. 39 @param s String to convert. 40 @return ptr to statically allocated string. 41 42 This function returns a pointer to a statically allocated string 43 containing a lowercased version of the input string. Do not free 44 or modify the returned string! Since the returned string is statically 45 allocated, it will be modified at each function call (not re-entrant). 46 */ 47/*--------------------------------------------------------------------------*/ 48char * strlwc(const char * s); 49 50/*-------------------------------------------------------------------------*/ 51/** 52 @brief Convert a string to uppercase. 53 @param s String to convert. 54 @return ptr to statically allocated string. 55 56 This function returns a pointer to a statically allocated string 57 containing an uppercased version of the input string. Do not free 58 or modify the returned string! Since the returned string is statically 59 allocated, it will be modified at each function call (not re-entrant). 60 */ 61/*--------------------------------------------------------------------------*/ 62char * strupc(char * s); 63 64/*-------------------------------------------------------------------------*/ 65/** 66 @brief Skip blanks until the first non-blank character. 67 @param s String to parse. 68 @return Pointer to char inside given string. 69 70 This function returns a pointer to the first non-blank character in the 71 given string. 72 */ 73/*--------------------------------------------------------------------------*/ 74char * strskp(char * s); 75 76/*-------------------------------------------------------------------------*/ 77/** 78 @brief Remove blanks at the end of a string. 79 @param s String to parse. 80 @return ptr to statically allocated string. 81 82 This function returns a pointer to a statically allocated string, 83 which is identical to the input string, except that all blank 84 characters at the end of the string have been removed. 85 Do not free or modify the returned string! Since the returned string 86 is statically allocated, it will be modified at each function call 87 (not re-entrant). 88 */ 89/*--------------------------------------------------------------------------*/ 90char * strcrop(char * s); 91 92/*-------------------------------------------------------------------------*/ 93/** 94 @brief Remove blanks at the beginning and the end of a string. 95 @param s String to parse. 96 @return ptr to statically allocated string. 97 98 This function returns a pointer to a statically allocated string, 99 which is identical to the input string, except that all blank 100 characters at the end and the beg. of the string have been removed. 101 Do not free or modify the returned string! Since the returned string 102 is statically allocated, it will be modified at each function call 103 (not re-entrant). 104 */ 105/*--------------------------------------------------------------------------*/ 106char * strstrip(char * s) ; 107 108#endif 109