20.1.8 ead_put_array_value() (concatenates and stores multiple values)

(1) Description

This function concatenates multiple values and then stores the values by associating them with keys.

You can acquire concatenated values by retrieving the stored values.

To Page Top

(2) Format

#include <eads.h>
void ead_put_array_value
(
  const EAD_CACHE             *cp,            /* In */
  const char                  * key,          /* In */
  size_t                      array_length,   /* In */
  const ead_value_element     * value_array,  /* In */
  int                         * error_code    /* Out */
);

To Page Top

(3) Arguments

cp

Specifies the handle (pointer) to the cache where the key and value are to be stored.

Specify the handle obtained from ead_start_cache().

key

Specifies the key to associate with the value.

For details about the data types that can be specified, see 15.2.2(1) Data types that can be specified as keys.

array_length

Specifies the number of elements in the value array to be stored.

value_array

Specifies a pointer to the top of the value array to be stored.

error_code

Specifies the pointer from which to retrieve the error code.

For details about error codes, see 20.2 Error codes in the client library (C).

To Page Top

(4) Notes

• A value of zero cannot be specified in array_length. If an invalid value is specified, operation is not guaranteed.

• For the array of ead_value_element structures, make sure that you allocate a contiguous memory area large enough for the elements.

• There is no limit to the number of elements in the value array to be stored or their sizes. For the size of concatenated data, specify a value that does not exceed the maximum size of data that can be accepted by the EADS servers.

To Page Top