class: GVfs

[12:7] extends: object

Entry point for using GIO functionality.

Members

handleObj
lib
retainedCallbacks
signalHandlerNames
signalSetterHandlers

Methods

GVfs (Handle = null)

Creates a new Vfs by wrapping a native handle or another wrapper.
- @p Handle is the native handle or another wrapper whose handle to adopt.
toNativeHandle (Source)

Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.
- @p Source is the raw handle, raw buffer, wrapper, or null.
- @r A raw pointer carrier or null when no pointer is present.
getLib ()

Returns the opened native library for this generated wrapper.
- @r The opened native library.
handle ()

Returns the wrapped NativeHandle.
- @r The wrapped NativeHandle.
isNull ()

Returns true when the wrapped handle is null.
- @r A bool.
describe ()

Returns a small string for debugging generated wrappers.
- @r A string.
asObject ()

Wraps this handle as GObject.
- @r A GObject object.
get_file_for_path (string path)

Gets a #GFile for @path.
- @p path is a string containing a VFS path..
- @r a #GFile. Free the returned object with g_object_unref()..
get_file_for_uri (string uri)

Gets a #GFile for @uri. This operation never fails, but the returned object might not support any I/O operation if the URI is malformed or if the URI scheme is not supported.
- @p uri is a string containing a URI.
- @r a #GFile. Free the returned object with g_object_unref()..
get_supported_uri_schemes ()

Gets a list of URI schemes supported by @vfs.
- @r a %NULL-terminated array of strings. The returned array belongs to GIO and must not be freed or modified..
is_active ()

Checks if the VFS is active.
- @r %TRUE if construction of the @vfs was successful and it is now active..
parse_name (string parse_name)

This operation never fails, but the returned object might not support any I/O operations if the @parse_name cannot be parsed by the #GVfs module.
- @p parse_name is a string to be parsed by the VFS module..
- @r a #GFile for the given @parse_name. Free the returned object with g_object_unref()..
register_uri_scheme (string scheme, object uri_destroy, object parse_name_destroy)

Registers @uri_func and @parse_name_func as the #GFile URI and parse name lookup functions for URIs with a scheme matching @scheme. Note that
- @scheme is registered only within the running application, as opposed to desktop-wide as it happens with GVfs backends. When a #GFile is requested with an URI containing @scheme (e.g. through g_file_new_for_uri()),
- @uri_func will be called to allow a custom constructor. The implementation of @uri_func should not be blocking, and must not call g_vfs_register_uri_scheme() or g_vfs_unregister_uri_scheme(). When g_file_parse_name() is called with a parse name obtained from such file,
- @parse_name_func will be called to allow the #GFile to be created again. In that case, it's responsibility of @parse_name_func to make sure the parse name matches what the custom #GFile implementation returned when g_file_get_parse_name() was previously called. The implementation of
- @parse_name_func should not be blocking, and must not call g_vfs_register_uri_scheme() or g_vfs_unregister_uri_scheme(). It's an error to call this function twice with the same scheme. To unregister a custom URI scheme, use g_vfs_unregister_uri_scheme().
- @p scheme is an URI scheme, e.g. "http".
- @p uri_func is a #GVfsFileLookupFunc.
- @p uri_data is custom data passed to be passed to @uri_func, or %NULL.
- @p uri_destroy is function to be called when unregistering the URI scheme, or when @vfs is disposed, to free the resources used by the URI lookup function.
- @p parse_name_func is a #GVfsFileLookupFunc.
- @p parse_name_data is custom data passed to be passed to
- @parse_name_func, or %NULL.
- @p parse_name_destroy is function to be called when unregistering the URI scheme, or when @vfs is disposed, to free the resources used by the parse name lookup function.
- @r %TRUE if @scheme was successfully registered, or %FALSE if a handler for @scheme already exists..
unregister_uri_scheme (string scheme)

Unregisters the URI handler for @scheme previously registered with g_vfs_register_uri_scheme().
- @p scheme is an URI scheme, e.g. "http".
- @r %TRUE if @scheme was successfully unregistered, or %FALSE if a handler for @scheme does not exist..