/* String descriptors. Copyright (C) 2023 Free Software Foundation, Inc. This file is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This file is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this program. If not, see . */ /* Written by Bruno Haible , 2023. */ #ifdef HAVE_CONFIG_H # include "config.h" #endif #define GL_STRING_DESC_INLINE _GL_EXTERN_INLINE /* Specification and inline definitions. */ #include "string-desc.h" #include #include #include #include "ialloc.h" #include "full-write.h" /* ==== Side-effect-free operations on string descriptors ==== */ /* Return true if A and B are equal. */ bool string_desc_equals (string_desc_t a, string_desc_t b) { return (a._nbytes == b._nbytes && (a._nbytes == 0 || memcmp (a._data, b._data, a._nbytes) == 0)); } bool string_desc_startswith (string_desc_t s, string_desc_t prefix) { return (s._nbytes >= prefix._nbytes && (prefix._nbytes == 0 || memcmp (s._data, prefix._data, prefix._nbytes) == 0)); } bool string_desc_endswith (string_desc_t s, string_desc_t suffix) { return (s._nbytes >= suffix._nbytes && (suffix._nbytes == 0 || memcmp (s._data + (s._nbytes - suffix._nbytes), suffix._data, suffix._nbytes) == 0)); } int string_desc_cmp (string_desc_t a, string_desc_t b) { if (a._nbytes > b._nbytes) { if (b._nbytes == 0) return 1; return (memcmp (a._data, b._data, b._nbytes) < 0 ? -1 : 1); } else if (a._nbytes < b._nbytes) { if (a._nbytes == 0) return -1; return (memcmp (a._data, b._data, a._nbytes) > 0 ? 1 : -1); } else /* a._nbytes == b._nbytes */ { if (a._nbytes == 0) return 0; return memcmp (a._data, b._data, a._nbytes); } } ptrdiff_t string_desc_index (string_desc_t s, char c) { if (s._nbytes > 0) { void *found = memchr (s._data, (unsigned char) c, s._nbytes); if (found != NULL) return (char *) found - s._data; } return -1; } ptrdiff_t string_desc_last_index (string_desc_t s, char c) { if (s._nbytes > 0) { void *found = memrchr (s._data, (unsigned char) c, s._nbytes); if (found != NULL) return (char *) found - s._data; } return -1; } string_desc_t string_desc_new_empty (void) { string_desc_t result; result._nbytes = 0; result._data = NULL; return result; } string_desc_t string_desc_from_c (const char *s) { string_desc_t result; result._nbytes = strlen (s); result._data = (char *) s; return result; } string_desc_t string_desc_substring (string_desc_t s, idx_t start, idx_t end) { string_desc_t result; if (!(start >= 0 && start <= end)) /* Invalid arguments. */ abort (); result._nbytes = end - start; result._data = s._data + start; return result; } int string_desc_write (int fd, string_desc_t s) { if (s._nbytes > 0) if (full_write (fd, s._data, s._nbytes) != s._nbytes) /* errno is set here. */ return -1; return 0; } int string_desc_fwrite (FILE *fp, string_desc_t s) { if (s._nbytes > 0) if (fwrite (s._data, 1, s._nbytes, fp) != s._nbytes) return -1; return 0; } /* ==== Memory-allocating operations on string descriptors ==== */ int string_desc_new (string_desc_t *resultp, idx_t n) { string_desc_t result; if (!(n >= 0)) /* Invalid argument. */ abort (); result._nbytes = n; if (n == 0) result._data = NULL; else { result._data = (char *) imalloc (n); if (result._data == NULL) /* errno is set here. */ return -1; } *resultp = result; return 0; } string_desc_t string_desc_new_addr (idx_t n, char *addr) { string_desc_t result; result._nbytes = n; if (n == 0) result._data = NULL; else result._data = addr; return result; } int string_desc_new_filled (string_desc_t *resultp, idx_t n, char c) { string_desc_t result; result._nbytes = n; if (n == 0) result._data = NULL; else { result._data = (char *) imalloc (n); if (result._data == NULL) /* errno is set here. */ return -1; memset (result._data, (unsigned char) c, n); } *resultp = result; return 0; } int string_desc_copy (string_desc_t *resultp, string_desc_t s) { string_desc_t result; idx_t n = s._nbytes; result._nbytes = n; if (n == 0) result._data = NULL; else { result._data = (char *) imalloc (n); if (result._data == NULL) /* errno is set here. */ return -1; memcpy (result._data, s._data, n); } *resultp = result; return 0; } int string_desc_concat (string_desc_t *resultp, idx_t n, string_desc_t string1, ...) { if (n <= 0) /* Invalid argument. */ abort (); idx_t total = 0; total += string1._nbytes; if (n > 1) { va_list other_strings; idx_t i; va_start (other_strings, string1); for (i = n - 1; i > 0; i--) { string_desc_t arg = va_arg (other_strings, string_desc_t); total += arg._nbytes; } va_end (other_strings); } char *combined = (char *) imalloc (total); if (combined == NULL) /* errno is set here. */ return -1; idx_t pos = 0; memcpy (combined, string1._data, string1._nbytes); pos += string1._nbytes; if (n > 1) { va_list other_strings; idx_t i; va_start (other_strings, string1); for (i = n - 1; i > 0; i--) { string_desc_t arg = va_arg (other_strings, string_desc_t); if (arg._nbytes > 0) memcpy (combined + pos, arg._data, arg._nbytes); pos += arg._nbytes; } va_end (other_strings); } string_desc_t result; result._nbytes = total; result._data = combined; *resultp = result; return 0; } char * string_desc_c (string_desc_t s) { idx_t n = s._nbytes; char *result = (char *) imalloc (n + 1); if (result == NULL) /* errno is set here. */ return NULL; if (n > 0) memcpy (result, s._data, n); result[n] = '\0'; return result; } /* ==== Operations with side effects on string descriptors ==== */ void string_desc_set_char_at (string_desc_t s, idx_t i, char c) { if (!(i >= 0 && i < s._nbytes)) /* Invalid argument. */ abort (); s._data[i] = c; } void string_desc_fill (string_desc_t s, idx_t start, idx_t end, char c) { if (!(start >= 0 && start <= end)) /* Invalid arguments. */ abort (); if (start < end) memset (s._data + start, (unsigned char) c, end - start); } void string_desc_overwrite (string_desc_t s, idx_t start, string_desc_t t) { if (!(start >= 0 && start + t._nbytes <= s._nbytes)) /* Invalid arguments. */ abort (); if (t._nbytes > 0) memcpy (s._data + start, t._data, t._nbytes); } void string_desc_free (string_desc_t s) { free (s._data); }