Typedefs | |
typedef _snd_input | snd_input_t |
Internal structure for an input object. | |
typedef enum _snd_input_type | snd_input_type_t |
Enumerations | |
enum | _snd_input_type { SND_INPUT_STDIO, SND_INPUT_BUFFER } |
Functions | |
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_stdio_attach (snd_input_t **inputp, FILE *fp, int _close) |
Creates a new input object using an existing stdio FILE pointer. | |
int | snd_input_buffer_open (snd_input_t **inputp, const char *buffer, ssize_t size) |
Creates a new input object from a memory buffer. | |
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) ). |
The snd_config_load function uses such an input handle to be able to load configurations not only from standard files but also from other sources, e.g. from memory buffers.
typedef struct _snd_input snd_input_t |
Internal structure for an input object.
The ALSA library uses a pointer to this structure as a handle to an input object. Applications don't access its contents directly.
typedef enum _snd_input_type snd_input_type_t |
Input type.
enum _snd_input_type |
int snd_input_buffer_open | ( | snd_input_t ** | inputp, | |
const char * | buf, | |||
ssize_t | size | |||
) |
Creates a new input object from a memory buffer.
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. |
int snd_input_close | ( | snd_input_t * | input | ) |
Closes an input handle.
input | The input handle to be closed. |
int snd_input_getc | ( | snd_input_t * | input | ) |
Reads a character from an input handle (like fgetc(3)
).
input | The input handle. |
EOF
on end of file or error. char* snd_input_gets | ( | snd_input_t * | input, | |
char * | str, | |||
size_t | size | |||
) |
Reads a line from an input handle (like fgets(3)
).
input | The input handle. | |
str | Address of the destination buffer. | |
size | The size of the destination buffer. |
NULL
.fgets
, the returned string is zero-terminated, and contains the new-line character '\n'
if the line fits into the buffer.
int snd_input_scanf | ( | snd_input_t * | input, | |
const char * | format, | |||
... | ||||
) |
Reads formatted input (like fscanf(3)
) from an input handle.
input | The input handle. | |
format | Format string in fscanf format. | |
... | Other fscanf arguments. |
EOF
.int snd_input_stdio_attach | ( | snd_input_t ** | inputp, | |
FILE * | fp, | |||
int | _close | |||
) |
Creates a new input object using an existing stdio FILE
pointer.
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 . |
int snd_input_stdio_open | ( | snd_input_t ** | inputp, | |
const char * | file, | |||
const char * | mode | |||
) |
Creates a new input object reading from a file.
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) . |
int snd_input_ungetc | ( | snd_input_t * | input, | |
int | c | |||
) |
Puts the last character read back to an input handle (like ungetc(3)
).
input | The input handle. | |
c | The character to push back. |
EOF
on error.