]> git.wincent.com - wikitext.git/blob - ext/str.h
6509c903fc22e9c8aefdf3ee4302a1572941f9d4
[wikitext.git] / ext / str.h
1 // Copyright 2008-2009 Wincent Colaiuta. All rights reserved.
2 //
3 // Redistribution and use in source and binary forms, with or without
4 // modification, are permitted provided that the following conditions are met:
5 //
6 // 1. Redistributions of source code must retain the above copyright notice,
7 //    this list of conditions and the following disclaimer.
8 // 2. Redistributions in binary form must reproduce the above copyright notice,
9 //    this list of conditions and the following disclaimer in the documentation
10 //    and/or other materials provided with the distribution.
11 //
12 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
13 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
14 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15 // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
16 // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
17 // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
18 // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
19 // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
20 // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
21 // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
22 // POSSIBILITY OF SUCH DAMAGE.
23
24 #include "ruby_compat.h"
25
26 typedef struct
27 {
28     char *ptr;
29     long len;
30     long capacity;
31 } str_t;
32
33 // create a new, empty string struct
34 str_t *str_new(void);
35
36 // create a new, empty string struct with capacity len
37 str_t *str_new_size(long len);
38
39 // create a new string struct and initialize it with a copy of the buffer of length len pointed to by src
40 str_t *str_new_copy(char *src, long len);
41
42 // create a new string struct and initialize it with the buffer of length len pointed to by src
43 // no copy is made; the struct takes ownership of the buffer and will free it when the struct is disposed of
44 str_t *str_new_no_copy(char *src, long len);
45
46 // convenience method for testing
47 str_t *str_new_from_string(VALUE string);
48
49 // convenience method for testing
50 VALUE string_from_str(str_t *str);
51
52 // grows a string's capacity to the specified length
53 void str_grow(str_t *str, long len);
54
55 void str_append(str_t *str, char *src, long len);
56
57 // appends the "other" string struct onto str
58 void str_append_str(str_t *str, str_t *other);
59
60 // appends the "other" string (a Ruby String) onto str
61 void str_append_rb_str(str_t *str, VALUE other)
62
63 // this is a temporary convenience measure
64 // later on if I develop in-place variants of some functions this won't be needed
65 void str_swap(str_t **a, str_t **b);
66
67 // don't actually free the memory yet
68 // this makes str structs very useful when reusing buffers because it avoids reallocation
69 void str_clear(str_t *str);
70
71 void str_free(str_t *str);