summaryrefslogtreecommitdiff
path: root/src/dstring.h
blob: 36ea4fe367d4f9ac73d8841edaf090c39d3a3521 (plain)
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
/*

    kbs - Simple, easily fooled, POP3 spam filter

    Copyright (C) 2003  Ian Cowburn (ianc@noddybox.demon.co.uk)

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    -------------------------------------------------------------------------

    $Id$

    Dynamic strings

*/

#ifndef KBS_DSTRING_H
#define KBS_DSTRING_H "$Id$"

/* ---------------------------------------- TYPES
*/
typedef struct
    {
    size_t	len;
    char	*text;
    } *DString;

/* ---------------------------------------- INTERFACES
*/

/* Sets a DString up for use.  Note when reusing the same DString, remember
   to call DSReset() and get the return.

   Returns the new DString.
*/
DString	DSInit();


/* Frees a DString.  NULL can be safely passed.
*/
void	DSFree(DString ds);


/* Resets a string.  Basically calls DSFree() then DSInit().

   Returns the parameter.
*/
DString DSReset(DString ds);


/* Adds a character onto a DString.

   Returns the passed DString.
*/
DString	DSAddChar(DString to, char c);


/* Adds a nul-terminated char pointer onto a DString.

   Returns the passed DString.
*/
DString	DSAddCP(DString to, const char *p);


/* Adds another DString.

   Returns the passed to DString.
*/
DString	DSAddDS(DString to, const DString from);


#endif

/* END OF FILE */