cstr.h

Go to the documentation of this file.

/*
 * 🧵 str — cstr.h
 * Copyright (c) 2025–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 <stddef.h>
 
#if __STDC_VERSION__ < 202311L && (!defined(_POSIX_C_SOURCE) || _POSIX_C_SOURCE < 200809L)
 
// MSVC has memccpy() and strdup(), though it will complain about using
// the POSIX names `memccpy()` & `strdup()` rather than the
// MSVC-specific `_memccpy()` & `_strdup()`.
// https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/memccpy
// https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/strdup-wcsdup-mbsdup
#if !defined(NO_STR_MEMCCPY) && !defined(_MSC_VER)

void *memccpy(void *restrict dest, const void *restrict src, int ch, size_t len);

char *strdup(const char *src);
 
#endif

char *strndup(const char *src, size_t size);
 
#endif

char *strzcpy(char dest[restrict static 1], const char src[restrict static 1], size_t len);