RTI Connext DDS Micro C API  Version 4.0.1
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups
dds_c_sequence.h File Reference

DDS sequence definitions. More...

#include "dds_c/dds_c_dll.h"
#include "dds_c/dds_c_common.h"
#include "reda/reda_sequence.h"
#include <reda/reda_sequence_decl.h>

Data Structures

struct  FooSeq
 <<interface>> <<generic>> <<cert>> A type-safe, ordered collection of elements. The type of these elements is referred to in this documentation as "Foo". More...

Macros

#define DDS_SEQUENCE_INITIALIZER
 An initializer for new sequence instances.

Functions

DDS_Boolean FooSeq_initialize (struct FooSeq *self)
 <<cert>> Initialize sequence instances.
DDS_Boolean FooSeq_finalize (struct FooSeq *self)
 Finalize sequence instances.
DDS_Long FooSeq_get_maximum (const struct FooSeq *self)
 <<cert>> Get the current maximum number of elements that can be stored in this sequence.
DDS_Boolean FooSeq_set_maximum (struct FooSeq *self, DDS_Long new_max)
 <<cert>> Resize this sequence to a new desired maximum.
DDS_Boolean FooSeq_set_maximum_w_max (struct FooSeq *self, DDS_Long new_max, DDS_UnsignedLong max_size)
 <<cert>> Resize this sequence to a new desired maximum and allocate max_size + 1 bytes for each pointer element.
DDS_Long FooSeq_get_length (const struct FooSeq *self)
 <<cert>> Get the logical length of this sequence.
DDS_Boolean FooSeq_set_length (struct FooSeq *self, DDS_Long new_length)
 <<cert>> Change the length of this sequence.
Foo * FooSeq_get_reference (const struct FooSeq *self, DDS_Long i)
 <<cert>> Get the pointer to the i-th element of this sequence.
struct FooSeqFooSeq_copy (struct FooSeq *self, const struct FooSeq *src_seq)
 Copy elements from another sequence, resizing the sequence if necessary.
struct FooSeqFooSeq_copy_w_max (struct FooSeq *self, const struct FooSeq *src_seq, DDS_UnsignedLong max_size)
 Copy elements from another sequence, resizing the sequence if necessary.
DDS_Boolean FooSeq_is_equal (struct FooSeq *self, struct FooSeq *other)
 Checks whether two sequences have the same contents.
DDS_Boolean FooSeq_loan_contiguous (struct FooSeq *self, void *buffer, DDS_Long new_length, DDS_Long new_max)
 Loan a contiguous buffer to this sequence.
DDS_Boolean FooSeq_loan_discontiguous (struct FooSeq *self, void *buffer, DDS_Long new_length, DDS_Long new_max)
 Loan a discontiguous buffer to this sequence.
DDS_Boolean FooSeq_unloan (struct FooSeq *self)
 Return the loaned buffer in the sequence and set the maximum to 0.
DDS_Boolean FooSeq_has_ownership (const struct FooSeq *self)
 Return the value of the owned flag.
Foo * FooSeq_get_contiguous_buffer (struct FooSeq *self)
 Access the internal buffer of a sequence.
DDS_Boolean FooSeq_set_contiguous_buffer (struct FooSeq *self, Foo *buffer)
 Set the internal buffer of a sequence.
DDS_Boolean FooSeq_has_discontiguous_buffer (const struct FooSeq *self)
 Check whether a sequence uses a contiguous or discontiguous buffer for its elements.
DDS_Boolean FooSeq_set_token (const struct FooSeq *self, void *token1, void *token2)
 Sets tokens on a sequence.
DDS_Boolean FooSeq_get_token (const struct FooSeq *self, void **token1, void **token2)
 Gets tokens of a sequence.
DDS_Boolean FooSeq_ensure_length (struct FooSeq *self, DDS_Long length, DDS_Long max)
 Set the sequence to the desired length, and resize the sequence if necessary.
DDS_Boolean FooSeq_ensure_length_w_max (struct FooSeq *self, DDS_Long length, DDS_Long max, DDS_UnsignedLong max_size)
 Set the sequence to the desired length, and resize the sequence if necessary, and allocate each pointer element to max_size + 1 bytes.
DDS_Boolean FooSeq_from_array (struct FooSeq *self, const Foo array[], DDS_Long length)
 Copy elements from an array of elements, resizing the sequence if necessary. The original contents of the sequence (if any) are replaced.
DDS_Boolean FooSeq_from_array_w_max (struct FooSeq *self, const Foo array[], DDS_Long length, DDS_UnsignedLong max_size)
 Copy elements from an array of pointer elements, resizing the sequence if necessary, where each pointer elements has been preallocated to max_size. The original contents of the sequence (if any) are replaced.
DDS_Boolean FooSeq_to_array (struct FooSeq *self, const Foo array[], DDS_Long length)
 Copy elements to an array of elements. The original contents of the array (if any) are replaced.
DDS_Boolean FooSeq_to_array_w_max (struct FooSeq *self, const Foo array[], RTI_INT32 length, DDS_UnsignedLong max_size)
 Copy elements to an array of pointer elements, where each pointer element is pre-allocated. The original contents of the array (if any) are replaced.

Detailed Description

DDS sequence definitions.


RTI Connext DDS Micro C API Version 4.0.1 Copyright © Mon Jun 3 2024 Real-Time Innovations, Inc