Console Input/Output

Table of Contents

• Writing text
• Writing formatted text
• Reading a character
• Notes

FPL provides a couple of functions for writing text to the console and reading a single character from it.
These work with the standard output and standard error streams.

Note

To get an actual console window on Windows, include the fplInitFlags_Console flag when calling fplPlatformInit() .

Writing text

Use fplConsoleOut() to write plain text to the standard output and fplConsoleError() to write plain text to the standard error stream.

fplConsoleOut("Hello from standard output\n");
fplConsoleError("Something went wrong\n");

Writing formatted text

For printf-style formatting, use fplConsoleFormatOut() for the standard output and fplConsoleFormatError() for the standard error stream.
Both take a format string followed by a variable number of arguments.

int frame = 42;
fplConsoleFormatOut("Current frame: %d\n", frame);
fplConsoleFormatError("Failed to load asset '%s'\n", "player.png");

Reading a character

Use fplConsoleWaitForCharInput() to block until a single character is typed into the console input, and return it.

fplConsoleOut("Press any key to continue...\n");
char c = fplConsoleWaitForCharInput();
fplConsoleFormatOut("You pressed: %c\n", c);

Notes

• fplConsoleOut() and fplConsoleError() are simple wrappers around fprintf(stdout) / fprintf(stderr).
• fplConsoleFormatOut() and fplConsoleFormatError() are wrappers around vfprintf().
• fplConsoleWaitForCharInput() is a wrapper around getchar().