xref: /aosp_15_r20/external/mesa3d/src/util/string_buffer.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)

/*
 * Copyright © 2017 Thomas Helland
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
 * IN THE SOFTWARE.
 *
 */
#ifndef _STRING_BUFFER_H
#define _STRING_BUFFER_H

#include "ralloc.h"
#include "u_string.h"
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include <string.h>

#ifdef __cplusplus
extern "C" {
#endif

struct _mesa_string_buffer {
   char *buf;
   uint32_t length;
   uint32_t capacity;
};

struct _mesa_string_buffer *
_mesa_string_buffer_create(void *mem_ctx, uint32_t initial_capacity);

static inline void
_mesa_string_buffer_destroy(struct _mesa_string_buffer *str)
{
   ralloc_free(str);
}

bool
_mesa_string_buffer_append_all(struct _mesa_string_buffer *str,
                               uint32_t num_args, ...);
bool
_mesa_string_buffer_append_len(struct _mesa_string_buffer *str,
                               const char *c, uint32_t len);

static inline bool
_mesa_string_buffer_append_char(struct _mesa_string_buffer *str, char c)
{
   return _mesa_string_buffer_append_len(str, &c, 1);
}

static inline bool
_mesa_string_buffer_append(struct _mesa_string_buffer *str, const char *c)
{
   return _mesa_string_buffer_append_len(str, c, strlen(c));
}

static inline void
_mesa_string_buffer_clear(struct _mesa_string_buffer *str)
{
   str->length = 0;
   str->buf[str->length] = '\0';
}

static inline void
_mesa_string_buffer_crimp_to_fit(struct _mesa_string_buffer *str)
{
    char *crimped =
       (char *) reralloc_array_size(str, str->buf, sizeof(char),
                                    str->capacity);
    if (!crimped)
       return;

    str->capacity = str->length + 1;
    str->buf = crimped;
}

bool
_mesa_string_buffer_vprintf(struct _mesa_string_buffer *str,
                            const char *format, va_list args);

bool
_mesa_string_buffer_printf(struct _mesa_string_buffer *str,
                            const char *format, ...) PRINTFLIKE(2, 3);

#ifdef __cplusplus
} /* extern "C" */
#endif

#endif /* _STRING_BUFFER_H */