Function
HexBufferutil_new
Description
Utility function to create an on object which implements the HexBuffer interface.
The plugin parameter will be the unique part of the plugin file name (eg,
if the file name is libhex-buffer-mmap.so, you would specify “mmap”). If
NULL is passed, the fallback (presently the “malloc” backend, but this is
an implementation detail and may be subject to change) will be used.
The file parameter is a valid GFile if you would like the buffer
pre-loaded, or NULL for an empty buffer.
Parameters
plugin-
Type:
const char*The name of the plugin, or
NULL.The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. file-
Type:
GFileFile to initialize the buffer with, or
NULL.The argument can be NULL.The data is owned by the caller of the function.
Return value
Type: HexBuffer
A pointer to a valid implementation of a
HexBuffer interface, pre-cast as type HexBuffer, or NULL if
the operation failed. Starting with 4.2, if a specific backend is requested,
and the system supports plugins as a whole but cannot load that specified plugin, NULL will be returned as though the operation failed, so as to
customize the fallback scheme programmatically.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |