|
|
|
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. To find the position of a file
input stream, use g_seekable_tell(). To find out if a file input
stream supports seeking, use g_seekable_stream_can_seek().
To position a file input stream, use g_seekable_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. [allow-none]
|
|
a GError location to store the error occuring, or NULL to
ignore. |
Returns : |
a GFileInfo, or NULL on error. [transfer full]
|
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. [allow-none]
|
|
callback to call when the request is satisfied. [scope async] |
|
the data to pass to callback function. [closure] |
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. [transfer full] |