This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.



Change existing values in HeaderField array


fields = changeFields(fields,FieldName1,FieldValue1,...,FieldNameN,FieldValueN)
fields = changeFields(fields,newFields)


fields = changeFields(fields,FieldName1,FieldValue1,...,FieldNameN,FieldValueN) changes the existing fields in each header field with the specified names to the indicated values and returns the updated array.

Name matching is case-insensitive. However, if you specify a name that differs in case from the existing field name, then the field name changes to the specified name. This usage does not change the class of an existing field.

This method throws an error when:

  • All the specified fields are not already in the header.

  • There is more than one field with the specified name.

fields = changeFields(fields,newFields) changes the existing fields in each header field to the names, values, and types specified in fields. This syntax might change the class of an existing field if the field name is a case-insensitive match to a name in fields.

Input Arguments

expand all

Header fields, specified as an array of objects.

Header field name, specified as a string.

Header field value, specified as a string or any type valid for fName. To use the default value for the field, set fValue to ''. If the last value is missing, then it is the same as specifying [].

Fields to add, specified as a vector or comma-separated list of one or more objects.

Introduced in R2018a