removeFields
Class: matlab.net.http.Message
Namespace: matlab.net.http
Remove fields from message header
Description
Input Arguments
msg
— Message
matlab.net.http.Message
object
Message, specified as a matlab.net.http.Message
object.
ids
— Names to match
strings | matlab.net.http.HeaderField
objects | matlab.metadata.Class
objects
Names to match, specified as one of the following.
String vector, character vector, cell array of character vectors, or comma-separated list of strings or character vectors containing the names of the fields to remove. Names are not case-sensitive.
Vector or comma-separated list of one or more
HeaderField
objects whoseName
properties are used to determine which fields to remove. Names are not case-sensitive. Header field values are ignored.Vector or comma-separated list of
matlab.metadata.Class
objects that are subclasses ofHeaderField
.The
removeFields
method searches for names that match names supported by the specified classes, regardless of the class. If a subclass does not have a specific set of supported names, all header fields of that subclass are matched regardless of their names. Call theHeaderField.displaySubclasses
method to see supported names.
Example: getFields(response,'Date','Content-Type')
Examples
Remove Header Field from Request Message
Create a request message with two header fields, Cache-Control and Content-Type, and display the message.
import matlab.net.http.HeaderField m = matlab.net.http.RequestMessage('get'); f1 = HeaderField('Cache-Control','no-store, no-cache'); f2 = HeaderField('Content-Type','text/html;charset=utf-8'); m = addFields(m,f1,f2); show(m)
GET Cache-Control: no-store, no-cache Content-Type: text/html;charset=utf-8
Remove the Cache-Control field and display the updated message.
msg = removeFields(m,'Cache-Control');
show(msg)
GET Content-Type: text/html;charset=utf-8
Remove Header Field Subclasses
The MediaRangeField
class has two subclasses, AcceptField
and ContentTypeField
. An ID that specifies the MediaRangeField
class matches all fields of class MediaRangeField
, AcceptField
, and ContentTypeField
, plus any fields with the Name
property 'Accept'
or 'Content-Type'
.
Create message m
with a ContentTypeField
header field.
m = matlab.net.http.RequestMessage('get'); f = matlab.net.http.HeaderField('Content-Type','text/html;charset=utf-8'); m = addFields(m,f);
Remove all header fields that are subclasses of the MediaRangeField
class and display the updated message.
id = ?matlab.net.http.field.MediaRangeField; msg = removeFields(m,id); show(msg)
GET
Version History
Introduced in R2016b
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)