Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/gf/dev_guide/img/io_open.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/gf/dev_guide/img/io_open.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/gf/dev_guide/img/io_open.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/gf/dev_guide/img/io_open.html on line 8
Initialize an IO stream
#include <img.h>
io_stream_t *io_open( io_open_f *open_f,
io_mode_t mode, ...)
- open_f
- A pointer to a function to establish a stream. There are two functions supplied by the library: IO_FD (for fd-based reading/writing) and IO_MEM (for memory buffer based reading/writing). See below.
- mode
- The open mode, either IO_READ or IO_WRITE.
- ...
- Additional parameters depending on the open_f specified, described below.
img
This function initializes a stream. The stream can be a fd-based, or a memory buffer, depending on the open_f specified:
- IO_FD
- Buffered streaming for unix-type fd's. An additional parmameter is required: an int specifying the (previously opened) fd that is ready for reading or writing.
- IO_MEM
- Streaming support for a memory buffer. Additional parameters are required (in order):
- an unsigned to specify size of the memory buffer. This must be non-zero.
- a void pointer to specify the address of the buffer.
When your application is finished with a stream, it should call io_close() to release it.
A pointer to the stream object, or NULL
if an error occurred (errno is set).
- ENOMEM
- Insufficient memory to allocate structures.
- EINVAL
- Invalid open_f or mode.
- ENOTSUP
- Mode not supported for stream.
Image library
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |
io_close()
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/gf/dev_guide/img/io_open.html on line 162
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/gf/dev_guide/img/io_open.html on line 162