str.h

Go to the documentation of this file.

/*
 * 🧵 str — str.h
 * Copyright (c) 2026 Fawn <rubiefawn@gmail.com>
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#pragma once
#include <stdbool.h>
#include <stddef.h>

typedef struct str {
    char *data;

    size_t len;
} str;

str str_from_cstr(char *sz);

str str_strip_whitespace(str it);

str str_strip_whitespace_pre(str it);

str str_strip_whitespace_post(str it);

str str_strip_prefix_str(str it, str prefix);

str str_strip_prefix_cstr(str it, const char *prefix);

str str_strip_prefix_if(str it, bool (*predicate)(char c));

#define str_strip_prefix(IT, PREFIX) _Generic((PREFIX),\
    str             : str_strip_prefix_str,\
    char *          : str_strip_prefix_cstr,\
    bool (*)(char c): str_strip_prefix_if\
)((IT), (PREFIX))

str str_strip_postfix_str(str it, str postfix);

str str_strip_postfix_cstr(str it, const char *postfix);

str str_strip_postfix_if(str it, bool (*predicate)(char c));

#define str_strip_postfix(IT, POSTFIX) _Generic((POSTFIX),\
    str             : str_strip_postfix_str,\
    char *          : str_strip_postfix_cstr,\
    bool (*)(char c): str_strip_postfix_if\
)((IT), (POSTFIX))

bool str_is_sz(str it);

int str_cmp_str(str a, str b);

int str_cmp_cstr(str a, const char *b);

int cstr_cmp_str(const char *a, str b);

#define cstr_cmp_cstr strcmp

#define str_cmp(LHS, RHS) _Generic((LHS),\
    str   : _Generic((RHS),\
        str   : str_cmp_str,\
        char *: str_cmp_cstr\
    ),\
    char *: _Generic((RHS),\
        str   : cstr_cmp_str,\
        char *: strcmp\
    )\
)((LHS), (RHS))

bool str_eq_str(str a, str b);

bool str_eq_cstr(str a, const char *b);

bool cstr_eq_str(const char *a, str b);

bool cstr_eq_cstr(const char *a, const char *b);

#define str_eq(LHS, RHS) _Generic((LHS),\
    str   : _Generic((RHS),\
        str   : str_eq_str,\
        char *: str_eq_cstr\
    ),\
    char *: _Generic((RHS),\
        str   : cstr_eq_str,\
        char *: cstr_eq_cstr\
    )\
)((LHS), (RHS))

bool str_eq_str_any(str it, size_t count, ...);

bool str_eq_cstr_any(str it, size_t count, ...);

bool cstr_eq_str_any(const char *it, size_t count, ...);

bool cstr_eq_cstr_any(const char *it, size_t count, ...);

#define str_eq_any(LHS, COUNT, RHS, ...) _Generic((LHS),\
    str   : _Generic((RHS),\
        str   : str_eq_str_any,\
        char *: str_eq_cstr_any\
    ),\
    char *: _Generic((RHS),\
        str   : cstr_eq_str_any,\
        char *: cstr_eq_cstr_any\
    )\
)((LHS), (COUNT), (RHS) __VA_OPT(, __VA_ARGS__))