Generic stdio-like input interface.
More...
|
| int | snd_input_close (snd_input_t *input) |
| | Closes an input handle.
|
| |
| int | snd_input_scanf (snd_input_t *input, const char *format,...) |
| | Reads formatted input (like fscanf(3)) from an input handle.
|
| |
| char * | snd_input_gets (snd_input_t *input, char *str, size_t size) |
| | Reads a line from an input handle (like fgets(3)).
|
| |
| int | snd_input_getc (snd_input_t *input) |
| | Reads a character from an input handle (like fgetc(3)).
|
| |
| int | snd_input_ungetc (snd_input_t *input, int c) |
| | Puts the last character read back to an input handle (like ungetc(3)).
|
| |
| int | snd_input_stdio_attach (snd_input_t **inputp, FILE *fp, int _close) |
| | Creates a new input object using an existing stdio FILE pointer.
|
| |
| int | snd_input_stdio_open (snd_input_t **inputp, const char *file, const char *mode) |
| | Creates a new input object reading from a file.
|
| |
| int | snd_input_buffer_open (snd_input_t **inputp, const char *buf, ssize_t size) |
| | Creates a new input object from a memory buffer.
|
| |
Generic stdio-like input interface.
- Author
- Abramo Bagnara abram.nosp@m.o@al.nosp@m.sa-pr.nosp@m.ojec.nosp@m.t.org
- Date
- 2000
Generic stdio-like input interface
◆ snd_input_buffer_open()
| int snd_input_buffer_open |
( |
snd_input_t ** | inputp, |
|
|
const char * | buf, |
|
|
ssize_t | size ) |
Creates a new input object from a memory buffer.
- Parameters
-
| inputp | The function puts the pointer to the new input object at the address specified by inputp. |
| buf | Address of the input buffer. |
| size | Size of the input buffer. |
- Returns
- Zero if successful, otherwise a negative error code.
This functions creates a copy of the input buffer, so the application is not required to preserve the buffer after this function has been called.
◆ snd_input_close()
| int snd_input_close |
( |
snd_input_t * | input | ) |
|
Closes an input handle.
- Parameters
-
| input | The input handle to be closed. |
- Returns
- Zero if successful, otherwise a negative error code.
◆ snd_input_getc()
| int snd_input_getc |
( |
snd_input_t * | input | ) |
|
Reads a character from an input handle (like fgetc(3)).
- Parameters
-
- Returns
- The character read, or
EOF on end of file or error.
◆ snd_input_gets()
| char * snd_input_gets |
( |
snd_input_t * | input, |
|
|
char * | str, |
|
|
size_t | size ) |
Reads a line from an input handle (like fgets(3)).
- Parameters
-
| input | The input handle. |
| str | Address of the destination buffer. |
| size | The size of the destination buffer. |
- Returns
- Pointer to the buffer if successful, otherwise
NULL.
Like fgets, the returned string is zero-terminated, and contains the new-line character '\n' if the line fits into the buffer.
◆ snd_input_scanf()
| int snd_input_scanf |
( |
snd_input_t * | input, |
|
|
const char * | format, |
|
|
| ... ) |
Reads formatted input (like fscanf(3)) from an input handle.
- Parameters
-
| input | The input handle. |
| format | Format string in fscanf format. |
| ... | Other fscanf arguments. |
- Returns
- The number of input items assigned, or
EOF.
- Bug
- Reading from a memory buffer doesn't work.
◆ snd_input_stdio_attach()
| int snd_input_stdio_attach |
( |
snd_input_t ** | inputp, |
|
|
FILE * | fp, |
|
|
int | _close ) |
Creates a new input object using an existing stdio FILE pointer.
- Parameters
-
| inputp | The function puts the pointer to the new input object at the address specified by inputp. |
| fp | The FILE pointer to read from. Reading begins at the current file position. |
| _close | Close flag. Set this to 1 if snd_input_close should close fp by calling fclose. |
- Returns
- Zero if successful, otherwise a negative error code.
◆ snd_input_stdio_open()
| int snd_input_stdio_open |
( |
snd_input_t ** | inputp, |
|
|
const char * | file, |
|
|
const char * | mode ) |
Creates a new input object reading from a file.
- Parameters
-
| inputp | The functions puts the pointer to the new input object at the address specified by inputp. |
| file | The name of the file to read from. |
| mode | The open mode, like fopen(3). |
- Returns
- Zero if successful, otherwise a negative error code.
◆ snd_input_ungetc()
| int snd_input_ungetc |
( |
snd_input_t * | input, |
|
|
int | c ) |
Puts the last character read back to an input handle (like ungetc(3)).
- Parameters
-
| input | The input handle. |
| c | The character to push back. |
- Returns
- The character pushed back, or
EOF on error.