blob: d8b5f53b9e2a2c322d576014c1153d960a1a8932 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
/*
* Copyright (c) 2014-2020 Pavel Kalvoda <[email protected]>
*
* libcbor is free software; you can redistribute it and/or modify
* it under the terms of the MIT license. See LICENSE for details.
*/
#ifndef LIBCBOR_MAPS_H
#define LIBCBOR_MAPS_H
#include "cbor/cbor_export.h"
#include "cbor/common.h"
#ifdef __cplusplus
extern "C" {
#endif
/*
* ============================================================================
* Map manipulation
* ============================================================================
*/
/** Get the number of pairs
*
* @param item A map
* @return The number of pairs
*/
_CBOR_NODISCARD CBOR_EXPORT size_t cbor_map_size(const cbor_item_t* item);
/** Get the size of the allocated storage
*
* @param item A map
* @return Allocated storage size (as the number of #cbor_pair items)
*/
_CBOR_NODISCARD CBOR_EXPORT size_t cbor_map_allocated(const cbor_item_t* item);
/** Create a new definite map
*
* @param size The number of slots to preallocate
* @return Reference to the new map item. The item's reference count is
* initialized to one.
* @return `NULL` if memory allocation fails
*/
_CBOR_NODISCARD CBOR_EXPORT cbor_item_t* cbor_new_definite_map(size_t size);
/** Create a new indefinite map
*
* @return Reference to the new map item. The item's reference count is
* initialized to one.
* @return `NULL` if memory allocation fails
*/
_CBOR_NODISCARD CBOR_EXPORT cbor_item_t* cbor_new_indefinite_map(void);
/** Add a pair to the map
*
* For definite maps, items can only be added to the preallocated space. For
* indefinite maps, the storage will be expanded as needed
*
* @param item A map
* @param pair The key-value pair to add. Reference count of the #cbor_pair.key
* and #cbor_pair.value will be increased by one.
* @return `true` on success, `false` if memory allocation failed (indefinite
* maps) or the preallocated storage is full (definite maps)
*/
_CBOR_NODISCARD CBOR_EXPORT bool cbor_map_add(cbor_item_t* item,
struct cbor_pair pair);
/** Add a key to the map
*
* Sets the value to `NULL`. Internal API.
*
* @param item A map
* @param key The key, Its reference count will be be increased by one.
* @return `true` on success, `false` if either reallocation failed or the
* preallocated storage is full
*/
_CBOR_NODISCARD CBOR_EXPORT bool _cbor_map_add_key(cbor_item_t* item,
cbor_item_t* key);
/** Add a value to the map
*
* Assumes that #_cbor_map_add_key has been called. Internal API.
*
* @param item A map
* @param value The value. Its reference count will be be increased by one.
* @return `true` on success, `false` if either reallocation failed or the
* preallocated storage is full
*/
_CBOR_NODISCARD CBOR_EXPORT bool _cbor_map_add_value(cbor_item_t* item,
cbor_item_t* value);
/** Is this map definite?
*
* @param item A map
* @return Is this map definite?
*/
_CBOR_NODISCARD CBOR_EXPORT bool cbor_map_is_definite(const cbor_item_t* item);
/** Is this map indefinite?
*
* @param item A map
* @return Is this map indefinite?
*/
_CBOR_NODISCARD CBOR_EXPORT bool cbor_map_is_indefinite(
const cbor_item_t* item);
/** Get the pairs storage
*
* @param item A map
* @return Array of #cbor_map_size pairs. Manipulation is possible as long as
* references remain valid.
*/
_CBOR_NODISCARD CBOR_EXPORT struct cbor_pair* cbor_map_handle(
const cbor_item_t* item);
#ifdef __cplusplus
}
#endif
#endif // LIBCBOR_MAPS_H
|
