NAME

lua_pushfstring — pushes onto the stack a formatted string and returns a pointer to this string, function indicator [-0, +1, m]

SYNOPSIS

#include <lua.h>

const char *
lua_pushfstring(lua_State *L, const char *fmt, ...);

DESCRIPTION

lua_pushfstring() pushes onto the stack a formatted string and returns a pointer to this string. It is similar to the C function sprintf(3), but has some important differences:

• You do not have to allocate space for the result: the result is a Lua string and Lua takes care of memory allocation (and deallocation, through garbage collection).
• The conversion specifiers are quite restricted. There are no flags, widths, or precisions. The conversion specifiers can only be ‘%%’ (inserts a '%' in the string), ‘%s’ (inserts a zero-terminated string, with no size restrictions), ‘%f’ (inserts a lua_Number(3)), ‘%p’ (inserts a pointer as a hexadecimal numeral), ‘%d’ (inserts an int), and ‘%c’ (inserts an int as a character).

SEE ALSO

lua_Number(3)

Roberto Ierusalimschy, Luiz Henrique de Figueiredo, and Waldemar Celes, Lua 5.1 Reference Manual.

HISTORY

The lua_pushfstring() manual page is based on Lua Reference Manual 5.1 and was created by Sergey Bronnikov.