splinter_client_set_tandem(): Tandem Slot Config

Tandem slots are useful when you need to group independent signals from the same sensor together with independent vectors per-sensor.Or, more laconically: tandem slots let you capture standard orders and their vectors as independent copies of the same variable.

In your experiment, where you have:

• x(thing): Normalized (thing)
• ẋ(thing): Velocity Of (thing)
• ẍ(thing): Acceleration Of (thing)

You could access these and their vectors in splinter as x, x.1 and x.2 independently and respectively.

Tandem setup makes sure housekeeping works on all I/O (including unset) so that you don't have to worry about it. There's no hard limit to how many orders of the same key you can have, except the number of slots.

See the constants documentation for information on how to change the special accessor (.) to something less likely to appear in your own key space.

Prototype & Rationale

int splinter_client_set_tandem(const char *base_key, const void **vals const size_t *lens, uint8_t orders);

The base_key is the string identifier for the parent (x) slot. vals is an array of void pointers, to temporarily hold the child keys while the tandem slots are created. lens is an array of size_t used side-by-side with vals to track the arena length. orders are the number of tandem slots being requested.

Return Value:

On success, 0 is returned. Return values less than zero indicate failure. errno currently is not set, but future versions will likely change that.

Example:

See CLI & Tooling Examples.

CLI & Tooling Example Uses:

To see splinter_client_set_tandem() in-use within the tools that ship with Splinter, see the following files:

See Also:

The following is also relevant: splinter_client_unset_tandem()