2#define PROTON_CODEC_H 1
25#include <proton/import_export.h>
28#include <proton/type_compat.h>
417PN_EXTERN
int pn_data_vfill(
pn_data_t *data,
const char *fmt, va_list ap);
418PN_EXTERN
int pn_data_fill(
pn_data_t *data,
const char *fmt, ...);
419PN_EXTERN
int pn_data_vscan(
pn_data_t *data,
const char *fmt, va_list ap);
420PN_EXTERN
int pn_data_scan(
pn_data_t *data,
const char *fmt, ...);
499PN_EXTERN
bool pn_data_lookup(
pn_data_t *data,
const char *name);
pn_type_t
Identifies an AMQP type.
Definition codec.h:46
uint32_t pn_decimal32_t
A 32-bit decimal floating-point number.
Definition types.h:191
uint64_t pn_decimal64_t
A 64-bit decimal floating-point number.
Definition types.h:198
uint32_t pn_char_t
A 32-bit Unicode code point.
Definition types.h:184
int64_t pn_timestamp_t
A 64-bit timestamp in milliseconds since the Unix epoch.
Definition types.h:177
const char * pn_type_name(pn_type_t type)
Return a string name for an AMQP type.
@ PN_UUID
The UUID AMQP type.
Definition codec.h:136
@ PN_INT
The signed int AMQP type.
Definition codec.h:85
@ PN_ARRAY
An AMQP array.
Definition codec.h:163
@ PN_BOOL
The boolean AMQP type.
Definition codec.h:55
@ PN_MAP
An AMQP map.
Definition codec.h:174
@ PN_BYTE
The byte AMQP type.
Definition codec.h:65
@ PN_SHORT
The short AMQP type.
Definition codec.h:75
@ PN_ULONG
The ulong AMQP type.
Definition codec.h:95
@ PN_LIST
An AMQP list.
Definition codec.h:168
@ PN_USHORT
The unsigned short AMQP type.
Definition codec.h:70
@ PN_LONG
The long AMQP type.
Definition codec.h:100
@ PN_BINARY
The binary AMQP type.
Definition codec.h:141
@ PN_STRING
The string AMQP type.
Definition codec.h:147
@ PN_INVALID
A special invalid type value that is returned when no valid type is available.
Definition codec.h:180
@ PN_CHAR
The char AMQP type.
Definition codec.h:90
@ PN_UBYTE
The unsigned byte AMQP type.
Definition codec.h:60
@ PN_FLOAT
The float AMQP type.
Definition codec.h:111
@ PN_DOUBLE
The double AMQP type.
Definition codec.h:116
@ PN_UINT
The unsigned int AMQP type.
Definition codec.h:80
@ PN_TIMESTAMP
The timestamp AMQP type.
Definition codec.h:106
@ PN_DECIMAL64
The decimal64 AMQP type.
Definition codec.h:126
@ PN_SYMBOL
The symbol AMQP type.
Definition codec.h:153
@ PN_DECIMAL128
The decimal128 AMQP type.
Definition codec.h:131
@ PN_DECIMAL32
The decimal32 AMQP type.
Definition codec.h:121
@ PN_NULL
The NULL AMQP type.
Definition codec.h:50
@ PN_DESCRIBED
A described AMQP type.
Definition codec.h:158
A 128-bit decimal floating-point number.
Definition types.h:205
A 16-byte universally unique identifier.
Definition types.h:214
pn_type_t type
Indicates the type of value the atom is currently pointing to.
Definition codec.h:204
pn_atom_t pn_msgid_t
A type that holds scalar AMQP values that are valid for message id and correlation id fields.
Definition codec.h:311
A discriminated union that holds any scalar AMQP value.
Definition codec.h:199
A const byte buffer.
Definition types.h:223
int pn_data_put_symbol(pn_data_t *data, pn_bytes_t symbol)
Puts a PN_SYMBOL value.
int pn_data_put_decimal32(pn_data_t *data, pn_decimal32_t d)
Puts a PN_DECIMAL32 value.
int pn_data_append(pn_data_t *data, pn_data_t *src)
Append the contents of another pn_data_t object.
bool pn_data_enter(pn_data_t *data)
Sets the parent node to the current node and clears the current node.
pn_type_t pn_data_get_array_type(pn_data_t *data)
Return the array type if the current node points to an array, PN_INVALID otherwise.
int pn_data_put_double(pn_data_t *data, double d)
Puts a PN_DOUBLE value.
bool pn_data_is_array_described(pn_data_t *data)
Returns true if the current node points to a described array.
size_t pn_data_size(pn_data_t *data)
Returns the total number of nodes contained in a pn_data_t object.
int pn_data_put_byte(pn_data_t *data, int8_t b)
Puts a PN_BYTE value.
int pn_data_put_float(pn_data_t *data, float f)
Puts a PN_FLOAT value.
int pn_data_put_array(pn_data_t *data, bool described, pn_type_t type)
Puts an empty array value into a pn_data_t.
uint16_t pn_data_get_ushort(pn_data_t *data)
If the current node is an unsigned short, returns its value, returns 0 otherwise.
void pn_data_rewind(pn_data_t *data)
Clears current node pointer and sets the parent to the root node.
pn_type_t pn_data_type(pn_data_t *data)
Access the type of the current node.
void pn_data_free(pn_data_t *data)
Free a pn_data_t object.
size_t pn_data_get_list(pn_data_t *data)
If the current node is a list, return the number of elements, otherwise return zero.
pn_decimal64_t pn_data_get_decimal64(pn_data_t *data)
If the current node is a decimal64, returns its value, returns 0 otherwise.
pn_bytes_t pn_data_get_symbol(pn_data_t *data)
If the current node is a symbol, returns its value, returns "" otherwise.
int pn_data_put_ubyte(pn_data_t *data, uint8_t ub)
Puts a PN_UBYTE value.
int pn_data_put_bool(pn_data_t *data, bool b)
Puts a PN_BOOL value.
int pn_data_put_map(pn_data_t *data)
Puts an empty map value into a pn_data_t.
int32_t pn_data_get_int(pn_data_t *data)
If the current node is a signed int, returns its value, returns 0 otherwise.
void pn_data_dump(pn_data_t *data)
Dumps a debug representation of the internal state of the pn_data_t object that includes its navigati...
int pn_data_put_uint(pn_data_t *data, uint32_t ui)
Puts a PN_UINT value.
ssize_t pn_data_encode(pn_data_t *data, char *bytes, size_t size)
Writes the contents of a data object to the given buffer as an AMQP data stream.
pn_uuid_t pn_data_get_uuid(pn_data_t *data)
If the current node is a UUID, returns its value, returns None otherwise.
struct pn_data_t pn_data_t
An AMQP Data object.
Definition codec.h:374
int pn_data_put_uuid(pn_data_t *data, pn_uuid_t u)
Puts a PN_UUID value.
int pn_data_put_string(pn_data_t *data, pn_bytes_t string)
Puts a PN_STRING value.
pn_handle_t pn_data_point(pn_data_t *data)
Returns a handle for the current navigational state of a pn_data_t so that it can be later restored u...
int pn_data_put_decimal128(pn_data_t *data, pn_decimal128_t d)
Puts a PN_DECIMAL128 value.
bool pn_data_exit(pn_data_t *data)
Sets the current node to the parent node and the parent node to its own parent.
int pn_data_errno(pn_data_t *data)
Access the current error code for a given pn_data_t.
int pn_data_put_int(pn_data_t *data, int32_t i)
Puts a PN_INT value.
ssize_t pn_data_decode(pn_data_t *data, const char *bytes, size_t size)
Decodes a single value from the contents of the AMQP data stream into the current data object.
int pn_data_put_described(pn_data_t *data)
Puts a described value into a pn_data_t object.
uint8_t pn_data_get_ubyte(pn_data_t *data)
If the current node is a PN_UBYTE, return its value, otherwise return 0.
void pn_data_clear(pn_data_t *data)
Clears a pn_data_t object.
int pn_data_put_decimal64(pn_data_t *data, pn_decimal64_t d)
Puts a PN_DECIMAL64 value.
int64_t pn_data_get_long(pn_data_t *data)
If the current node is an signed long, returns its value, returns 0 otherwise.
int pn_data_put_long(pn_data_t *data, int64_t l)
Puts a PN_LONG value.
bool pn_data_restore(pn_data_t *data, pn_handle_t point)
Restores a prior navigational state that was saved using pn_data_point().
int pn_data_put_atom(pn_data_t *data, pn_atom_t atom)
Puts any scalar value value.
uint32_t pn_data_get_uint(pn_data_t *data)
If the current node is an unsigned int, returns its value, returns 0 otherwise.
int pn_data_put_list(pn_data_t *data)
Puts an empty list value into a pn_data_t.
bool pn_data_next(pn_data_t *data)
Advances the current node to its next sibling and returns true.
double pn_data_get_double(pn_data_t *data)
If the current node is a double, returns its value, returns 0 otherwise.
int pn_data_appendn(pn_data_t *data, pn_data_t *src, int limit)
Append up to n values from the contents of another pn_data_t object.
int pn_data_put_ushort(pn_data_t *data, uint16_t us)
Puts a PN_USHORT value.
pn_char_t pn_data_get_char(pn_data_t *data)
If the current node is a char, returns its value, returns 0 otherwise.
bool pn_data_prev(pn_data_t *data)
Moves the current node to its previous sibling and returns true.
int pn_data_format(pn_data_t *data, char *bytes, size_t *size)
Formats the contents of a pn_data_t object in a human readable way and writes them to the indicated l...
int8_t pn_data_get_byte(pn_data_t *data)
If the current node is a signed byte, returns its value, returns 0 otherwise.
void pn_data_narrow(pn_data_t *data)
Modify a pn_data_t object to behave as if the current node is the root node of the tree.
int pn_data_print(pn_data_t *data)
Prints the contents of a pn_data_t object using pn_data_format() to stdout.
size_t pn_data_get_array(pn_data_t *data)
If the current node is an array, return the number of elements in the array, otherwise return 0.
int pn_data_put_short(pn_data_t *data, int16_t s)
Puts a PN_SHORT value.
pn_data_t * pn_data(size_t capacity)
Construct a pn_data_t object with the supplied initial capacity.
void pn_data_widen(pn_data_t *data)
Reverse the effect of pn_data_narrow().
bool pn_data_is_null(pn_data_t *data)
Checks if the current node is a PN_NULL.
pn_decimal32_t pn_data_get_decimal32(pn_data_t *data)
If the current node is a decimal32, returns its value, returns 0 otherwise.
pn_error_t * pn_data_error(pn_data_t *data)
Access the current error for a given pn_data_t.
float pn_data_get_float(pn_data_t *data)
If the current node is a float, returns its value, returns 0 otherwise.
pn_atom_t pn_data_get_atom(pn_data_t *data)
If the current node is a scalar value, return it as a pn_atom_t.
pn_timestamp_t pn_data_get_timestamp(pn_data_t *data)
If the current node is a timestamp, returns its value, returns 0 otherwise.
int pn_data_put_timestamp(pn_data_t *data, pn_timestamp_t t)
Puts a PN_TIMESTAMP value.
int pn_data_put_ulong(pn_data_t *data, uint64_t ul)
Puts a PN_ULONG value.
pn_bytes_t pn_data_get_bytes(pn_data_t *data)
If the current node is a symbol, string, or binary, return the bytes representing its value.
int pn_data_put_char(pn_data_t *data, pn_char_t c)
Puts a PN_CHAR value.
bool pn_data_is_described(pn_data_t *data)
Checks if the current node is a described value.
size_t pn_data_get_map(pn_data_t *data)
If the current node is a map, return the number of child elements, otherwise return zero.
ssize_t pn_data_encoded_size(pn_data_t *data)
Returns the number of bytes needed to encode a data object.
bool pn_data_get_bool(pn_data_t *data)
If the current node is a PN_BOOL, returns its value.
pn_decimal128_t pn_data_get_decimal128(pn_data_t *data)
If the current node is a decimal128, returns its value, returns 0 otherwise.
int pn_data_put_binary(pn_data_t *data, pn_bytes_t bytes)
Puts a PN_BINARY value.
pn_bytes_t pn_data_get_binary(pn_data_t *data)
If the current node is binary, returns its value, returns "" otherwise.
uint64_t pn_data_get_ulong(pn_data_t *data)
If the current node is an unsigned long, returns its value, returns 0 otherwise.
int pn_data_copy(pn_data_t *data, pn_data_t *src)
Copy the contents of another pn_data_t object.
int pn_data_put_null(pn_data_t *data)
Puts a PN_NULL value.
pn_bytes_t pn_data_get_string(pn_data_t *data)
If the current node is a string, returns its value, returns "" otherwise.
int16_t pn_data_get_short(pn_data_t *data)
If the current node is a signed short, returns its value, returns 0 otherwise.
struct pn_error_t pn_error_t
An int error code and some string text to describe the error.
Definition error.h:45
const void * pn_handle_t
A type to represent the internal navigational state of a proton object.
Definition types.h:482