|
|
|
GIO Reference Manual | |
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | ||||
#include <gio/gio.h>
GFileInputStream;
GFileInfo * g_file_input_stream_query_info (GFileInputStream *stream,
const char *attributes,
GCancellable *cancellable,
GError **error);
void g_file_input_stream_query_info_async
(GFileInputStream *stream,
const char *attributes,
int io_priority,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
GFileInfo * g_file_input_stream_query_info_finish
(GFileInputStream *stream,
GAsyncResult *result,
GError **error);
GFileInputStream provides input streams that take their content from a file.
GFileInputStream implements GSeekable, which allows the input
stream to jump to arbitrary positions in the file, provided the
filesystem of the file allows it. In addition to the generic
g_seekable_ API, GFileInputStream has its own API for seeking
and positioning. To find the position of a file input stream,
use g_file_input_stream_tell(). To find out if a file input
stream supports seeking, use g_file_input_stream_can_seek().
To position a file input stream, use g_file_input_stream_seek().
typedef struct _GFileInputStream GFileInputStream;
A subclass of GInputStream for opened files. This adds a few file-specific operations and seeking.
GFileInputStream implements GSeekable.
GFileInfo * g_file_input_stream_query_info (GFileInputStream *stream, const char *attributes, GCancellable *cancellable, GError **error);
Queries a file input stream the given attributes. This function blocks
while querying the stream. For the asynchronous (non-blocking) version
of this function, see g_file_input_stream_query_info_async(). While the
stream is blocked, the stream will set the pending flag internally, and
any other operations on the stream will fail with G_IO_ERROR_PENDING.
|
a GFileInputStream. |
|
a file attribute query string. |
|
optional GCancellable object, NULL to ignore.
|
|
a GError location to store the error occuring, or NULL to
ignore.
|
Returns : |
a GFileInfo, or NULL on error.
|
void g_file_input_stream_query_info_async
(GFileInputStream *stream,
const char *attributes,
int io_priority,
GCancellable *cancellable,
GAsyncReadyCallback callback,
gpointer user_data);
Queries the stream information asynchronously.
When the operation is finished callback will be called.
You can then call g_file_input_stream_query_info_finish()
to get the result of the operation.
For the synchronous version of this function,
see g_file_input_stream_query_info().
If cancellable is not NULL, then the operation can be cancelled by
triggering the cancellable object from another thread. If the operation
was cancelled, the error G_IO_ERROR_CANCELLED will be set
|
a GFileInputStream. |
|
a file attribute query string. |
|
the I/O priority of the request. |
|
optional GCancellable object, NULL to ignore.
|
|
callback to call when the request is satisfied |
|
the data to pass to callback function |
GFileInfo * g_file_input_stream_query_info_finish (GFileInputStream *stream, GAsyncResult *result, GError **error);
Finishes an asynchronous info query operation.
|
a GFileInputStream. |
|
a GAsyncResult. |
|
a GError location to store the error occuring,
or NULL to ignore.
|
Returns : |
GFileInfo. |