[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

H5Tinsert adds another member to the compound datatype type_id. The new member has a name which must be unique within the compound datatype. The offset argument defines the start of the member in an instance of the compound datatype, and field_id is the datatype identifier of the new member.

Syntax

Visual Basic (Declaration)
Public Shared Sub insert ( _
	compoundDataType As H5DataTypeId, _
	fieldName As String, _
	offset As UInteger, _
	fieldId As H5Type _
)
C#
public static void insert (
	H5DataTypeId compoundDataType,
	string fieldName,
	uint offset,
	H5T.H5Type fieldId
)
C++
public:
static void insert (
	H5DataTypeId^ compoundDataType, 
	String^ fieldName, 
	unsigned int offset, 
	H5Type fieldId
)

Parameters

compoundDataType (H5DataTypeId)
Identifier of compound data type to modify.
fieldName (String)
Name of the field to insert.
offset (UInt32)
Offset in memory structure of the field to insert.
fieldId (H5Type)
Datatype identifier of the field to insert.

Remarks

Members of a compound datatype do not have to be atomic datatypes; a compound datatype can have a member which is a compound datatype.

Exceptions

ExceptionCondition
HDF5DotNet.H5TinsertException throws H5TinsertException on failure.