Constructor
JavaScriptCoreValuenew_functionv
Declaration [src]
JSCValue*
jsc_value_new_functionv (
JSCContext* context,
const char* name,
GCallback callback,
gpointer user_data,
GDestroyNotify destroy_notify,
GType return_type,
guint n_parameters,
GType* parameter_types
)
Description [src]
Create a function in context. If name is NULL an anonymous function will be created.
When the function is called by JavaScript or jsc_value_function_call(), callback is called
receiving the function parameters and then user_data as last parameter. When the function is
cleared in context, destroy_notify is called with user_data as parameter.
Note that the value returned by callback must be fully transferred. In case of boxed types, you could use
G_TYPE_POINTER instead of the actual boxed GType to ensure that the instance owned by JSCClass is used.
If you really want to return a new copy of the boxed type, use #JSC_TYPE_VALUE and return a JSCValue created
with jsc_value_new_object() that receives the copy as instance parameter.
Parameters
context-
Type:
JSCContextA
JSCContext.The data is owned by the caller of the function. name-
Type:
const char*The function name 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. callback-
Type:
GCallbackA
GCallback. user_data-
Type:
gpointerUser data to pass to
callback.The argument can be NULL.The data is owned by the caller of the function. destroy_notify-
Type:
GDestroyNotifyDestroy notifier for
user_data.The argument can be NULL. return_type-
Type:
GTypeThe
GTypeof the function return value, orG_TYPE_NONEif the function is void. n_parameters-
Type:
guintThe number of parameters.
parameter_types-
Type: An array of
GTypeA list of
GTypes, one for each parameter, orNULL.The argument can be NULL.The length of the array is specified in the n_parametersargument.The data is owned by the caller of the function.
Return value
Type: JSCValue
A JSCValue.
| The caller of the function takes ownership of the data, and is responsible for freeing it. |