abfNewComponent()

Adds a new component (data sub-field) to the currently open datatype.

Syntax

intabfNewComponent(const char *name);

Inputs

name: The name of the component to be created.

Return Value

0: On success
2: On failure

Example

int ret;
ret = abfNewComponent("Upper Torso");
if (ret)
{
/* post error message */
}

Comments

This function must be called after a datatype has been opened.

It is possible to have two components in a single datatype with the same name. However, it would be impossible to read data from the second one in the program.

Multiple datatypes may contain components with the same name.

abfNewComponent() is also known as abfCreateComponent().