Functions | |
__extern caca_file_t * | caca_file_open (char const *, const char *) |
Open a file for reading or writing. | |
__extern int | caca_file_close (caca_file_t *) |
Close a file handle. | |
__extern uint64_t | caca_file_tell (caca_file_t *) |
Return the position in a file handle. | |
__extern size_t | caca_file_read (caca_file_t *, void *, size_t) |
Read data from a file handle. | |
__extern size_t | caca_file_write (caca_file_t *, const void *, size_t) |
Write data to a file handle. | |
__extern char * | caca_file_gets (caca_file_t *, char *, int) |
Read a line from a file handle. | |
__extern int | caca_file_eof (caca_file_t *) |
Tell whether a file handle reached end of file. |
|
Create a caca file handle for a file. If the file is zipped, it is decompressed on the fly. If an error occurs, NULL is returned and errno is set accordingly:
|
|
Close and destroy the resources associated with a caca file handle. This function is a wrapper for fclose() or, if available, gzclose().
|
|
Return the file handle position, in bytes.
|
|
Read data from a file handle and copy them into the given buffer.
|
|
Write the contents of the given buffer to the file handle.
|
|
Read one line of data from a file handle, up to one less than the given number of bytes. A trailing zero is appended to the data.
|
|
Return the end-of-file status of the file handle. This function is a wrapper for feof() or, if available, gzeof().
|