foot/xsnprintf.h

#pragma once

#include <stdarg.h>
#include <stddef.h>
#include "macros.h"

size_t xsnprintf(char *restrict buf, size_t n, const char *restrict format, ...) PRINTF(3) NONNULL_ARGS;
Add xsnprintf() and remove some unnecessary strlen(3) calls 2021-01-14 21:30:06 +00:00			`#pragma once`

			`#include <stdarg.h>`
			`#include <stddef.h>`
			`#include "macros.h"`

xsnprintf: various improvements related to xvsnprintf() and xsnprintf() Summary of changes: * Make xvsnprintf() static * restrict-qualify pointer arguments (as done by the libc equivalents) * Make comments and spec references more thorough * Remove pointless `n <= INT_MAX` assertion (see comment) * Use FATAL_ERROR() instead of xassert() (since the assertion is inside a shared util function but the caller is responsible for ensuring the condition holds true) * Change some callers to use size_t instead of int for the return value (negative returns are impossible and all subsequent uses are size_t) The updated comments and code were taken (and adapted) from: https://gitlab.com/craigbarnes/dte/-/blob/49260bb154bca0434462a41c061e512540ec2e49/src/util/xsnprintf.c#L6-50 This work was entirely authored by me and I hereby license this contribution under the MIT license (stated explicitly, so that there's no ambiguity w.r.t. the original license). 2024-09-11 20:13:30 +01:00			`size_t xsnprintf(char restrict buf, size_t n, const char restrict format, ...) PRINTF(3) NONNULL_ARGS;`