logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SDL_snprintf - This works exactly like snprintf() but doesn't require access to a C runtime.

Availability

       This function is available since SDL 3.2.0.

Simple Directmedia Layer                           SDL 3.2.20                                    SDL_snprintf(3)

Description

       Format  a  string of up to maxlen-1 bytes, converting each '%' item with values provided through variable
       arguments.

       While some C runtimes differ on how to deal with too-large strings,  this  function  null-terminates  the
       output,  by  treating  the  null-terminator  as  part  of  the maxlen count. Note that if maxlen is zero,
       however, no bytes will be written at all.

       This function returns the number of _bytes_ (not _characters_) that  should  be  written,  excluding  the
       null-terminator  character. If this returns a number >= maxlen, it means the output string was truncated.
       A negative return value means an error occurred.

       Referencing the output string's pointer with a format item is undefined behavior.

Function Parameters

text   the buffer to write the string into. Must not be NULL.

       maxlen the maximum bytes to write, including the null-terminator.

       fmt    a printf-style format string. Must not be NULL.

       ...    a list of values to be used with the format string.

Name

       SDL_snprintf - This works exactly like snprintf() but doesn't require access to a C runtime.

Return Value

       Returns the number of bytes that should be written, not counting the null-terminator char, or a  negative
       value on error.

Synopsis

#include<SDL3/SDL_stdinc.h>intSDL_snprintf(char*text,size_tmaxlen,constchar*fmt,...);

Thread Safety

       It is safe to call this function from any thread.

See Also