aboutsummaryrefslogtreecommitdiff
path: root/xsnprintf.h
diff options
context:
space:
mode:
authorCraig Barnes <craigbarnes@protonmail.com>2024-09-11 19:13:30 +0000
committerDaniel Eklöf <daniel@ekloef.se>2024-09-13 07:01:15 +0000
commitd4a1283797b5a964d92e64c698d65f701a90e1cc (patch)
tree936de5689747d1fac28893dd60b0bca2852508ae /xsnprintf.h
parentreadme: typo: foot-ctlseq -> foot-ctlseqs (diff)
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).
Diffstat (limited to 'xsnprintf.h')
-rw-r--r--xsnprintf.h3
1 files changed, 1 insertions, 2 deletions
diff --git a/xsnprintf.h b/xsnprintf.h
index c745ef3e..9463a34a 100644
--- a/xsnprintf.h
+++ b/xsnprintf.h
@@ -4,5 +4,4 @@
#include <stddef.h>
#include "macros.h"
-size_t xsnprintf(char *buf, size_t len, const char *fmt, ...) PRINTF(3) NONNULL_ARGS;
-size_t xvsnprintf(char *buf, size_t len, const char *fmt, va_list ap) VPRINTF(3) NONNULL_ARGS;
+size_t xsnprintf(char *restrict buf, size_t n, const char *restrict format, ...) PRINTF(3) NONNULL_ARGS;