Memory Management Hooks

Custom memory management function hooks. More...

Typedefs
typedef void *(*	mjrpc_malloc_func) (size_t size)
	Function pointer type for custom memory allocation.
typedef void(*	mjrpc_free_func) (void *ptr)
	Function pointer type for custom memory deallocation.
typedef char *(*	mjrpc_strdup_func) (const char *str)
	Function pointer type for custom string duplication.
typedef void(*	mjrpc_error_log_func) (const char *message, int error_code)
	Function pointer type for error logging callback.

Functions
int	mjrpc_set_memory_hooks (mjrpc_malloc_func malloc_func, mjrpc_free_func free_func, mjrpc_strdup_func strdup_func)
	Set custom memory management functions.
int	mjrpc_set_error_log_hook (mjrpc_error_log_func error_log_func)
	Set custom error logging function.

Detailed Description

Custom memory management function hooks.

Typedef Documentation

mjrpc_error_log_func

mjrpc_error_log_func

Function pointer type for error logging callback.

Parameters

message	Error message string
error_code	Optional error code (0 if not applicable)

Note

Can be used to integrate with application logging systems

Definition at line 238 of file mjsonrpc.h.

mjrpc_free_func

mjrpc_free_func

Function pointer type for custom memory deallocation.

Parameters

ptr	Pointer to memory to free (can be NULL)

Note

Should behave like standard free() function

Definition at line 216 of file mjsonrpc.h.

mjrpc_malloc_func

mjrpc_malloc_func

Function pointer type for custom memory allocation.

Parameters

size	Number of bytes to allocate

Returns

Pointer to allocated memory, or NULL on failure

Note

Should behave like standard malloc() function

Definition at line 206 of file mjsonrpc.h.

mjrpc_strdup_func

mjrpc_strdup_func

Function pointer type for custom string duplication.

Parameters

str	String to duplicate

Returns

Pointer to newly allocated duplicate string, or NULL on failure

Note

Should behave like standard strdup() function

Definition at line 227 of file mjsonrpc.h.

Function Documentation

mjrpc_set_error_log_hook()

int mjrpc_set_error_log_hook

(

mjrpc_error_log_func

error_log_func

)

Set custom error logging function.

This function allows users to set a callback function that will be called when errors occur within the mjsonrpc library. This enables integration with application logging systems for debugging and monitoring.

Parameters

error_log_func

Custom error logging callback function

Note

Pass NULL to disable error logging (default behavior)

The callback will be invoked for critical errors such as:

• Memory allocation failures
• Hash table resize issues
• Method rehash failures

Example:

void my_error_logger(const char *msg, int code) {
    fprintf(stderr, "[MJSONRPC ERROR] %s (code: %d)\n", msg, code);
}
 
// Enable error logging
mjrpc_set_error_log_hook(my_error_logger);
 
// Disable error logging
mjrpc_set_error_log_hook(NULL);

mjrpc_set_memory_hooks()

int mjrpc_set_memory_hooks	(	mjrpc_malloc_func	malloc_func,
		mjrpc_free_func	free_func,
		mjrpc_strdup_func	strdup_func
	)

Set custom memory management functions.

This function allows users to override the default memory management functions used by the mjsonrpc library. All parameters must be provided together, or pass NULL for all to reset to default standard library functions.

Parameters

malloc_func	Custom malloc function (required if not resetting)
free_func	Custom free function (required if not resetting)
strdup_func	Custom strdup function (required if not resetting)

Returns

MJRPC_RET_OK on success, MJRPC_RET_ERROR_INVALID_PARAM on invalid parameters

Note

Call this function before creating any mjrpc_handle or processing requests

To reset to default functions, pass NULL for all parameters

These hooks only affect memory allocations made by mjsonrpc internally (handle, method names, error messages). They do NOT affect cJSON's own allocations. Strings returned by mjrpc_process_str() are allocated by cJSON (via cJSON_PrintUnformatted) and must be freed with standard free().

Example:

// Set custom memory functions
mjrpc_set_memory_hooks(my_malloc, my_free, my_strdup);
 
// Reset to default functions
mjrpc_set_memory_hooks(NULL, NULL, NULL);