NAME¶

Mat_VarGetStructFieldByName — Gets a structure field by field name.

SYNOPSIS¶

#include <matio.h>

matvar_t *
Mat_VarGetStructFieldByName(const matvar_t *matvar, const char *field_name, size_t index);

DESCRIPTION¶

The Mat_VarGetStructFieldByName() function returns a pointer to the field named field_name for the structure element at linear index index in the structure variable matvar. The function requires matvar to be a valid structure or object variable.

RETURN VALUES¶

On success, a pointer to the requested field is returned. Otherwise NULL is returned.

EXAMPLES¶

This example gets a structure field by name.

matvar_t *field;

field = Mat_VarGetStructFieldByName(matvar, "field1", 0);

SEE ALSO¶

Mat_VarGetStructField(3), Mat_VarGetStructFieldByIndex(3), Mat_VarGetStructFieldnames(3), Mat_VarGetNumberOfFields(3)