RTI Connext C API  Version 5.1.0
Sequence Number Support

<<eXtension>> Sequence number type and defines. More...

Data Structures

struct  DDS_SequenceNumber_t
 Type for sequence number representation. More...
 

Functions

void DDS_SequenceNumber_subtract (struct DDS_SequenceNumber_t *answer, const struct DDS_SequenceNumber_t *sn1, const struct DDS_SequenceNumber_t *sn2)
 Stores the value (sn1 - sn2) in answer.
 
void DDS_SequenceNumber_add (struct DDS_SequenceNumber_t *answer, const struct DDS_SequenceNumber_t *sn1, const struct DDS_SequenceNumber_t *sn2)
 Stores the value (sn1 + sn2) in answer.
 
void DDS_SequenceNumber_plusplus (struct DDS_SequenceNumber_t *sn)
 Increases the value of the input sequence number by one.
 
void DDS_SequenceNumber_minusminus (struct DDS_SequenceNumber_t *sn)
 Decreases the value of the input sequence number by one.
 
int DDS_SequenceNumber_compare (const struct DDS_SequenceNumber_t *sn1, const struct DDS_SequenceNumber_t *sn2)
 Compares two sequence numbers.
 

Variables

struct DDS_SequenceNumber_t DDS_SEQUENCE_NUMBER_UNKNOWN
 Unknown sequence number.
 
struct DDS_SequenceNumber_t DDS_SEQUENCE_NUMBER_ZERO
 Zero value for the sequence number.
 
struct DDS_SequenceNumber_t DDS_SEQUENCE_NUMBER_MAX
 Highest, most positive value for the sequence number.
 
struct DDS_SequenceNumber_t DDS_AUTO_SEQUENCE_NUMBER
 The sequence number is internally determined by RTI Connext.
 

Detailed Description

<<eXtension>> Sequence number type and defines.

Function Documentation

void DDS_SequenceNumber_subtract ( struct DDS_SequenceNumber_t answer,
const struct DDS_SequenceNumber_t sn1,
const struct DDS_SequenceNumber_t sn2 
)

Stores the value (sn1 - sn2) in answer.

Parameters
answer<<out>> Result sequence number. Cannot be NULL.
sn1<<in>> First sequence number. Cannot be NULL.
sn2<<in>> Second sequence number. Cannot be NULL.
void DDS_SequenceNumber_add ( struct DDS_SequenceNumber_t answer,
const struct DDS_SequenceNumber_t sn1,
const struct DDS_SequenceNumber_t sn2 
)

Stores the value (sn1 + sn2) in answer.

Parameters
answer<<out>> Result sequence number. Cannot be NULL.
sn1<<in>> First sequence number. Cannot be NULL.
sn2<<in>> Second sequence number. Cannot be NULL.
void DDS_SequenceNumber_plusplus ( struct DDS_SequenceNumber_t sn)

Increases the value of the input sequence number by one.

Parameters
sn<<inout>> Sequence number. Cannot be NULL.
void DDS_SequenceNumber_minusminus ( struct DDS_SequenceNumber_t sn)

Decreases the value of the input sequence number by one.

Parameters
sn<<inout>> Sequence number. Cannot be NULL.
int DDS_SequenceNumber_compare ( const struct DDS_SequenceNumber_t sn1,
const struct DDS_SequenceNumber_t sn2 
)

Compares two sequence numbers.

Parameters
sn1<<in>> Sequence number to compare. Cannot be NULL.
sn2<<in>> Sequence number to compare. Cannot be NULL.
Returns
If the two sequence numbers are equal, the function returns 0. If sn1 is greater than sn2 the function returns a positive number; otherwise, it returns a negative number.

Variable Documentation

struct DDS_SequenceNumber_t DDS_SEQUENCE_NUMBER_UNKNOWN

Unknown sequence number.

struct DDS_SequenceNumber_t DDS_SEQUENCE_NUMBER_ZERO

Zero value for the sequence number.

struct DDS_SequenceNumber_t DDS_SEQUENCE_NUMBER_MAX

Highest, most positive value for the sequence number.

struct DDS_SequenceNumber_t DDS_AUTO_SEQUENCE_NUMBER

The sequence number is internally determined by RTI Connext.


RTI Connext C API Version 5.1.0 Copyright © Mon Feb 3 2014 Real-Time Innovations, Inc