category-group: io
layer: 0 description.
The I/O group, as its initials suggest, involve functions and classes relating to input and output. This I/O relates console windows. In Microsoft environments, these are called command windows (and now there are also "PS2 windows"). These are used mainly by console-based applications, which are special types in Microsoft-land. In unix environments, all programs can access a console, even if there is no "real" console attached to the program. In this case (layer 0), there is only 1 solitary function. Its main purpoe is to be used by other, higher-level I/O-oriented components. [C] functions (aka subroutines):
z_getline_stdin()history: ??? 01/25/1998: moved from layer 1's "string.cpp" (string class)
SIGNATURE: size_t z_getline_stdin (char *b, size_t n, int *pi)
SYNOPSIS: gets a line of characters from the standard console input
PARAMETERS
- b: a character buffer
- n: [input] the length of buffer 'b'. This buffer must be at least this size in order for this function to be safe to use
- pi: [output] error indicator variable. values:
0: success; got data
1: e-o-input