Main Content

replaceFields

类: matlab.net.http.Message
包: matlab.net.http

在消息标头中更改值或添加字段

说明

msg = replaceFields(msg,FieldName1,FieldValue1,...,FieldNameN,FieldValueN) 将具有指定名称的字段替换为 FieldName1,FieldValue1,...,FieldNameN,FieldValueN 中指定的值,并返回更新后的消息。

此方法与 changeFields 方法相同,但是,如果不存在与名称或类匹配的字段,则该方法会在标头末尾添加一个新字段,而不是引发错误。

msg = replaceFields(msg,newFields) 将每条消息中的现有字段替换为 newFields 中指定的名称、值和类型,并返回更新后的消息。

输入参数

全部展开

消息,指定为 matlab.net.http.Message 对象。

由名称-值对组定义的字段。FieldName 指定为字符串或字符向量,FieldValue 指定为对 FieldName 有效的任何类型。

要使用此字段的默认值,请将 FieldValue 设置为 ''

如果最后一个值缺失,则相当于指定空值 ([])。

要匹配的名称,指定为下列值之一。

  • 字符串向量、字符向量、字符向量元胞数组或以逗号分隔的字符串或字符向量列表,其中包含要替换的字段的名称。名称不区分大小写。

  • 向量或由一个或多个 HeaderField 对象组成的逗号分隔列表,这些对象的 Name 属性用于决定要替换的字段。名称不区分大小写。标头字段值将被忽略。

  • 向量或以逗号分隔的 meta.class 对象列表,这些对象是 HeaderField 的子类。

    replaceFields 方法将搜索与指定类支持的名称相匹配的名称,而不管是什么类。如果某个子类没有一组特定的受支持名称,将匹配该子类的所有标头字段,而不管其名称为何。调用 HeaderField.displaySubclasses 方法可查看支持的名称。

版本历史记录

在 R2016b 中推出