#include <stdlib.h>
#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>
#include <assert.h>
#include "data.h"
#include "cbor/configuration.h"

Macros
#define	CBOR_RESTRICT_POINTER CBOR_RESTRICT_SPECIFIER

#define	CBOR_VERSION TO_STR(CBOR_MAJOR_VERSION) "." TO_STR(CBOR_MINOR_VERSION) "." TO_STR(CBOR_PATCH_VERSION)

#define	CBOR_HEX_VERSION ((CBOR_MAJOR_VERSION << 16) \| (CBOR_MINOR_VERSION << 8) \| CBOR_PATCH_VERSION)

#define	debug_print(fmt, ...) do {} while (0)

#define	TO_STR_(x) #x

#define	TO_STR(x) TO_STR_(x) /* enables proper double expansion */

#define	_CBOR_MALLOC _cbor_malloc

#define	_CBOR_REALLOC _cbor_realloc

#define	_CBOR_FREE _cbor_free

Typedefs
typedef void (	_cbor_malloc_t) (size_t)

typedef void (	_cbor_realloc_t) (void *, size_t)

typedef void(*	_cbor_free_t) (void *)

Functions
void	cbor_set_allocs (_cbor_malloc_t custom_malloc, _cbor_realloc_t custom_realloc, _cbor_free_t custom_free)
	Sets the memory management routines to use. More...

cbor_type	cbor_typeof (const cbor_item_t *item)
	Get the type of the item. More...

bool	cbor_isa_uint (const cbor_item_t *item)
	Does the item have the appropriate major type? More...

bool	cbor_isa_negint (const cbor_item_t *item)
	Does the item have the appropriate major type? More...

bool	cbor_isa_bytestring (const cbor_item_t *item)
	Does the item have the appropriate major type? More...

bool	cbor_isa_string (const cbor_item_t *item)
	Does the item have the appropriate major type? More...

bool	cbor_isa_array (const cbor_item_t *item)
	Does the item have the appropriate major type? More...

bool	cbor_isa_map (const cbor_item_t *item)
	Does the item have the appropriate major type? More...

bool	cbor_isa_tag (const cbor_item_t *item)
	Does the item have the appropriate major type? More...

bool	cbor_isa_float_ctrl (const cbor_item_t *item)
	Does the item have the appropriate major type? More...

bool	cbor_is_int (const cbor_item_t *item)
	Is the item an integer, either positive or negative? More...

bool	cbor_is_float (const cbor_item_t *item)
	Is the item an a floating point number? More...

bool	cbor_is_bool (const cbor_item_t *item)
	Is the item an a boolean? More...

bool	cbor_is_null (const cbor_item_t *item)
	Does this item represent `null` More...

bool	cbor_is_undef (const cbor_item_t *item)
	Does this item represent `undefined` More...

cbor_item_t *	cbor_incref (cbor_item_t *item)
	Increases the reference count by one. More...

void	cbor_decref (cbor_item_t **item)
	Decreases the reference count by one, deallocating the item if needed. More...

void	cbor_intermediate_decref (cbor_item_t *item)
	Decreases the reference count by one, deallocating the item if needed. More...

size_t	cbor_refcount (const cbor_item_t *item)
	Get the reference count. More...

cbor_item_t *	cbor_move (cbor_item_t *item)
	Provides CPP-like move construct. More...

Variables
_cbor_malloc_t	_cbor_malloc

_cbor_realloc_t	_cbor_realloc

_cbor_free_t	_cbor_free

Macro Definition Documentation

§ _CBOR_FREE

#define _CBOR_FREE _cbor_free

Definition at line 86 of file common.h.

§ _CBOR_MALLOC

#define _CBOR_MALLOC _cbor_malloc

Definition at line 84 of file common.h.

§ _CBOR_REALLOC

#define _CBOR_REALLOC _cbor_realloc

Definition at line 85 of file common.h.

§ CBOR_HEX_VERSION

#define CBOR_HEX_VERSION ((CBOR_MAJOR_VERSION << 16) | (CBOR_MINOR_VERSION << 8) | CBOR_PATCH_VERSION)

Definition at line 42 of file common.h.

§ CBOR_RESTRICT_POINTER

#define CBOR_RESTRICT_POINTER CBOR_RESTRICT_SPECIFIER

Definition at line 33 of file common.h.

§ CBOR_VERSION

#define CBOR_VERSION TO_STR(CBOR_MAJOR_VERSION) "." TO_STR(CBOR_MINOR_VERSION) "." TO_STR(CBOR_PATCH_VERSION)

Definition at line 41 of file common.h.

§ debug_print

#define debug_print	(	fmt,
		...
	)	do {} while (0)

Definition at line 53 of file common.h.

§ TO_STR

#define TO_STR ( x ) TO_STR_(x) /* enables proper double expansion */

Definition at line 57 of file common.h.

§ TO_STR_

#define TO_STR_ ( x ) #x

Definition at line 56 of file common.h.

Typedef Documentation

§ _cbor_free_t

typedef void(* _cbor_free_t) (void *)

Definition at line 63 of file common.h.

§ _cbor_malloc_t

typedef void*(* _cbor_malloc_t) (size_t)

Definition at line 61 of file common.h.

§ _cbor_realloc_t

typedef void*(* _cbor_realloc_t) (void *, size_t)

Definition at line 62 of file common.h.

Function Documentation

§ cbor_decref()

void cbor_decref ( cbor_item_t ** item )

Decreases the reference count by one, deallocating the item if needed.

In case the item is deallocated, the reference count of any dependent items is adjusted accordingly in a recursive manner.

Parameters

item[take] the item. Set to NULL if deallocated

Definition at line 99 of file common.c.

§ cbor_incref()

cbor_item_t* cbor_incref ( cbor_item_t * item )

Increases the reference count by one.

No dependent items are affected.

Parameters

item[incref] item the item

Returns: the input reference

Definition at line 93 of file common.c.

§ cbor_intermediate_decref()

void cbor_intermediate_decref ( cbor_item_t * item )

Decreases the reference count by one, deallocating the item if needed.

Convenience wrapper for cbor_decref when its set-to-null behavior is not needed

Parameters

item[take] the item

Definition at line 174 of file common.c.

§ cbor_is_bool()

bool cbor_is_bool ( const cbor_item_t * item )

Is the item an a boolean?

Parameters

item[borrow] the item

Returns: Is the item a boolean?

Definition at line 71 of file common.c.

§ cbor_is_float()

bool cbor_is_float ( const cbor_item_t * item )

Is the item an a floating point number?

Parameters

item[borrow] the item

Returns: Is the item a floating point number?

Definition at line 87 of file common.c.

§ cbor_is_int()

bool cbor_is_int ( const cbor_item_t * item )

Is the item an integer, either positive or negative?

Parameters

item[borrow] the item

Returns: Is the item an integer, either positive or negative?

Definition at line 65 of file common.c.

§ cbor_is_null()

bool cbor_is_null ( const cbor_item_t * item )

Does this item represent null

embed:rst:leading-asterisk
* .. warning:: This is in no way related to the value of the pointer. Passing a null pointer will most likely result in a crash.
*

Parameters

item[borrow] the item

Returns: Is the item (CBOR logical) null?

Definition at line 77 of file common.c.

§ cbor_is_undef()

bool cbor_is_undef ( const cbor_item_t * item )

Does this item represent undefined

embed:rst:leading-asterisk
* .. warning:: Care must be taken to distinguish nulls and undefined values in C.
*

Parameters

item[borrow] the item

Returns: Is the item (CBOR logical) undefined?

Definition at line 82 of file common.c.

§ cbor_isa_array()

bool cbor_isa_array ( const cbor_item_t * item )

Does the item have the appropriate major type?

Parameters

item[borrow] the item

Returns: Is the item an CBOR_TYPE_ARRAY?

Definition at line 38 of file common.c.

§ cbor_isa_bytestring()

bool cbor_isa_bytestring ( const cbor_item_t * item )

Does the item have the appropriate major type?

Parameters

item[borrow] the item

Returns: Is the item a CBOR_TYPE_BYTESTRING?

Definition at line 28 of file common.c.

§ cbor_isa_float_ctrl()

bool cbor_isa_float_ctrl ( const cbor_item_t * item )

Does the item have the appropriate major type?

Parameters

item[borrow] the item

Returns: Is the item a CBOR_TYPE_FLOAT_CTRL?

Definition at line 53 of file common.c.

§ cbor_isa_map()

bool cbor_isa_map ( const cbor_item_t * item )

Does the item have the appropriate major type?

Parameters

item[borrow] the item

Returns: Is the item a CBOR_TYPE_MAP?

Definition at line 43 of file common.c.

§ cbor_isa_negint()

bool cbor_isa_negint ( const cbor_item_t * item )

Does the item have the appropriate major type?

Parameters

item[borrow] the item

Returns: Is the item a CBOR_TYPE_NEGINT?

Definition at line 23 of file common.c.

§ cbor_isa_string()

bool cbor_isa_string ( const cbor_item_t * item )

Does the item have the appropriate major type?

Parameters

item[borrow] the item

Returns: Is the item a CBOR_TYPE_STRING?

Definition at line 33 of file common.c.

§ cbor_isa_tag()

bool cbor_isa_tag ( const cbor_item_t * item )

Does the item have the appropriate major type?

Parameters

item[borrow] the item

Returns: Is the item a CBOR_TYPE_TAG?

Definition at line 48 of file common.c.

§ cbor_isa_uint()

bool cbor_isa_uint ( const cbor_item_t * item )

Does the item have the appropriate major type?

Parameters

item[borrow] the item

Returns: Is the item an CBOR_TYPE_UINT?

Definition at line 18 of file common.c.

§ cbor_move()

cbor_item_t* cbor_move ( cbor_item_t * item )

Provides CPP-like move construct.

Decreases the reference count by one, but does not deallocate the item even if its refcount reaches zero. This is useful for passing intermediate values to functions that increase reference count. Should only be used with functions that incref their arguments.

embed:rst:leading-asterisk
* .. warning:: If the item is moved without correctly increasing the reference count afterwards, the memory will be leaked.
*

Parameters

item[take] the item

Returns: the item with reference count decreased by one

Definition at line 184 of file common.c.

§ cbor_refcount()

size_t cbor_refcount ( const cbor_item_t * item )

Get the reference count.

embed:rst:leading-asterisk
* .. warning:: This does *not* account for transitive references.
*

Parameters

item[borrow] the item

Returns: the reference count

Definition at line 179 of file common.c.

§ cbor_set_allocs()

void cbor_set_allocs	(	_cbor_malloc_t	custom_malloc,
		_cbor_realloc_t	custom_realloc,
		_cbor_free_t	custom_free
	)

Sets the memory management routines to use.

Only available when CBOR_CUSTOM_ALLOC is truthy

embed:rst:leading-asterisk
* .. warning:: This function modifies the global state and should therefore be used accordingly. Changing the memory handlers while allocated items exist will result in a ``free``/``malloc`` mismatch. This function is not thread safe with respect to both itself and all the other *libcbor* functions that work with the heap.
* .. note:: `realloc` implementation must correctly support `NULL` reallocation
*

Parameters

custom_malloc	malloc implementation
custom_realloc	realloc implementation
custom_free	free implementation

Definition at line 14 of file allocators.c.

§ cbor_typeof()

cbor_type cbor_typeof ( const cbor_item_t * item )

Get the type of the item.

Parameters

item[borrow]

Returns: The type

Definition at line 59 of file common.c.

Variable Documentation

§ _cbor_free

_cbor_free_t _cbor_free

Definition at line 12 of file allocators.c.

§ _cbor_malloc

_cbor_malloc_t _cbor_malloc

Definition at line 10 of file allocators.c.

§ _cbor_realloc

_cbor_realloc_t _cbor_realloc

Definition at line 11 of file allocators.c.

Macros

Typedefs

Functions

Variables

Macro Definition Documentation

§ _CBOR_FREE

§ _CBOR_MALLOC

§ _CBOR_REALLOC

§ CBOR_HEX_VERSION

§ CBOR_RESTRICT_POINTER

§ CBOR_VERSION

§ debug_print

§ TO_STR

§ TO_STR_

Typedef Documentation

§ _cbor_free_t

§ _cbor_malloc_t

§ _cbor_realloc_t

Function Documentation

§ cbor_decref()

§ cbor_incref()

§ cbor_intermediate_decref()

§ cbor_is_bool()

§ cbor_is_float()

§ cbor_is_int()

§ cbor_is_null()

§ cbor_is_undef()

§ cbor_isa_array()

§ cbor_isa_bytestring()

§ cbor_isa_float_ctrl()

§ cbor_isa_map()

§ cbor_isa_negint()

§ cbor_isa_string()

§ cbor_isa_tag()

§ cbor_isa_uint()

§ cbor_move()

§ cbor_refcount()

§ cbor_set_allocs()

§ cbor_typeof()

Variable Documentation

§ _cbor_free

§ _cbor_malloc

§ _cbor_realloc