> The <cbor.h> is the main header in TinyCBOR and defines the constants used by most functions as well as the structures for encoding (CborEncoder) and decoding (CborValue). │ │ │ +
> The <cborjson.h> file contains the routines that are used to convert a CBOR data stream into JSON. │ │ │ More...
│ │ │ -#include <assert.h>#include <limits.h>#include <stddef.h>#include <stdint.h>#include <string.h>#include <stdio.h>#include "tinycbor-export.h"#include "tinycbor-version.h"#include <stdbool.h>#include "cbor.h"Go to the source code of this file.
│ │ ││ │ │ -Data Structures | |
| struct | CborEncoder |
| Structure used to encode to CBOR. More... | |
| struct | CborValue |
| This type contains one value parsed from the CBOR stream. More... | |
│ │ │ -Typedefs | |
| typedef uint64_t | CborTag |
| This typedef is an unsigned 64-bit integer. | |
│ │ │ Functions | |
| │ │ │ -CBOR_API const char * | cbor_error_string (CborError error) |
| Returns the error string corresponding to the CBOR error condition error. | |
| CBOR_API void | cbor_encoder_init (CborEncoder *encoder, uint8_t *buffer, size_t size, int flags) |
| Initializes a CborEncoder structure encoder by pointing it to buffer buffer of size size. | |
| CBOR_API CborError | cbor_encode_uint (CborEncoder *encoder, uint64_t value) |
| Appends the unsigned 64-bit integer value to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encode_int (CborEncoder *encoder, int64_t value) |
| Appends the signed 64-bit integer value to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encode_negative_int (CborEncoder *encoder, uint64_t absolute_value) |
| Appends the negative 64-bit integer whose absolute value is absolute_value to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encode_simple_value (CborEncoder *encoder, uint8_t value) |
| Appends the CBOR Simple Type of value value to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encode_tag (CborEncoder *encoder, CborTag tag) |
| Appends the CBOR tag tag to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encode_text_string (CborEncoder *encoder, const char *string, size_t length) |
| Appends the text string string of length length to the CBOR stream provided by encoder. | |
| CborError | cbor_encode_text_stringz (CborEncoder *encoder, const char *string) |
| Appends the null-terminated text string string to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encode_byte_string (CborEncoder *encoder, const uint8_t *string, size_t length) |
| Appends the byte string string of length length to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encode_floating_point (CborEncoder *encoder, CborType fpType, const void *value) |
| Appends the floating-point value of type fpType and pointed to by value to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encode_raw (CborEncoder *encoder, const uint8_t *raw, size_t length) |
| Puts the data of length length in raw into to the encoding buffer of encoder. | |
| │ │ │ -CborError | cbor_encode_boolean (CborEncoder *encoder, bool value) |
| Appends the boolean value value to the CBOR stream provided by encoder. | |
| CborError | cbor_encode_null (CborEncoder *encoder) |
| Appends the CBOR type representing a null value to the CBOR stream provided by encoder. | |
| CborError | cbor_encode_undefined (CborEncoder *encoder) |
| Appends the CBOR type representing an undefined value to the CBOR stream provided by encoder. | |
| CborError | cbor_encode_half_float (CborEncoder *encoder, const void *value) |
| Appends the IEEE 754 half-precision (16-bit) floating point value pointed to by value to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encode_float_as_half_float (CborEncoder *encoder, float value) |
| Convert the IEEE 754 single-precision (32-bit) floating point value value to the IEEE 754 half-precision (16-bit) floating point value and append it to the CBOR stream provided by encoder. | |
| CborError | cbor_encode_float (CborEncoder *encoder, float value) |
| Appends the IEEE 754 single-precision (32-bit) floating point value value to the CBOR stream provided by encoder. | |
| CborError | cbor_encode_double (CborEncoder *encoder, double value) |
| Appends the IEEE 754 double-precision (64-bit) floating point value value to the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encoder_create_array (CborEncoder *parentEncoder, CborEncoder *arrayEncoder, size_t length) |
| Creates a CBOR array in the CBOR stream provided by parentEncoder and initializes arrayEncoder so that items can be added to the array using the CborEncoder functions. | |
| CBOR_API CborError | cbor_encoder_create_map (CborEncoder *parentEncoder, CborEncoder *mapEncoder, size_t length) |
| Creates a CBOR map in the CBOR stream provided by parentEncoder and initializes mapEncoder so that items can be added to the map using the CborEncoder functions. | |
| CBOR_API CborError | cbor_encoder_close_container (CborEncoder *parentEncoder, const CborEncoder *containerEncoder) |
| Closes the CBOR container (array or map) provided by containerEncoder and updates the CBOR stream provided by encoder. | |
| CBOR_API CborError | cbor_encoder_close_container_checked (CborEncoder *parentEncoder, const CborEncoder *containerEncoder) |
| size_t | cbor_encoder_get_buffer_size (const CborEncoder *encoder, const uint8_t *buffer) |
| Returns the total size of the buffer starting at buffer after the encoding finished without errors. | |
| size_t | cbor_encoder_get_extra_bytes_needed (const CborEncoder *encoder) |
| Returns how many more bytes the original buffer supplied to cbor_encoder_init() needs to be extended by so that no CborErrorOutOfMemory condition will happen for the encoding. | |
| CBOR_API CborError | cbor_parser_init (const uint8_t *buffer, size_t size, uint32_t flags, CborParser *parser, CborValue *it) |
| Initializes the CBOR parser for parsing size bytes beginning at buffer. | |
| CBOR_API CborError | cbor_value_validate_basic (const CborValue *it) |
| Performs a basic validation of the CBOR stream pointed by it and returns the error it found. | |
| bool | cbor_value_at_end (const CborValue *it) |
| Returns true if it has reached the end of the iteration, usually when advancing after the last item in an array or map. | |
| const uint8_t * | cbor_value_get_next_byte (const CborValue *it) |
| Returns a pointer to the next byte that would be decoded if this CborValue object were advanced. | |
| CBOR_API CborError | cbor_value_advance_fixed (CborValue *it) |
| Advances the CBOR value it by one fixed-size position. | |
| CBOR_API CborError | cbor_value_advance (CborValue *it) |
| Advances the CBOR value it by one element, skipping over containers. | |
| │ │ │ -bool | cbor_value_is_container (const CborValue *it) |
| Returns true if the it value is a container and requires recursion in order to decode (maps and arrays), false otherwise. | |
| CBOR_API CborError | cbor_value_enter_container (const CborValue *it, CborValue *recursed) |
| Creates a CborValue iterator pointing to the first element of the container represented by it and saves it in recursed. | |
| CBOR_API CborError | cbor_value_leave_container (CborValue *it, const CborValue *recursed) |
| Updates it to point to the next element after the container. | |
| bool | cbor_value_is_valid (const CborValue *value) |
| Returns true if the iterator it contains a valid value. | |
| CborType | cbor_value_get_type (const CborValue *value) |
| Returns the type of the CBOR value that the iterator value points to. | |
| bool | cbor_value_is_null (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR null type. | |
| bool | cbor_value_is_undefined (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR undefined type. | |
| bool | cbor_value_is_boolean (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR boolean type (true or false). | |
| CborError | cbor_value_get_boolean (const CborValue *value, bool *result) |
| Retrieves the boolean value that value points to and stores it in result. | |
| bool | cbor_value_is_simple_type (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR Simple Type type (other than true, false, null and undefined). | |
| CborError | cbor_value_get_simple_type (const CborValue *value, uint8_t *result) |
| Retrieves the CBOR Simple Type value that value points to and stores it in result. | |
| bool | cbor_value_is_integer (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR integer type. | |
| bool | cbor_value_is_unsigned_integer (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR unsigned integer type (positive values or zero). | |
| bool | cbor_value_is_negative_integer (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR negative integer type. | |
| CborError | cbor_value_get_raw_integer (const CborValue *value, uint64_t *result) |
| Retrieves the CBOR integer value that value points to and stores it in result. | |
| CborError | cbor_value_get_uint64 (const CborValue *value, uint64_t *result) |
| Retrieves the CBOR integer value that value points to and stores it in result. | |
| CborError | cbor_value_get_int64 (const CborValue *value, int64_t *result) |
| Retrieves the CBOR integer value that value points to and stores it in result. | |
| CborError | cbor_value_get_int (const CborValue *value, int *result) |
| Retrieves the CBOR integer value that value points to and stores it in result. | |
| CBOR_API CborError | cbor_value_get_int64_checked (const CborValue *value, int64_t *result) |
| Retrieves the CBOR integer value that value points to and stores it in result. | |
| CBOR_API CborError | cbor_value_get_int_checked (const CborValue *value, int *result) |
| Retrieves the CBOR integer value that value points to and stores it in result. | |
| bool | cbor_value_is_length_known (const CborValue *value) |
| Returns true if the length of this type is known without calculation. | |
| bool | cbor_value_is_tag (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR tag. | |
| CborError | cbor_value_get_tag (const CborValue *value, CborTag *result) |
| Retrieves the CBOR tag value that value points to and stores it in result. | |
| CBOR_API CborError | cbor_value_skip_tag (CborValue *it) |
| Advances the CBOR value it until it no longer points to a tag. | |
| bool | cbor_value_is_byte_string (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR byte string. | |
| bool | cbor_value_is_text_string (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR text string. | |
| CborError | cbor_value_get_string_length (const CborValue *value, size_t *length) |
| Extracts the length of the byte or text string that value points to and stores it in result. | |
| CBOR_API CborError | cbor_value_calculate_string_length (const CborValue *value, size_t *length) |
| Calculates the length of the byte or text string that value points to and stores it in len. | |
| CborError | cbor_value_copy_text_string (const CborValue *value, char *buffer, size_t *buflen, CborValue *next) |
| Copies the string pointed to by value into the buffer provided at buffer of buflen bytes. | |
| CborError | cbor_value_copy_byte_string (const CborValue *value, uint8_t *buffer, size_t *buflen, CborValue *next) |
| Copies the string pointed by value into the buffer provided at buffer of buflen bytes. | |
| CborError | cbor_value_dup_text_string (const CborValue *value, char **buffer, size_t *buflen, CborValue *next) |
| Allocates memory for the string pointed by value and copies it into this buffer. | |
| CborError | cbor_value_dup_byte_string (const CborValue *value, uint8_t **buffer, size_t *buflen, CborValue *next) |
| Allocates memory for the string pointed by value and copies it into this buffer. | |
| CborError | cbor_value_get_text_string_chunk (const CborValue *value, const char **bufferptr, size_t *len, CborValue *next) |
| Extracts one text string chunk pointed to by value and stores a pointer to the data in buffer and the size in len, which must not be null. | |
| CBOR_API CborError | cbor_value_text_string_equals (const CborValue *value, const char *string, bool *result) |
| Compares the entry value with the string string and stores the result in result. | |
| bool | cbor_value_is_array (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR array. | |
| bool | cbor_value_is_map (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR map. | |
| CborError | cbor_value_get_array_length (const CborValue *value, size_t *length) |
| Extracts the length of the CBOR array that value points to and stores it in result. | |
| CborError | cbor_value_get_map_length (const CborValue *value, size_t *length) |
| Extracts the length of the CBOR map that value points to and stores it in result. | |
| CBOR_API CborError | cbor_value_map_find_value (const CborValue *map, const char *string, CborValue *element) |
| Attempts to find the value in map map that corresponds to the text string entry string. | |
| bool | cbor_value_is_half_float (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR single-precision floating point (16-bit). | |
| CBOR_API CborError | cbor_value_get_half_float_as_float (const CborValue *value, float *result) |
| Retrieves the CBOR half-precision floating point (16-bit) value that value points to, converts it to the float and store it in result. | |
| CborError | cbor_value_get_half_float (const CborValue *value, void *result) |
| Retrieves the CBOR half-precision floating point (16-bit) value that value points to and stores it in result. | |
| bool | cbor_value_is_float (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR single-precision floating point (32-bit). | |
| CborError | cbor_value_get_float (const CborValue *value, float *result) |
| Retrieves the CBOR single-precision floating point (32-bit) value that value points to and stores it in result. | |
| bool | cbor_value_is_double (const CborValue *value) |
| Returns true if the iterator value is valid and points to a CBOR double-precision floating point (64-bit). | |
| CBOR_API CborError | cbor_value_validate (const CborValue *it, uint32_t flags) |
| Performs a full validation, controlled by the flags options, of the CBOR stream pointed by it and returns the error it found. | |
| CBOR_API CborError | cbor_value_to_pretty_stream (CborStreamFunction streamFunction, void *token, CborValue *value, int flags) |
| Converts the current CBOR type pointed by value to its textual representation and writes it to the stream by calling the streamFunction. | |
| CBOR_API CborError | cbor_value_to_pretty_advance_flags (FILE *out, CborValue *value, int flags) |
| Converts the current CBOR type pointed to by value to its textual representation and writes it to the out stream. | |
| CBOR_API CborError | cbor_value_to_pretty_advance (FILE *out, CborValue *value) |
| Converts the current CBOR type pointed to by value to its textual representation and writes it to the out stream. | |
| CborError | cbor_value_to_pretty (FILE *out, const CborValue *value) |
| Converts the current CBOR type pointed to by value to its textual representation and writes it to the out stream. | |
│ │ │ -Variables | |
| static const size_t | CborIndefiniteLength = ((size_t)-1) |
| This variable is a constant used to indicate that the length of the map or array is not yet determined. | |
| CBOR_API CborError | cbor_value_to_json_advance (FILE *out, CborValue *value, int flags) |
| Converts the current CBOR type pointed to by value to JSON and writes that to the out stream. | |
| CborError | cbor_value_to_json (FILE *out, const CborValue *value, int flags) |
| Converts the current CBOR type pointed to by value to JSON and writes that to the out stream. | |
> The <cbor.h> is the main header in TinyCBOR and defines the constants used by most functions as well as the structures for encoding (CborEncoder) and decoding (CborValue).
│ │ │ -| CborError cbor_value_dup_byte_string | │ │ │ -( | │ │ │ -const CborValue * | value, | │ │ │ -
| │ │ │ - | │ │ │ - | uint8_t ** | buffer, | │ │ │ -
| │ │ │ - | │ │ │ - | size_t * | buflen, | │ │ │ -
| │ │ │ - | │ │ │ - | CborValue * | next ) | │ │ │ -
Allocates memory for the string pointed by value and copies it into this buffer.
│ │ │ -The pointer to the buffer is stored in buffer and the number of bytes copied is stored in buflen (those variables must not be NULL).
│ │ │ -If the iterator value does not point to a byte string, the behaviour is undefined, so checking with cbor_value_get_type or cbor_value_is_byte_string is recommended.
│ │ │ -On success, *buffer will contain a valid pointer that must be freed by calling free(). This is the case even for zero-length strings. The next pointer, if not null, will be updated to point to the next item after this string. If value points to the last item, then next will be invalid.
If malloc returns a NULL pointer, this function will return error condition CborErrorOutOfMemory. In this case, *buflen should contain the number of bytes necessary to copy this string and value will be updated to point to the next element. On all other failure cases, the values contained in *buffer, *buflen and next are undefined and mustn't be used (for example, calling {free()}).
This function may not run in constant time (it will run in O(n) time on the number of chunks). It requires constant memory (O(1)) in addition to the malloc'ed block.
│ │ │ - │ │ │ - │ │ │ -| CborError cbor_value_dup_text_string | │ │ │ -( | │ │ │ -const CborValue * | value, | │ │ │ -
| │ │ │ - | │ │ │ - | char ** | buffer, | │ │ │ -
| │ │ │ - | │ │ │ - | size_t * | buflen, | │ │ │ -
| │ │ │ - | │ │ │ - | CborValue * | next ) | │ │ │ -
Allocates memory for the string pointed by value and copies it into this buffer.
│ │ │ -The pointer to the buffer is stored in buffer and the number of bytes copied is stored in buflen (those variables must not be NULL).
│ │ │ -If the iterator value does not point to a text string, the behaviour is undefined, so checking with cbor_value_get_type or cbor_value_is_text_string is recommended.
│ │ │ -On success, *buffer will contain a valid pointer that must be freed by calling free(). This is the case even for zero-length strings. The next pointer, if not null, will be updated to point to the next item after this string. If value points to the last item, then next will be invalid.
If malloc returns a NULL pointer, this function will return error condition CborErrorOutOfMemory. In this case, *buflen should contain the number of bytes necessary to copy this string and value will be updated to point to the next element. On all other failure cases, the values contained in *buffer, *buflen and next are undefined and mustn't be used (for example, calling {free()}).
This function may not run in constant time (it will run in O(n) time on the number of chunks). It requires constant memory (O(1)) in addition to the malloc'ed block.
│ │ │ -| CBOR_API CborError cbor_value_get_half_float_as_float | │ │ │ -( | │ │ │ -const CborValue * | value, | │ │ │ -
| │ │ │ - | │ │ │ - | float * | result ) | │ │ │ -
Retrieves the CBOR half-precision floating point (16-bit) value that value points to, converts it to the float and store it in result.
│ │ │ -If the iterator value does not point to a half-precision floating point value, the behavior is undefined, so checking with cbor_value_get_type or with cbor_value_is_half_float is recommended.
Referenced by cbor_value_get_half_float_as_float().
│ │ │ - │ │ │ -| CborError cbor_value_to_pretty | │ │ │ -( | │ │ │ -FILE * | out, | │ │ │ -
| │ │ │ - | │ │ │ - | const CborValue * | value ) | │ │ │ -
Converts the current CBOR type pointed to by value to its textual representation and writes it to the out stream.
│ │ │ -If an error occurs, this function returns an error code similar to CborParsing.
│ │ │ -| CBOR_API CborError cbor_value_to_pretty_advance | │ │ │ -( | │ │ │ -FILE * | out, | │ │ │ -
| │ │ │ - | │ │ │ - | CborValue * | value ) | │ │ │ -
Converts the current CBOR type pointed to by value to its textual representation and writes it to the out stream.
│ │ │ -If an error occurs, this function returns an error code similar to CborParsing.
│ │ │ -If no error ocurred, this function advances value to the next element. Often, concatenating the text representation of multiple elements can be done by appending a comma to the output stream in between calls to this function.
│ │ │ - │ │ │ - │ │ │ -Referenced by cbor_value_to_pretty_advance().
│ │ │ - │ │ │ -| CBOR_API CborError cbor_value_to_pretty_advance_flags | │ │ │ -( | │ │ │ -FILE * | out, | │ │ │ -
| │ │ │ - | │ │ │ - | CborValue * | value, | │ │ │ -
| │ │ │ - | │ │ │ - | int | flags ) | │ │ │ -
Converts the current CBOR type pointed to by value to its textual representation and writes it to the out stream.
│ │ │ -If an error occurs, this function returns an error code similar to CborParsing.
│ │ │ -The textual representation can be controlled by the flags parameter (see CborPrettyFlags for more information).
│ │ │ -If no error ocurred, this function advances value to the next element. Often, concatenating the text representation of multiple elements can be done by appending a comma to the output stream in between calls to this function.
│ │ │ - │ │ │ - │ │ │ -Referenced by cbor_value_to_pretty(), and cbor_value_to_pretty_advance_flags().
│ │ │ - │ │ │ -> The <cborjson.h> file contains the routines that are used to convert a CBOR data stream into JSON.
│ │ │ + 1.15.0
│ │ │
│ │ │
│ │ │
│ │ │
│ │ │ ├── html2text {}
│ │ │ │ @@ -1,462 +1,29 @@
│ │ │ │ TinyCBOR 7.0 API
│ │ │ │ * _M_a_i_n_ _P_a_g_e
│ │ │ │ * _T_o_p_i_c_s
│ │ │ │ * _D_a_t_a_ _S_t_r_u_c_t_u_r_e_s
│ │ │ │ * _F_i_l_e_s
│ │ │ │ * _F_i_l_e_ _L_i_s_t
│ │ │ │ * _G_l_o_b_a_l_s
│ │ │ │ -_D_a_t_a_ _S_t_r_u_c_t_u_r_e_s | _T_y_p_e_d_e_f_s | _F_u_n_c_t_i_o_n_s | _V_a_r_i_a_b_l_e_s
│ │ │ │ -cbor.h File Reference
│ │ │ │ -> The <_c_b_o_r_._h> is the main header in TinyCBOR and defines the constants used by
│ │ │ │ -most functions as well as the structures for encoding (_C_b_o_r_E_n_c_o_d_e_r) and
│ │ │ │ -decoding (_C_b_o_r_V_a_l_u_e). _M_o_r_e_._._.
│ │ │ │ -#include 1.15.0
│ │ │
│ │ │ Copies the string pointed by value into the buffer provided at buffer of buflen bytes.
│ │ │If buffer is a NULL pointer, this function will not copy anything and will only update the next value.
│ │ │If the iterator value does not point to a byte string, the behaviour is undefined, so checking with cbor_value_get_type or cbor_value_is_byte_string is recommended.
│ │ │If the provided buffer length was too small, this function returns an error condition of CborErrorOutOfMemory. If you need to calculate the length of the string in order to preallocate a buffer, use cbor_value_calculate_string_length().
│ │ │On success, this function sets the number of bytes copied to *buflen. If the buffer is large enough, this function will insert a null byte after the last copied byte, to facilitate manipulation of null-terminated strings. That byte is not included in the returned value of *buflen.
The next pointer, if not null, will be updated to point to the next item after this string. If value points to the last item, then next will be invalid.
│ │ │This function may not run in constant time (it will run in O(n) time on the number of chunks). It requires constant memory (O(1)).
│ │ │ -If buffer is a NULL pointer, this function will not copy anything and will only update the next value.
│ │ │If the iterator value does not point to a text string, the behaviour is undefined, so checking with cbor_value_get_type or cbor_value_is_text_string is recommended.
│ │ │If the provided buffer length was too small, this function returns an error condition of CborErrorOutOfMemory. If you need to calculate the length of the string in order to preallocate a buffer, use cbor_value_calculate_string_length().
│ │ │On success, this function sets the number of bytes copied to *buflen. If the buffer is large enough, this function will insert a null byte after the last copied byte, to facilitate manipulation of text strings. That byte is not included in the returned value of *buflen. If there was no space for the terminating null, no error is returned, so callers must check the value of *buflen after the call, before relying on the '\0'; if it has not been changed by the call, there is no '\0'-termination on the buffer's contents.
The next pointer, if not null, will be updated to point to the next item after this string. If value points to the last item, then next will be invalid.
│ │ │This function may not run in constant time (it will run in O(n) time on the number of chunks). It requires constant memory (O(1)).
│ │ │Retrieves the CBOR half-precision floating point (16-bit) value that value points to and stores it in result.
│ │ │If the iterator value does not point to a half-precision floating point value, the behavior is undefined, so checking with cbor_value_get_type or with cbor_value_is_half_float is recommended.
│ │ │Note: since the C language does not have a standard type for half-precision floating point, this function takes a void * as a parameter for the storage area, which must be at least 16 bits wide.
│ │ │ -Referenced by cbor_value_get_half_float_as_float().
│ │ │ +Referenced by cbor_value_get_half_float_as_float().
│ │ │ │ │ │If the iterator value does not point to a text string, the behaviour is undefined, so checking with cbor_value_get_type or cbor_value_is_text_string is recommended.
│ │ │The next pointer, if not null, will be updated to point to the next item after this string. During iteration, the pointer must only be passed back again to this function; passing it to any other function in this library results in undefined behavior. If there are no more chunks to be read from value, then next will be set to the next item after this string; if value points to the last item, then next will be invalid.
│ │ │Returns true if the iterator value is valid and points to a CBOR byte string.
│ │ │CBOR byte strings are binary data with no specified encoding or format.
│ │ │ -Referenced by cbor_value_copy_byte_string(), cbor_value_dup_byte_string(), and cbor_value_get_string_length().
│ │ │ +Referenced by cbor_value_copy_byte_string(), cbor_value_dup_byte_string(), and cbor_value_get_string_length().
│ │ │ │ │ │Returns true if the iterator value is valid and points to a CBOR text string.
│ │ │CBOR text strings are UTF-8 encoded and usually contain human-readable text.
│ │ │ -Referenced by cbor_value_copy_text_string(), cbor_value_dup_text_string(), cbor_value_get_string_length(), cbor_value_get_text_string_chunk(), cbor_value_map_find_value(), and cbor_value_text_string_equals().
│ │ │ +Referenced by cbor_value_copy_text_string(), cbor_value_dup_text_string(), cbor_value_get_string_length(), cbor_value_get_text_string_chunk(), cbor_value_map_find_value(), and cbor_value_text_string_equals().
│ │ │ │ │ │Converts the current CBOR type pointed by value to its textual representation and writes it to the stream by calling the streamFunction.
│ │ │If an error occurs, this function returns an error code similar to Parsing CBOR streams.
│ │ │The textual representation can be controlled by the flags parameter (see CborPrettyFlags for more information).
│ │ │If no error ocurred, this function advances value to the next element. Often, concatenating the text representation of multiple elements can be done by appending a comma to the output stream in between calls to this function.
│ │ │The streamFunction function will be called with the token value as the first parameter and a printf-style format string as the second, with a variable number of further parameters.
│ │ │ - │ │ │ + │ │ │ │ │ │ -Referenced by cbor_value_to_pretty_advance(), and cbor_value_to_pretty_advance_flags().
│ │ │ +Referenced by cbor_value_to_pretty_advance(), and cbor_value_to_pretty_advance_flags().
│ │ │ │ │ │ 1.15.0
│ │ ├── ./usr/share/doc/libtinycbor-dev/html/a00055.html
│ │ │ @@ -101,15 +101,15 @@
│ │ │ Converts the current CBOR type pointed to by value to JSON and writes that to the out stream.
│ │ │If an error occurs, this function returns an error code similar to CborParsing. The flags parameter indicates one or more of the flags from CborToJsonFlags that control the conversion.
│ │ │ - │ │ │ + │ │ │ │ │ │Converts the current CBOR type pointed to by value to JSON and writes that to the out stream.
│ │ │If an error occurs, this function returns an error code similar to CborParsing. The flags parameter indicates one or more of the flags from CborToJsonFlags that control the conversion.
│ │ │If no error ocurred, this function advances value to the next element.
│ │ │ - │ │ │ + │ │ │ │ │ │Referenced by cbor_value_to_json().
│ │ │ │ │ │| cbor.h | > The <cbor.h> is the main header in TinyCBOR and defines the constants used by most functions as well as the structures for encoding (CborEncoder) and decoding (CborValue) |
| cborjson.h | > The <cborjson.h> file contains the routines that are used to convert a CBOR data stream into JSON |
| memory.h | |
| cbor.h | > The <cbor.h> is the main header in TinyCBOR and defines the constants used by most functions as well as the structures for encoding (CborEncoder) and decoding (CborValue) |
| cborjson.h | > The <cborjson.h> file contains the routines that are used to convert a CBOR data stream into JSON |
| memory.h |
1.15.0
│ │ │
│ │ ├── ./usr/share/doc/libtinycbor-dev/html/globals.html
│ │ │ @@ -112,22 +112,22 @@
│ │ │