mirror of
https://github.com/RfidResearchGroup/proxmark3.git
synced 2024-11-14 13:44:49 +08:00
584 lines
23 KiB
C
584 lines
23 KiB
C
/****************************************************************************
|
|
**
|
|
** Copyright (C) 2017 Intel Corporation
|
|
**
|
|
** Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
** of this software and associated documentation files (the "Software"), to deal
|
|
** in the Software without restriction, including without limitation the rights
|
|
** to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
** copies of the Software, and to permit persons to whom the Software is
|
|
** furnished to do so, subject to the following conditions:
|
|
**
|
|
** The above copyright notice and this permission notice shall be included in
|
|
** all copies or substantial portions of the Software.
|
|
**
|
|
** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
** IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
** FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
** AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
** LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
** OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
** THE SOFTWARE.
|
|
**
|
|
****************************************************************************/
|
|
|
|
#ifndef CBOR_H
|
|
#define CBOR_H
|
|
|
|
#ifndef assert
|
|
#include <assert.h>
|
|
#endif
|
|
#include <limits.h>
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
#include <string.h>
|
|
#include <stdio.h>
|
|
|
|
#include "tinycbor-version.h"
|
|
|
|
#define TINYCBOR_VERSION ((TINYCBOR_VERSION_MAJOR << 16) | (TINYCBOR_VERSION_MINOR << 8) | TINYCBOR_VERSION_PATCH)
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#else
|
|
#include <stdbool.h>
|
|
#endif
|
|
|
|
#ifndef SIZE_MAX
|
|
/* Some systems fail to define SIZE_MAX in <stdint.h>, even though C99 requires it...
|
|
* Conversion from signed to unsigned is defined in 6.3.1.3 (Signed and unsigned integers) p2,
|
|
* which says: "the value is converted by repeatedly adding or subtracting one more than the
|
|
* maximum value that can be represented in the new type until the value is in the range of the
|
|
* new type."
|
|
* So -1 gets converted to size_t by adding SIZE_MAX + 1, which results in SIZE_MAX.
|
|
*/
|
|
# define SIZE_MAX ((size_t)-1)
|
|
#endif
|
|
|
|
#ifndef CBOR_API
|
|
# define CBOR_API
|
|
#endif
|
|
#ifndef CBOR_PRIVATE_API
|
|
# define CBOR_PRIVATE_API
|
|
#endif
|
|
#ifndef CBOR_INLINE_API
|
|
# if defined(__cplusplus)
|
|
# define CBOR_INLINE inline
|
|
# define CBOR_INLINE_API inline
|
|
# else
|
|
# define CBOR_INLINE_API static CBOR_INLINE
|
|
# if defined(_MSC_VER)
|
|
# define CBOR_INLINE __inline
|
|
# elif defined(__GNUC__)
|
|
# define CBOR_INLINE __inline__
|
|
# elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L
|
|
# define CBOR_INLINE inline
|
|
# else
|
|
# define CBOR_INLINE
|
|
# endif
|
|
# endif
|
|
#endif
|
|
|
|
typedef enum CborType {
|
|
CborIntegerType = 0x00,
|
|
CborByteStringType = 0x40,
|
|
CborTextStringType = 0x60,
|
|
CborArrayType = 0x80,
|
|
CborMapType = 0xa0,
|
|
CborTagType = 0xc0,
|
|
CborSimpleType = 0xe0,
|
|
CborBooleanType = 0xf5,
|
|
CborNullType = 0xf6,
|
|
CborUndefinedType = 0xf7,
|
|
CborHalfFloatType = 0xf9,
|
|
CborFloatType = 0xfa,
|
|
CborDoubleType = 0xfb,
|
|
|
|
CborInvalidType = 0xff /* equivalent to the break byte, so it will never be used */
|
|
} CborType;
|
|
|
|
typedef uint64_t CborTag;
|
|
typedef enum CborKnownTags {
|
|
CborDateTimeStringTag = 0,
|
|
CborUnixTime_tTag = 1,
|
|
CborPositiveBignumTag = 2,
|
|
CborNegativeBignumTag = 3,
|
|
CborDecimalTag = 4,
|
|
CborBigfloatTag = 5,
|
|
CborCOSE_Encrypt0Tag = 16,
|
|
CborCOSE_Mac0Tag = 17,
|
|
CborCOSE_Sign1Tag = 18,
|
|
CborExpectedBase64urlTag = 21,
|
|
CborExpectedBase64Tag = 22,
|
|
CborExpectedBase16Tag = 23,
|
|
CborEncodedCborTag = 24,
|
|
CborUrlTag = 32,
|
|
CborBase64urlTag = 33,
|
|
CborBase64Tag = 34,
|
|
CborRegularExpressionTag = 35,
|
|
CborMimeMessageTag = 36,
|
|
CborCOSE_EncryptTag = 96,
|
|
CborCOSE_MacTag = 97,
|
|
CborCOSE_SignTag = 98,
|
|
CborSignatureTag = 55799
|
|
} CborKnownTags;
|
|
|
|
/* #define the constants so we can check with #ifdef */
|
|
#define CborDateTimeStringTag CborDateTimeStringTag
|
|
#define CborUnixTime_tTag CborUnixTime_tTag
|
|
#define CborPositiveBignumTag CborPositiveBignumTag
|
|
#define CborNegativeBignumTag CborNegativeBignumTag
|
|
#define CborDecimalTag CborDecimalTag
|
|
#define CborBigfloatTag CborBigfloatTag
|
|
#define CborCOSE_Encrypt0Tag CborCOSE_Encrypt0Tag
|
|
#define CborCOSE_Mac0Tag CborCOSE_Mac0Tag
|
|
#define CborCOSE_Sign1Tag CborCOSE_Sign1Tag
|
|
#define CborExpectedBase64urlTag CborExpectedBase64urlTag
|
|
#define CborExpectedBase64Tag CborExpectedBase64Tag
|
|
#define CborExpectedBase16Tag CborExpectedBase16Tag
|
|
#define CborEncodedCborTag CborEncodedCborTag
|
|
#define CborUrlTag CborUrlTag
|
|
#define CborBase64urlTag CborBase64urlTag
|
|
#define CborBase64Tag CborBase64Tag
|
|
#define CborRegularExpressionTag CborRegularExpressionTag
|
|
#define CborMimeMessageTag CborMimeMessageTag
|
|
#define CborCOSE_EncryptTag CborCOSE_EncryptTag
|
|
#define CborCOSE_MacTag CborCOSE_MacTag
|
|
#define CborCOSE_SignTag CborCOSE_SignTag
|
|
#define CborSignatureTag CborSignatureTag
|
|
|
|
/* Error API */
|
|
|
|
typedef enum CborError {
|
|
CborNoError = 0,
|
|
|
|
/* errors in all modes */
|
|
CborUnknownError,
|
|
CborErrorUnknownLength, /* request for length in array, map, or string with indeterminate length */
|
|
CborErrorAdvancePastEOF,
|
|
CborErrorIO,
|
|
|
|
/* parser errors streaming errors */
|
|
CborErrorGarbageAtEnd = 256,
|
|
CborErrorUnexpectedEOF,
|
|
CborErrorUnexpectedBreak,
|
|
CborErrorUnknownType, /* can only happen in major type 7 */
|
|
CborErrorIllegalType, /* type not allowed here */
|
|
CborErrorIllegalNumber,
|
|
CborErrorIllegalSimpleType, /* types of value less than 32 encoded in two bytes */
|
|
|
|
/* parser errors in strict mode parsing only */
|
|
CborErrorUnknownSimpleType = 512,
|
|
CborErrorUnknownTag,
|
|
CborErrorInappropriateTagForType,
|
|
CborErrorDuplicateObjectKeys,
|
|
CborErrorInvalidUtf8TextString,
|
|
CborErrorExcludedType,
|
|
CborErrorExcludedValue,
|
|
CborErrorImproperValue,
|
|
CborErrorOverlongEncoding,
|
|
CborErrorMapKeyNotString,
|
|
CborErrorMapNotSorted,
|
|
CborErrorMapKeysNotUnique,
|
|
|
|
/* encoder errors */
|
|
CborErrorTooManyItems = 768,
|
|
CborErrorTooFewItems,
|
|
|
|
/* internal implementation errors */
|
|
CborErrorDataTooLarge = 1024,
|
|
CborErrorNestingTooDeep,
|
|
CborErrorUnsupportedType,
|
|
|
|
/* errors in converting to JSON */
|
|
CborErrorJsonObjectKeyIsAggregate = 1280,
|
|
CborErrorJsonObjectKeyNotString,
|
|
CborErrorJsonNotImplemented,
|
|
|
|
CborErrorOutOfMemory = (int)(~0U / 2 + 1),
|
|
CborErrorInternalError = (int)(~0U / 2) /* INT_MAX on two's complement machines */
|
|
} CborError;
|
|
|
|
CBOR_API const char *cbor_error_string(CborError error);
|
|
|
|
/* Encoder API */
|
|
struct CborEncoder {
|
|
union {
|
|
uint8_t *ptr;
|
|
ptrdiff_t bytes_needed;
|
|
} data;
|
|
const uint8_t *end;
|
|
size_t remaining;
|
|
int flags;
|
|
};
|
|
typedef struct CborEncoder CborEncoder;
|
|
|
|
static const size_t CborIndefiniteLength = SIZE_MAX;
|
|
|
|
CBOR_API void cbor_encoder_init(CborEncoder *encoder, uint8_t *buffer, size_t size, int flags);
|
|
CBOR_API CborError cbor_encode_uint(CborEncoder *encoder, uint64_t value);
|
|
CBOR_API CborError cbor_encode_int(CborEncoder *encoder, int64_t value);
|
|
CBOR_API CborError cbor_encode_negative_int(CborEncoder *encoder, uint64_t absolute_value);
|
|
CBOR_API CborError cbor_encode_simple_value(CborEncoder *encoder, uint8_t value);
|
|
CBOR_API CborError cbor_encode_tag(CborEncoder *encoder, CborTag tag);
|
|
CBOR_API CborError cbor_encode_text_string(CborEncoder *encoder, const char *string, size_t length);
|
|
CBOR_INLINE_API CborError cbor_encode_text_stringz(CborEncoder *encoder, const char *string)
|
|
{ return cbor_encode_text_string(encoder, string, strlen(string)); }
|
|
CBOR_API CborError cbor_encode_byte_string(CborEncoder *encoder, const uint8_t *string, size_t length);
|
|
CBOR_API CborError cbor_encode_floating_point(CborEncoder *encoder, CborType fpType, const void *value);
|
|
|
|
CBOR_INLINE_API CborError cbor_encode_boolean(CborEncoder *encoder, bool value)
|
|
{ return cbor_encode_simple_value(encoder, (int)value - 1 + (CborBooleanType & 0x1f)); }
|
|
CBOR_INLINE_API CborError cbor_encode_null(CborEncoder *encoder)
|
|
{ return cbor_encode_simple_value(encoder, CborNullType & 0x1f); }
|
|
CBOR_INLINE_API CborError cbor_encode_undefined(CborEncoder *encoder)
|
|
{ return cbor_encode_simple_value(encoder, CborUndefinedType & 0x1f); }
|
|
|
|
CBOR_INLINE_API CborError cbor_encode_half_float(CborEncoder *encoder, const void *value)
|
|
{ return cbor_encode_floating_point(encoder, CborHalfFloatType, value); }
|
|
CBOR_INLINE_API CborError cbor_encode_float(CborEncoder *encoder, float value)
|
|
{ return cbor_encode_floating_point(encoder, CborFloatType, &value); }
|
|
CBOR_INLINE_API CborError cbor_encode_double(CborEncoder *encoder, double value)
|
|
{ return cbor_encode_floating_point(encoder, CborDoubleType, &value); }
|
|
|
|
CBOR_API CborError cbor_encoder_create_array(CborEncoder *encoder, CborEncoder *arrayEncoder, size_t length);
|
|
CBOR_API CborError cbor_encoder_create_map(CborEncoder *encoder, CborEncoder *mapEncoder, size_t length);
|
|
CBOR_API CborError cbor_encoder_close_container(CborEncoder *encoder, const CborEncoder *containerEncoder);
|
|
CBOR_API CborError cbor_encoder_close_container_checked(CborEncoder *encoder, const CborEncoder *containerEncoder);
|
|
|
|
CBOR_INLINE_API uint8_t *_cbor_encoder_get_buffer_pointer(const CborEncoder *encoder) {
|
|
return encoder->data.ptr;
|
|
}
|
|
|
|
CBOR_INLINE_API size_t cbor_encoder_get_buffer_size(const CborEncoder *encoder, const uint8_t *buffer) {
|
|
return (size_t)(encoder->data.ptr - buffer);
|
|
}
|
|
|
|
CBOR_INLINE_API size_t cbor_encoder_get_extra_bytes_needed(const CborEncoder *encoder) {
|
|
return encoder->end ? 0 : (size_t)encoder->data.bytes_needed;
|
|
}
|
|
|
|
/* Parser API */
|
|
|
|
enum CborParserIteratorFlags {
|
|
CborIteratorFlag_IntegerValueTooLarge = 0x01,
|
|
CborIteratorFlag_NegativeInteger = 0x02,
|
|
CborIteratorFlag_IteratingStringChunks = 0x02,
|
|
CborIteratorFlag_UnknownLength = 0x04,
|
|
CborIteratorFlag_ContainerIsMap = 0x20
|
|
};
|
|
|
|
struct CborParser {
|
|
const uint8_t *end;
|
|
uint32_t flags;
|
|
};
|
|
typedef struct CborParser CborParser;
|
|
|
|
struct CborValue {
|
|
const CborParser *parser;
|
|
const uint8_t *ptr;
|
|
uint32_t remaining;
|
|
uint16_t extra;
|
|
uint8_t type;
|
|
uint8_t flags;
|
|
};
|
|
typedef struct CborValue CborValue;
|
|
|
|
CBOR_API CborError cbor_parser_init(const uint8_t *buffer, size_t size, uint32_t flags, CborParser *parser, CborValue *it);
|
|
|
|
CBOR_API CborError cbor_value_validate_basic(const CborValue *it);
|
|
|
|
CBOR_INLINE_API bool cbor_value_at_end(const CborValue *it)
|
|
{ return it->remaining == 0; }
|
|
CBOR_INLINE_API const uint8_t *cbor_value_get_next_byte(const CborValue *it)
|
|
{ return it->ptr; }
|
|
CBOR_API CborError cbor_value_advance_fixed(CborValue *it);
|
|
CBOR_API CborError cbor_value_advance(CborValue *it);
|
|
CBOR_INLINE_API bool cbor_value_is_container(const CborValue *it)
|
|
{ return it->type == CborArrayType || it->type == CborMapType; }
|
|
CBOR_API CborError cbor_value_enter_container(const CborValue *it, CborValue *recursed);
|
|
CBOR_API CborError cbor_value_leave_container(CborValue *it, const CborValue *recursed);
|
|
|
|
CBOR_PRIVATE_API uint64_t _cbor_value_decode_int64_internal(const CborValue *value);
|
|
CBOR_INLINE_API uint64_t _cbor_value_extract_int64_helper(const CborValue *value) {
|
|
return (value->flags & CborIteratorFlag_IntegerValueTooLarge) ?
|
|
_cbor_value_decode_int64_internal(value) : value->extra;
|
|
}
|
|
|
|
CBOR_INLINE_API bool cbor_value_is_valid(const CborValue *value)
|
|
{ return value && value->type != CborInvalidType; }
|
|
CBOR_INLINE_API CborType cbor_value_get_type(const CborValue *value)
|
|
{ return (CborType)value->type; }
|
|
|
|
/* Null & undefined type */
|
|
CBOR_INLINE_API bool cbor_value_is_null(const CborValue *value)
|
|
{ return value->type == CborNullType; }
|
|
CBOR_INLINE_API bool cbor_value_is_undefined(const CborValue *value)
|
|
{ return value->type == CborUndefinedType; }
|
|
|
|
/* Booleans */
|
|
CBOR_INLINE_API bool cbor_value_is_boolean(const CborValue *value)
|
|
{ return value->type == CborBooleanType; }
|
|
CBOR_INLINE_API CborError cbor_value_get_boolean(const CborValue *value, bool *result) {
|
|
assert(cbor_value_is_boolean(value));
|
|
*result = !!value->extra;
|
|
return CborNoError;
|
|
}
|
|
|
|
/* Simple types */
|
|
CBOR_INLINE_API bool cbor_value_is_simple_type(const CborValue *value)
|
|
{ return value->type == CborSimpleType; }
|
|
CBOR_INLINE_API CborError cbor_value_get_simple_type(const CborValue *value, uint8_t *result) {
|
|
assert(cbor_value_is_simple_type(value));
|
|
*result = (uint8_t)value->extra;
|
|
return CborNoError;
|
|
}
|
|
|
|
/* Integers */
|
|
CBOR_INLINE_API bool cbor_value_is_integer(const CborValue *value)
|
|
{ return value->type == CborIntegerType; }
|
|
CBOR_INLINE_API bool cbor_value_is_unsigned_integer(const CborValue *value)
|
|
{ return cbor_value_is_integer(value) && (value->flags & CborIteratorFlag_NegativeInteger) == 0; }
|
|
CBOR_INLINE_API bool cbor_value_is_negative_integer(const CborValue *value)
|
|
{ return cbor_value_is_integer(value) && (value->flags & CborIteratorFlag_NegativeInteger); }
|
|
|
|
CBOR_INLINE_API CborError cbor_value_get_raw_integer(const CborValue *value, uint64_t *result) {
|
|
assert(cbor_value_is_integer(value));
|
|
*result = _cbor_value_extract_int64_helper(value);
|
|
return CborNoError;
|
|
}
|
|
|
|
CBOR_INLINE_API CborError cbor_value_get_uint64(const CborValue *value, uint64_t *result) {
|
|
assert(cbor_value_is_unsigned_integer(value));
|
|
*result = _cbor_value_extract_int64_helper(value);
|
|
return CborNoError;
|
|
}
|
|
|
|
CBOR_INLINE_API CborError cbor_value_get_int64(const CborValue *value, int64_t *result) {
|
|
assert(cbor_value_is_integer(value));
|
|
*result = (int64_t) _cbor_value_extract_int64_helper(value);
|
|
if (value->flags & CborIteratorFlag_NegativeInteger)
|
|
*result = -*result - 1;
|
|
return CborNoError;
|
|
}
|
|
|
|
CBOR_INLINE_API CborError cbor_value_get_int(const CborValue *value, int *result) {
|
|
assert(cbor_value_is_integer(value));
|
|
*result = (int) _cbor_value_extract_int64_helper(value);
|
|
if (value->flags & CborIteratorFlag_NegativeInteger)
|
|
*result = -*result - 1;
|
|
return CborNoError;
|
|
}
|
|
|
|
CBOR_API CborError cbor_value_get_int64_checked(const CborValue *value, int64_t *result);
|
|
CBOR_API CborError cbor_value_get_int_checked(const CborValue *value, int *result);
|
|
|
|
CBOR_INLINE_API bool cbor_value_is_length_known(const CborValue *value)
|
|
{ return (value->flags & CborIteratorFlag_UnknownLength) == 0; }
|
|
|
|
/* Tags */
|
|
CBOR_INLINE_API bool cbor_value_is_tag(const CborValue *value)
|
|
{ return value->type == CborTagType; }
|
|
CBOR_INLINE_API CborError cbor_value_get_tag(const CborValue *value, CborTag *result) {
|
|
assert(cbor_value_is_tag(value));
|
|
*result = _cbor_value_extract_int64_helper(value);
|
|
return CborNoError;
|
|
}
|
|
CBOR_API CborError cbor_value_skip_tag(CborValue *it);
|
|
|
|
/* Strings */
|
|
CBOR_INLINE_API bool cbor_value_is_byte_string(const CborValue *value)
|
|
{ return value->type == CborByteStringType; }
|
|
CBOR_INLINE_API bool cbor_value_is_text_string(const CborValue *value)
|
|
{ return value->type == CborTextStringType; }
|
|
|
|
CBOR_INLINE_API CborError cbor_value_get_string_length(const CborValue *value, size_t *length) {
|
|
uint64_t v;
|
|
assert(cbor_value_is_byte_string(value) || cbor_value_is_text_string(value));
|
|
if (!cbor_value_is_length_known(value))
|
|
return CborErrorUnknownLength;
|
|
v = _cbor_value_extract_int64_helper(value);
|
|
*length = (size_t)v;
|
|
if (*length != v)
|
|
return CborErrorDataTooLarge;
|
|
return CborNoError;
|
|
}
|
|
|
|
CBOR_PRIVATE_API CborError _cbor_value_copy_string(const CborValue *value, void *buffer,
|
|
size_t *buflen, CborValue *next);
|
|
CBOR_PRIVATE_API CborError _cbor_value_dup_string(const CborValue *value, void **buffer,
|
|
size_t *buflen, CborValue *next);
|
|
|
|
CBOR_API CborError cbor_value_calculate_string_length(const CborValue *value, size_t *len);
|
|
|
|
CBOR_INLINE_API CborError cbor_value_copy_text_string(const CborValue *value, char *buffer,
|
|
size_t *buflen, CborValue *next) {
|
|
assert(cbor_value_is_text_string(value));
|
|
return _cbor_value_copy_string(value, buffer, buflen, next);
|
|
}
|
|
CBOR_INLINE_API CborError cbor_value_copy_byte_string(const CborValue *value, uint8_t *buffer,
|
|
size_t *buflen, CborValue *next) {
|
|
assert(cbor_value_is_byte_string(value));
|
|
return _cbor_value_copy_string(value, buffer, buflen, next);
|
|
}
|
|
|
|
CBOR_INLINE_API CborError cbor_value_dup_text_string(const CborValue *value, char **buffer,
|
|
size_t *buflen, CborValue *next) {
|
|
assert(cbor_value_is_text_string(value));
|
|
return _cbor_value_dup_string(value, (void **)buffer, buflen, next);
|
|
}
|
|
CBOR_INLINE_API CborError cbor_value_dup_byte_string(const CborValue *value, uint8_t **buffer,
|
|
size_t *buflen, CborValue *next) {
|
|
assert(cbor_value_is_byte_string(value));
|
|
return _cbor_value_dup_string(value, (void **)buffer, buflen, next);
|
|
}
|
|
|
|
CBOR_API CborError cbor_value_text_string_equals(const CborValue *value, const char *string, bool *result);
|
|
|
|
/* Maps and arrays */
|
|
CBOR_INLINE_API bool cbor_value_is_array(const CborValue *value)
|
|
{ return value->type == CborArrayType; }
|
|
CBOR_INLINE_API bool cbor_value_is_map(const CborValue *value)
|
|
{ return value->type == CborMapType; }
|
|
|
|
CBOR_INLINE_API CborError cbor_value_get_array_length(const CborValue *value, size_t *length) {
|
|
uint64_t v;
|
|
assert(cbor_value_is_array(value));
|
|
if (!cbor_value_is_length_known(value))
|
|
return CborErrorUnknownLength;
|
|
v = _cbor_value_extract_int64_helper(value);
|
|
*length = (size_t)v;
|
|
if (*length != v)
|
|
return CborErrorDataTooLarge;
|
|
return CborNoError;
|
|
}
|
|
|
|
CBOR_INLINE_API CborError cbor_value_get_map_length(const CborValue *value, size_t *length) {
|
|
uint64_t v;
|
|
assert(cbor_value_is_map(value));
|
|
if (!cbor_value_is_length_known(value))
|
|
return CborErrorUnknownLength;
|
|
v = _cbor_value_extract_int64_helper(value);
|
|
*length = (size_t)v;
|
|
if (*length != v)
|
|
return CborErrorDataTooLarge;
|
|
return CborNoError;
|
|
}
|
|
|
|
CBOR_API CborError cbor_value_map_find_value(const CborValue *map, const char *string, CborValue *element);
|
|
|
|
/* Floating point */
|
|
CBOR_INLINE_API bool cbor_value_is_half_float(const CborValue *value)
|
|
{ return value->type == CborHalfFloatType; }
|
|
CBOR_API CborError cbor_value_get_half_float(const CborValue *value, void *result);
|
|
|
|
CBOR_INLINE_API bool cbor_value_is_float(const CborValue *value)
|
|
{ return value->type == CborFloatType; }
|
|
CBOR_INLINE_API CborError cbor_value_get_float(const CborValue *value, float *result) {
|
|
uint32_t data;
|
|
assert(cbor_value_is_float(value));
|
|
assert(value->flags & CborIteratorFlag_IntegerValueTooLarge);
|
|
data = (uint32_t)_cbor_value_decode_int64_internal(value);
|
|
memcpy(result, &data, sizeof(*result));
|
|
return CborNoError;
|
|
}
|
|
|
|
CBOR_INLINE_API bool cbor_value_is_double(const CborValue *value)
|
|
{ return value->type == CborDoubleType; }
|
|
CBOR_INLINE_API CborError cbor_value_get_double(const CborValue *value, double *result) {
|
|
uint64_t data;
|
|
assert(cbor_value_is_double(value));
|
|
assert(value->flags & CborIteratorFlag_IntegerValueTooLarge);
|
|
data = _cbor_value_decode_int64_internal(value);
|
|
memcpy(result, &data, sizeof(*result));
|
|
return CborNoError;
|
|
}
|
|
|
|
/* Validation API */
|
|
|
|
enum CborValidationFlags {
|
|
/* Bit mapping:
|
|
* bits 0-7 (8 bits): canonical format
|
|
* bits 8-11 (4 bits): canonical format & strict mode
|
|
* bits 12-20 (8 bits): strict mode
|
|
* bits 21-31 (10 bits): other
|
|
*/
|
|
|
|
CborValidateShortestIntegrals = 0x0001,
|
|
CborValidateShortestFloatingPoint = 0x0002,
|
|
CborValidateShortestNumbers = CborValidateShortestIntegrals | CborValidateShortestFloatingPoint,
|
|
CborValidateNoIndeterminateLength = 0x0100,
|
|
CborValidateMapIsSorted = 0x0200 | CborValidateNoIndeterminateLength,
|
|
|
|
CborValidateCanonicalFormat = 0x0fff,
|
|
|
|
CborValidateMapKeysAreUnique = 0x1000 | CborValidateMapIsSorted,
|
|
CborValidateTagUse = 0x2000,
|
|
CborValidateUtf8 = 0x4000,
|
|
|
|
CborValidateStrictMode = 0xfff00,
|
|
|
|
CborValidateMapKeysAreString = 0x100000,
|
|
CborValidateNoUndefined = 0x200000,
|
|
CborValidateNoTags = 0x400000,
|
|
CborValidateFiniteFloatingPoint = 0x800000,
|
|
/* unused = 0x1000000, */
|
|
/* unused = 0x2000000, */
|
|
|
|
CborValidateNoUnknownSimpleTypesSA = 0x4000000,
|
|
CborValidateNoUnknownSimpleTypes = 0x8000000 | CborValidateNoUnknownSimpleTypesSA,
|
|
CborValidateNoUnknownTagsSA = 0x10000000,
|
|
CborValidateNoUnknownTagsSR = 0x20000000 | CborValidateNoUnknownTagsSA,
|
|
CborValidateNoUnknownTags = 0x40000000 | CborValidateNoUnknownTagsSR,
|
|
|
|
CborValidateCompleteData = (int)0x80000000,
|
|
|
|
CborValidateStrictest = (int)~0U,
|
|
CborValidateBasic = 0
|
|
};
|
|
|
|
CBOR_API CborError cbor_value_validate(const CborValue *it, uint32_t flags);
|
|
|
|
/* Human-readable (dump) API */
|
|
|
|
enum CborPrettyFlags {
|
|
CborPrettyNumericEncodingIndicators = 0x01,
|
|
CborPrettyTextualEncodingIndicators = 0,
|
|
|
|
CborPrettyIndicateIndeterminateLength = 0x02,
|
|
CborPrettyIndicateIndetermineLength = CborPrettyIndicateIndeterminateLength, /* deprecated */
|
|
CborPrettyIndicateOverlongNumbers = 0x04,
|
|
|
|
CborPrettyShowStringFragments = 0x100,
|
|
CborPrettyMergeStringFragments = 0,
|
|
|
|
CborPrettyDefaultFlags = CborPrettyIndicateIndeterminateLength
|
|
};
|
|
|
|
/* cf https://sourceforge.net/p/mingw-w64/wiki2/gnu%20printf/ */
|
|
typedef CborError(*CborStreamFunction)(void *token, const char *fmt, ...)
|
|
#if defined(__MINGW32__) || defined(__MINGW64__)
|
|
__attribute__((format(__MINGW_PRINTF_FORMAT, 2, 3)));
|
|
#elif defined(__GNUC__)
|
|
__attribute__((__format__(printf, 2, 3)))
|
|
#endif
|
|
;
|
|
|
|
CBOR_API CborError cbor_value_to_pretty_stream(CborStreamFunction streamFunction, void *token, CborValue *value, int flags);
|
|
|
|
/* The following API requires a hosted C implementation (uses FILE*) */
|
|
#if !defined(__STDC_HOSTED__) || __STDC_HOSTED__-0 == 1
|
|
CBOR_API CborError cbor_value_to_pretty_advance_flags(FILE *out, CborValue *value, int flags);
|
|
CBOR_API CborError cbor_value_to_pretty_advance(FILE *out, CborValue *value);
|
|
CBOR_INLINE_API CborError cbor_value_to_pretty(FILE *out, const CborValue *value) {
|
|
CborValue copy = *value;
|
|
return cbor_value_to_pretty_advance_flags(out, ©, CborPrettyDefaultFlags);
|
|
}
|
|
#endif /* __STDC_HOSTED__ check */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* CBOR_H */
|
|
|