Constructor
JavaScriptCoreValuenew_array_buffer
Declaration [src]
JSCValue*
jsc_value_new_array_buffer (
JSCContext* context,
gpointer data,
gsize size,
GDestroyNotify destroy_notify,
gpointer user_data
)
Description [src]
Creates a new %ArrayBuffer from existing data in memory.
The data is not copied: while this allows sharing data with JavaScript
efficiently, the caller must ensure that the memory region remains valid
until the newly created object is released by JSC.
Optionally, a destroy_notify callback can be provided, which will be
invoked with user_data as parameter when the %ArrayBuffer object is
released. This is intended to be used for freeing resources related to
the memory region which contains the data:
|[!<— language=”C” —> GMappedFile f = g_mapped_file_new (file_path, TRUE, NULL); JSCValue value = jsc_value_new_array_buffer (context, g_mapped_file_get_contents (f), g_mapped_file_get_length (f), (GDestroyNotify) g_mapped_file_unref, f); ]|
Note that the user_data can be the same value as data:
|[!<— language=”C” —> void bytes = g_malloc0 (100); JSCValue value = jsc_value_new_array_buffer (context, bytes, 100, g_free, bytes); ]|
| Available since: | 2.38 |
Parameters
context |
JSCContext |
A |
|
| The data is owned by the caller of the function. | |
data |
gpointer |
Pointer to a region of memory. |
|
The argument can be NULL. | |
| The data is owned by the caller of the function. | |
size |
gsize |
Size in bytes of the memory region. |
|
destroy_notify |
GDestroyNotify |
Destroy notifier for |
|
The argument can be NULL. | |
user_data |
gpointer |
User data. |
|
The argument can be NULL. | |
| The data is owned by the caller of the function. |
Return value
| Returns: | JSCValue |
A |
|
| The caller of the function takes ownership of the data, and is responsible for freeing it. | |
The return value can be NULL. |