| 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 | } |