Merge in simple extrace for strings, style issues in io
[awesomized/libmemcached] / libmemcached / string.h
1 /* vim:expandtab:shiftwidth=2:tabstop=2:smarttab:
2 *
3 * Libmemcached library
4 *
5 * Copyright (C) 2011 Data Differential, http://datadifferential.com/
6 * Copyright (C) 2006-2009 Brian Aker All rights reserved.
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are
10 * met:
11 *
12 * * Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 *
15 * * Redistributions in binary form must reproduce the above
16 * copyright notice, this list of conditions and the following disclaimer
17 * in the documentation and/or other materials provided with the
18 * distribution.
19 *
20 * * The names of its contributors may not be used to endorse or
21 * promote products derived from this software without specific prior
22 * written permission.
23 *
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
27 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
28 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
29 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
30 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
31 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
32 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
33 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
34 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 *
36 */
37
38 #pragma once
39
40 #include <libmemcached/basic_string.h>
41
42 /**
43 Strings are always under our control so we make some assumptions
44 about them.
45
46 1) is_initialized is always valid.
47 2) A string once intialized will always be, until free where we
48 unset this flag.
49 3) A string always has a root.
50 */
51
52 struct memcached_string_st {
53 char *end;
54 char *string;
55 size_t current_size;
56 memcached_st *root;
57 struct {
58 bool is_allocated:1;
59 bool is_initialized:1;
60 } options;
61 };
62
63 #ifdef BUILDING_LIBMEMCACHED
64
65 #ifdef __cplusplus
66 extern "C" {
67 #endif
68
69 LIBMEMCACHED_LOCAL
70 memcached_string_st *memcached_string_create(memcached_st *ptr,
71 memcached_string_st *string,
72 size_t initial_size);
73 LIBMEMCACHED_LOCAL
74 memcached_return_t memcached_string_check(memcached_string_st *string, size_t need);
75
76 LIBMEMCACHED_LOCAL
77 char *memcached_string_c_copy(memcached_string_st *string);
78
79 LIBMEMCACHED_LOCAL
80 memcached_return_t memcached_string_append_character(memcached_string_st *string,
81 char character);
82 LIBMEMCACHED_LOCAL
83 memcached_return_t memcached_string_append(memcached_string_st *string,
84 const char *value, size_t length);
85 LIBMEMCACHED_LOCAL
86 memcached_return_t memcached_string_reset(memcached_string_st *string);
87
88 LIBMEMCACHED_LOCAL
89 void memcached_string_free(memcached_string_st *string);
90
91 LIBMEMCACHED_LOCAL
92 size_t memcached_string_length(const memcached_string_st *self);
93
94 LIBMEMCACHED_LOCAL
95 size_t memcached_string_size(const memcached_string_st *self);
96
97 LIBMEMCACHED_LOCAL
98 const char *memcached_string_value(const memcached_string_st *self);
99
100 LIBMEMCACHED_LOCAL
101 char *memcached_string_take_value(memcached_string_st *self);
102
103 LIBMEMCACHED_LOCAL
104 char *memcached_string_value_mutable(const memcached_string_st *self);
105
106 LIBMEMCACHED_LOCAL
107 void memcached_string_set_length(memcached_string_st *self, size_t length);
108
109 #ifdef __cplusplus
110 }
111 #endif
112
113 #endif