]>
Commit | Line | Data |
---|---|---|
1 | /**************************************************************************** | |
2 | ** | |
3 | ** Copyright (C) 2016 Intel Corporation | |
4 | ** | |
5 | ** Permission is hereby granted, free of charge, to any person obtaining a copy | |
6 | ** of this software and associated documentation files (the "Software"), to deal | |
7 | ** in the Software without restriction, including without limitation the rights | |
8 | ** to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
9 | ** copies of the Software, and to permit persons to whom the Software is | |
10 | ** furnished to do so, subject to the following conditions: | |
11 | ** | |
12 | ** The above copyright notice and this permission notice shall be included in | |
13 | ** all copies or substantial portions of the Software. | |
14 | ** | |
15 | ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
16 | ** IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
17 | ** FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | |
18 | ** AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
19 | ** LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
20 | ** OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | |
21 | ** THE SOFTWARE. | |
22 | ** | |
23 | ****************************************************************************/ | |
24 | ||
25 | #ifndef _BSD_SOURCE | |
26 | #define _BSD_SOURCE 1 | |
27 | #endif | |
28 | #ifndef _DEFAULT_SOURCE | |
29 | #define _DEFAULT_SOURCE 1 | |
30 | #endif | |
31 | #ifndef __STDC_LIMIT_MACROS | |
32 | # define __STDC_LIMIT_MACROS 1 | |
33 | #endif | |
34 | ||
35 | #include "cbor.h" | |
36 | #include "compilersupport_p.h" | |
37 | #include <stdlib.h> | |
38 | ||
39 | /** | |
40 | * \fn CborError cbor_value_dup_text_string(const CborValue *value, char **buffer, size_t *buflen, CborValue *next) | |
41 | * | |
42 | * Allocates memory for the string pointed by \a value and copies it into this | |
43 | * buffer. The pointer to the buffer is stored in \a buffer and the number of | |
44 | * bytes copied is stored in \a buflen (those variables must not be NULL). | |
45 | * | |
46 | * If the iterator \a value does not point to a text string, the behaviour is | |
47 | * undefined, so checking with \ref cbor_value_get_type or \ref | |
48 | * cbor_value_is_text_string is recommended. | |
49 | * | |
50 | * If \c malloc returns a NULL pointer, this function will return error | |
51 | * condition \ref CborErrorOutOfMemory. | |
52 | * | |
53 | * On success, \c{*buffer} will contain a valid pointer that must be freed by | |
54 | * calling \c{free()}. This is the case even for zero-length strings. | |
55 | * | |
56 | * The \a next pointer, if not null, will be updated to point to the next item | |
57 | * after this string. If \a value points to the last item, then \a next will be | |
58 | * invalid. | |
59 | * | |
60 | * This function may not run in constant time (it will run in O(n) time on the | |
61 | * number of chunks). It requires constant memory (O(1)) in addition to the | |
62 | * malloc'ed block. | |
63 | * | |
64 | * \note This function does not perform UTF-8 validation on the incoming text | |
65 | * string. | |
66 | * | |
67 | * \sa cbor_value_get_text_string_chunk(), cbor_value_copy_text_string(), cbor_value_dup_byte_string() | |
68 | */ | |
69 | ||
70 | /** | |
71 | * \fn CborError cbor_value_dup_byte_string(const CborValue *value, uint8_t **buffer, size_t *buflen, CborValue *next) | |
72 | * | |
73 | * Allocates memory for the string pointed by \a value and copies it into this | |
74 | * buffer. The pointer to the buffer is stored in \a buffer and the number of | |
75 | * bytes copied is stored in \a buflen (those variables must not be NULL). | |
76 | * | |
77 | * If the iterator \a value does not point to a byte string, the behaviour is | |
78 | * undefined, so checking with \ref cbor_value_get_type or \ref | |
79 | * cbor_value_is_byte_string is recommended. | |
80 | * | |
81 | * If \c malloc returns a NULL pointer, this function will return error | |
82 | * condition \ref CborErrorOutOfMemory. | |
83 | * | |
84 | * On success, \c{*buffer} will contain a valid pointer that must be freed by | |
85 | * calling \c{free()}. This is the case even for zero-length strings. | |
86 | * | |
87 | * The \a next pointer, if not null, will be updated to point to the next item | |
88 | * after this string. If \a value points to the last item, then \a next will be | |
89 | * invalid. | |
90 | * | |
91 | * This function may not run in constant time (it will run in O(n) time on the | |
92 | * number of chunks). It requires constant memory (O(1)) in addition to the | |
93 | * malloc'ed block. | |
94 | * | |
95 | * \sa cbor_value_get_text_string_chunk(), cbor_value_copy_byte_string(), cbor_value_dup_text_string() | |
96 | */ | |
97 | CborError _cbor_value_dup_string(const CborValue *value, void **buffer, size_t *buflen, CborValue *next) | |
98 | { | |
99 | CborError err; | |
100 | cbor_assert(buffer); | |
101 | cbor_assert(buflen); | |
102 | *buflen = SIZE_MAX; | |
103 | err = _cbor_value_copy_string(value, NULL, buflen, NULL); | |
104 | if (err) | |
105 | return err; | |
106 | ||
107 | ++*buflen; | |
108 | *buffer = malloc(*buflen); | |
109 | if (!*buffer) { | |
110 | /* out of memory */ | |
111 | return CborErrorOutOfMemory; | |
112 | } | |
113 | err = _cbor_value_copy_string(value, *buffer, buflen, next); | |
114 | if (err) { | |
115 | free(*buffer); | |
116 | return err; | |
117 | } | |
118 | return CborNoError; | |
119 | } |