2
* include/common/chunk.h
3
* Chunk management definitions, macros and inline functions.
5
* Copyright (C) 2000-2012 Willy Tarreau - w@1wt.eu
7
* This library is free software; you can redistribute it and/or
8
* modify it under the terms of the GNU Lesser General Public
9
* License as published by the Free Software Foundation, version 2.1
12
* This library is distributed in the hope that it will be useful,
13
* but WITHOUT ANY WARRANTY; without even the implied warranty of
14
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15
* Lesser General Public License for more details.
17
* You should have received a copy of the GNU Lesser General Public
18
* License along with this library; if not, write to the Free Software
19
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22
#ifndef _TYPES_CHUNK_H
23
#define _TYPES_CHUNK_H
28
#include <common/config.h>
31
/* describes a chunk of string */
33
char *str; /* beginning of the string itself. Might not be 0-terminated */
34
int size; /* total size of the buffer, 0 if the *str is read-only */
35
int len; /* current size of the string from first to last char. <0 = uninit. */
38
/* function prototypes */
40
int chunk_printf(struct chunk *chk, const char *fmt, ...)
41
__attribute__ ((format(printf, 2, 3)));
43
int chunk_appendf(struct chunk *chk, const char *fmt, ...)
44
__attribute__ ((format(printf, 2, 3)));
46
int chunk_htmlencode(struct chunk *dst, struct chunk *src);
47
int chunk_asciiencode(struct chunk *dst, struct chunk *src, char qc);
48
int chunk_strcmp(const struct chunk *chk, const char *str);
49
int chunk_strcasecmp(const struct chunk *chk, const char *str);
50
int alloc_trash_buffers(int bufsize);
51
struct chunk *get_trash_chunk(void);
53
static inline void chunk_reset(struct chunk *chk)
58
static inline void chunk_init(struct chunk *chk, char *str, size_t size)
65
/* report 0 in case of error, 1 if OK. */
66
static inline int chunk_initlen(struct chunk *chk, char *str, size_t size, int len)
69
if (size && len > size)
79
static inline void chunk_initstr(struct chunk *chk, char *str)
82
chk->len = strlen(str);
83
chk->size = 0; /* mark it read-only */
86
static inline int chunk_strcpy(struct chunk *chk, const char *str)
92
if (unlikely(len > chk->size))
96
memcpy(chk->str, str, len);
101
static inline void chunk_drop(struct chunk *chk)
108
static inline void chunk_destroy(struct chunk *chk)
118
* frees the destination chunk if already allocated, allocates a new string,
119
* and copies the source into it. The pointer to the destination string is
120
* returned, or NULL if the allocation fails or if any pointer is NULL..
122
static inline char *chunk_dup(struct chunk *dst, const struct chunk *src)
124
if (!dst || !src || !src->str)
129
dst->str = (char *)malloc(dst->len);
130
memcpy(dst->str, src->str, dst->len);
134
#endif /* _TYPES_CHUNK_H */