_QCBORItem Struct Reference

#include <qcbor_main_decode.h>

Data Fields
uint8_t	uDataType
uint8_t	uLabelType
uint8_t	uNestingLevel
uint8_t	uNextNestLevel
uint8_t	uDataAlloc
uint8_t	uLabelAlloc
union {
int64_t   int64
uint64_t   uint64
UsefulBufC   string
uint16_t   uCount
double   dfnum
float   fnum
struct {
int64_t   nSeconds
double   fSecondsFraction
}   epochDate
int64_t   epochDays
UsefulBufC   bigNum
uint8_t   uSimple
QCBORExpAndMantissa   expAndMantissa
uint64_t   uTagNumber
uint8_t   userDefined [24]
}	val
union {
int64_t   int64
uint64_t   uint64
UsefulBufC   string
}	label
QCBORMappedTagNumbers	auTagNumbers

Detailed Description

This holds a decoded data item. It is returned by the QCBORDecode_GetNext(), the principle decoding function. It holds the type, value, label, tags and other details of the decoded data item.

This is typically 56 bytes on 64-bit CPUs and 52 bytes on 32-bit CPUs (the CPU and the system's ABI determine this size).

Field Documentation

auTagNumbers

QCBORMappedTagNumbers auTagNumbers

PRIVATE MEMBER Use QCBORDecode_GetNthTagNumber() to retrieve tag numbers on an item. Also see CBORTags

In QCBOR v1 this was named uTags and was in the reverse order. It wasn't explicitly described as private, but was implicitly private.

bigNum

UsefulBufC bigNum

The value for uDataType QCBOR_TYPE_POSBIGNUM and QCBOR_TYPE_NEGBIGNUM.

dfnum

double dfnum

The value for uDataType QCBOR_TYPE_DOUBLE.

[struct]

struct { ... } epochDate

The value for uDataType QCBOR_TYPE_DATE_EPOCH, the number of seconds after or before Jan 1, 1970. This has a range of 500 billion years. Floating-point dates are converted to this integer + fractional value. If the input value is beyond the 500 billion-year range (e.g., +/i infinity, large floating point values, NaN) QCBOR_ERR_DATE_OVERFLOW will be returned. If the input is floating-point and QCBOR has been compiled with floating-point disabled, one of the various floating-point disabled errors will be returned.

epochDays

int64_t epochDays

The value for uDataType QCBOR_TYPE_DAYS_EPOCH – the number of days before or after Jan 1, 1970.

fnum

float fnum

The value for uDataType QCBOR_TYPE_FLOAT.

int64

int64_t int64

The value for uDataType QCBOR_TYPE_INT64.

The label for uLabelType for QCBOR_TYPE_INT64

[union]

union { ... } label

Union holding the different label types selected based on uLabelType

string

UsefulBufC string

The value for uDataType QCBOR_TYPE_BYTE_STRING and QCBOR_TYPE_TEXT_STRING. Also for many tags whose content is a string such QCBOR_TYPE_DAYS_STRING and QCBOR_TYPE_URI.

The label for uLabelType QCBOR_TYPE_BYTE_STRING and QCBOR_TYPE_TEXT_STRING

uCount

uint16_t uCount

The "value" for uDataType QCBOR_TYPE_ARRAY or QCBOR_TYPE_MAP, the number of items in the array or map. It is UINT16_MAX when decoding indefinite-lengths maps and arrays. Detection of the end of a map or array is best done with uNestLevel and uNextNestLevel so as to work for both definite and indefinite length maps and arrays.

uDataAlloc

uint8_t uDataAlloc

1 if a val that is a string is allocated with string allocator, 0 if not. Always 0 unless an allocator has been set up by calling QCBORDecode_SetMemPool() or QCBORDecode_SetUpAllocator().

uDataType

uint8_t uDataType

Tells what element of the val union to use. One of QCBOR_TYPE_INT64, QCBOR_TYPE_ARRAY, ...

uint64

uint64_t uint64

The value for uDataType QCBOR_TYPE_UINT64.

The label for uLabelType for QCBOR_TYPE_UINT64

uLabelAlloc

uint8_t uLabelAlloc

1 if a label that is a string is allocated with string allocator, 0 if not. Always 0 unless an allocator has been set up by calling QCBORDecode_SetMemPool() or QCBORDecode_SetUpAllocator().

uLabelType

uint8_t uLabelType

Tells what element of the label union to use. One of QCBOR_TYPE_INT64, QCBOR_TYPE_BYTE_STRING, ...

uNestingLevel

uint8_t uNestingLevel

Holds the nesting depth for arrays and map. 0 is the top level with no arrays or maps entered.

uNextNestLevel

uint8_t uNextNestLevel

Holds the nesting level of the next item after this one. If less than uNestingLevel, this item was the last one in an arry or map and it closed out at least one nesting level.

uSimple

uint8_t uSimple

See QCBOR_TYPE_UKNOWN_SIMPLE

[union]

union { ... } val

The union holding the item's value. Select union member based on uDataType.

---

The documentation for this struct was generated from the following file:

• /Users/lgl/Code/QCBOR/dev/inc/qcbor/qcbor_main_decode.h