Create a new attribute. More...

Collaboration diagram for ioda_has_attributes_create:

Macros
#define	IODA_HAS_ATTRIBUTES_CREATE_TEMPLATE(funcnamestr, junk)
	See ioda_has_attributes_create . More...

Functions
	C_TEMPLATE_FUNCTION_DECLARATION (ioda_has_attributes_create, IODA_HAS_ATTRIBUTES_CREATE_TEMPLATE)

Detailed Description

Create a new attribute.

This is documentation for a series of functions in C that attempt to emulate C++ templates using macro magic. The template parameter SUFFIX is written into the function name. Ex:, to create an integer attribute, call ioda_has_attributes_create_int.

Template Parameters

SUFFIX is the type (int, long, int64_t) that is appended to this function name in the C interface.

Parameters

has_atts[in]	is the container of the attribute. Attributes can be attached to Groups or Variables.
name[in]	is the name of the new attribute. This name must not already exist.
sz_name	is strlen(name). Fortran compatability.
n_dims	is the dimensionality of the new attribute.
dims	is an array of dimension lengths of the new attribute. The array must be of rank n_dims.

See also: ioda_group_atts for a method to get a group's associated has_attributes object.; ioda_variable_atts for a method to get a variable's associated has_attributes object.

Returns: the new attribute on success.; NULL on failure.

Precondition: has_atts must be valid. The variable or group associated with has_atts must still exist.; name must be a valid name. No attribute with this name should exist in has_atts.; dims must be valid and have the rank of n_dims.