diff options
Diffstat (limited to '3rdparty/gumbo-parser/src/string_buffer.h')
| -rw-r--r-- | 3rdparty/gumbo-parser/src/string_buffer.h | 84 |
1 files changed, 84 insertions, 0 deletions
diff --git a/3rdparty/gumbo-parser/src/string_buffer.h b/3rdparty/gumbo-parser/src/string_buffer.h new file mode 100644 index 0000000..ee7956a --- /dev/null +++ b/3rdparty/gumbo-parser/src/string_buffer.h @@ -0,0 +1,84 @@ +// Copyright 2010 Google Inc. All Rights Reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. +// +// Author: jdtang@google.com (Jonathan Tang) +// +#ifndef GUMBO_STRING_BUFFER_H_ +#define GUMBO_STRING_BUFFER_H_ + +#include <stdbool.h> +#include <stddef.h> + +#include "gumbo.h" + +#ifdef __cplusplus +extern "C" { +#endif + +struct GumboInternalParser; + +// A struct representing a mutable, growable string. This consists of a +// heap-allocated buffer that may grow (by doubling) as necessary. When +// converting to a string, this allocates a new buffer that is only as long as +// it needs to be. Note that the internal buffer here is *not* nul-terminated, +// so be sure not to use ordinary string manipulation functions on it. +typedef struct { + // A pointer to the beginning of the string. NULL iff length == 0. + char* data; + + // The length of the string fragment, in bytes. May be zero. + size_t length; + + // The capacity of the buffer, in bytes. + size_t capacity; +} GumboStringBuffer; + +// Initializes a new GumboStringBuffer. +void gumbo_string_buffer_init( + struct GumboInternalParser* parser, GumboStringBuffer* output); + +// Ensures that the buffer contains at least a certain amount of space. Most +// useful with snprintf and the other length-delimited string functions, which +// may want to write directly into the buffer. +void gumbo_string_buffer_reserve(struct GumboInternalParser* parser, + size_t min_capacity, GumboStringBuffer* output); + +// Appends a single Unicode codepoint onto the end of the GumboStringBuffer. +// This is essentially a UTF-8 encoder, and may add 1-4 bytes depending on the +// value of the codepoint. +void gumbo_string_buffer_append_codepoint( + struct GumboInternalParser* parser, int c, GumboStringBuffer* output); + +// Appends a string onto the end of the GumboStringBuffer. +void gumbo_string_buffer_append_string(struct GumboInternalParser* parser, + GumboStringPiece* str, GumboStringBuffer* output); + +// Converts this string buffer to const char*, alloctaing a new buffer for it. +char* gumbo_string_buffer_to_string( + struct GumboInternalParser* parser, GumboStringBuffer* input); + +// Reinitialize this string buffer. This clears it by setting length=0. It +// does not zero out the buffer itself. +void gumbo_string_buffer_clear( + struct GumboInternalParser* parser, GumboStringBuffer* input); + +// Deallocates this GumboStringBuffer. +void gumbo_string_buffer_destroy( + struct GumboInternalParser* parser, GumboStringBuffer* buffer); + +#ifdef __cplusplus +} +#endif + +#endif // GUMBO_STRING_BUFFER_H_ |
