mirror of
https://github.com/jerryscript-project/jerryscript.git
synced 2025-12-15 16:29:21 +00:00
This modification makes it possible to initialize a context in such a way that a `void *` pointer is stored inside the context and is made available via a new `jerry_get_user_context()` API. The pointer is initialized via a new `jerry_init_with_user_context()` API, which calls the existing `jerry_init()`, after which it sets the value of the new `user_context` element in the `jerry_context_t` structure using the context allocation callback provided as the second parameter to the new `jerry_init_with_user_context()` API. The location of the cleanup function responsible for deallocating the pointer created by the context allocation callback is provided as the third parameter. This location is stored in the context along with the pointer itself. When a context is discarded via `jerry_cleanup()`, the user context cleanup function is called to dispose of the pointer stored within the context. The semantics behind the API are such that it is now possible to choose for each context an agent which manages arbitrary user data keyed to the given context. The agent must be chosen at context instantiation time and cannot be changed afterwards, remaining in effect for the lifetime of the context. Fixes #1717 JerryScript-DCO-1.0-Signed-off-by: Gabriel Schulhof gabriel.schulhof@intel.com
54 lines
1.5 KiB
C
54 lines
1.5 KiB
C
/* Copyright JS Foundation and other contributors, http://js.foundation
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#include "config.h"
|
|
#include "jerryscript.h"
|
|
#include "test-common.h"
|
|
|
|
static const char *identifying_string = "identifying string";
|
|
static bool user_context_new_was_called = false;
|
|
static bool user_context_free_was_called = false;
|
|
|
|
static void *
|
|
user_context_new (void)
|
|
{
|
|
user_context_new_was_called = true;
|
|
return (void *) identifying_string;
|
|
} /* user_context_new */
|
|
|
|
static void
|
|
user_context_free (void *user_context_p)
|
|
{
|
|
user_context_free_was_called = true;
|
|
TEST_ASSERT (((const char *) user_context_p) == identifying_string);
|
|
} /* user_context_free */
|
|
|
|
int
|
|
main (void)
|
|
{
|
|
TEST_INIT ();
|
|
|
|
jerry_init_with_user_context (JERRY_INIT_EMPTY, user_context_new, user_context_free);
|
|
|
|
TEST_ASSERT ((((const char *)(jerry_get_user_context ()))) == identifying_string);
|
|
|
|
jerry_cleanup ();
|
|
|
|
TEST_ASSERT (user_context_new_was_called);
|
|
TEST_ASSERT (user_context_free_was_called);
|
|
|
|
return 0;
|
|
} /* main */
|