-
Notifications
You must be signed in to change notification settings - Fork 5
/
inistrlib.h
119 lines (99 loc) · 4.42 KB
/
inistrlib.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
/*-------------------------------------------------------------------------*/
/**
@file inistrlib.h
@author N. Devillard
@date Jan 2001
@version $Revision: 1.3 $
@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.
*/
/*--------------------------------------------------------------------------*/
/*
$Id: inistrlib.h,v 1.3 2001/10/19 08:31:41 ndevilla Exp $
$Author: ndevilla $
$Date: 2001/10/19 08:31:41 $
$Revision: 1.3 $
*/
#ifndef _INISTRLIB_H_
#define _INISTRLIB_H_
/*---------------------------------------------------------------------------
Includes
---------------------------------------------------------------------------*/
/*---------------------------------------------------------------------------
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 * inistrlwc(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 * inistrupc(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 * inistrskp(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 * inistrcrop(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 * inistrstrip(char * s) ;
/*-------------------------------------------------------------------------*/
/**
@brief Duplicate a string by allocating memory and copy the contents.
@param s String to duplicate.
@return ptr to dynamically allocated string.
This function returns a pointer to a dynamically allocated string,
which is identical to the input string.
Free the returned string when it is no longer used.
*/
/*--------------------------------------------------------------------------*/
char *inistrdup(const char *s);
#endif