1240116Smarcel/* 2240116Smarcel * Automated Testing Framework (atf) 3240116Smarcel * 4240116Smarcel * Copyright (c) 2008 The NetBSD Foundation, Inc. 5240116Smarcel * All rights reserved. 6240116Smarcel * 7240116Smarcel * Redistribution and use in source and binary forms, with or without 8240116Smarcel * modification, are permitted provided that the following conditions 9240116Smarcel * are met: 10240116Smarcel * 1. Redistributions of source code must retain the above copyright 11240116Smarcel * notice, this list of conditions and the following disclaimer. 12240116Smarcel * 2. Redistributions in binary form must reproduce the above copyright 13240116Smarcel * notice, this list of conditions and the following disclaimer in the 14240116Smarcel * documentation and/or other materials provided with the distribution. 15240116Smarcel * 16240116Smarcel * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND 17240116Smarcel * CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, 18240116Smarcel * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 19240116Smarcel * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 20240116Smarcel * IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY 21240116Smarcel * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22240116Smarcel * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 23240116Smarcel * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24240116Smarcel * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER 25240116Smarcel * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 26240116Smarcel * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN 27240116Smarcel * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28240116Smarcel */ 29240116Smarcel 30240116Smarcel#if !defined(ATF_C_DYNSTR_H) 31240116Smarcel#define ATF_C_DYNSTR_H 32240116Smarcel 33240116Smarcel#include <stdarg.h> 34240116Smarcel#include <stdbool.h> 35240116Smarcel#include <stddef.h> 36240116Smarcel 37240116Smarcel#include <atf-c/error_fwd.h> 38240116Smarcel 39240116Smarcel/* --------------------------------------------------------------------- 40240116Smarcel * The "atf_dynstr" type. 41240116Smarcel * --------------------------------------------------------------------- */ 42240116Smarcel 43240116Smarcelstruct atf_dynstr { 44240116Smarcel char *m_data; 45240116Smarcel size_t m_datasize; 46240116Smarcel size_t m_length; 47240116Smarcel}; 48240116Smarceltypedef struct atf_dynstr atf_dynstr_t; 49240116Smarcel 50240116Smarcel/* Constants */ 51240116Smarcelextern const size_t atf_dynstr_npos; 52240116Smarcel 53240116Smarcel/* Constructors and destructors */ 54240116Smarcelatf_error_t atf_dynstr_init(atf_dynstr_t *); 55240116Smarcelatf_error_t atf_dynstr_init_ap(atf_dynstr_t *, const char *, va_list); 56240116Smarcelatf_error_t atf_dynstr_init_fmt(atf_dynstr_t *, const char *, ...); 57240116Smarcelatf_error_t atf_dynstr_init_raw(atf_dynstr_t *, const void *, size_t); 58240116Smarcelatf_error_t atf_dynstr_init_rep(atf_dynstr_t *, size_t, char); 59240116Smarcelatf_error_t atf_dynstr_init_substr(atf_dynstr_t *, const atf_dynstr_t *, 60240116Smarcel size_t, size_t); 61240116Smarcelatf_error_t atf_dynstr_copy(atf_dynstr_t *, const atf_dynstr_t *); 62240116Smarcelvoid atf_dynstr_fini(atf_dynstr_t *); 63240116Smarcelchar *atf_dynstr_fini_disown(atf_dynstr_t *); 64240116Smarcel 65240116Smarcel/* Getters */ 66240116Smarcelconst char *atf_dynstr_cstring(const atf_dynstr_t *); 67240116Smarcelsize_t atf_dynstr_length(const atf_dynstr_t *); 68240116Smarcelsize_t atf_dynstr_rfind_ch(const atf_dynstr_t *, char); 69240116Smarcel 70240116Smarcel/* Modifiers */ 71240116Smarcelatf_error_t atf_dynstr_append_ap(atf_dynstr_t *, const char *, va_list); 72240116Smarcelatf_error_t atf_dynstr_append_fmt(atf_dynstr_t *, const char *, ...); 73240116Smarcelvoid atf_dynstr_clear(atf_dynstr_t *); 74240116Smarcelatf_error_t atf_dynstr_prepend_ap(atf_dynstr_t *, const char *, va_list); 75240116Smarcelatf_error_t atf_dynstr_prepend_fmt(atf_dynstr_t *, const char *, ...); 76240116Smarcel 77240116Smarcel/* Operators */ 78240116Smarcelbool atf_equal_dynstr_cstring(const atf_dynstr_t *, const char *); 79240116Smarcelbool atf_equal_dynstr_dynstr(const atf_dynstr_t *, const atf_dynstr_t *); 80240116Smarcel 81240116Smarcel#endif /* ATF_C_DYNSTR_H */ 82