Declaration [src]

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


context JSCContext

A JSCContext.

 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 user_data.

 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 JSCValue, or NULL in case of exception.

 The caller of the function takes ownership of the data, and is responsible for freeing it.
 The return value can be NULL.