getFields
Class: matlab.net.http.Message
Namespace: matlab.net.http
Return message header fields matching name or class
Description
Input Arguments
messages
— Messages
vector of matlab.net.http.Message
objects
Messages, specified as a vector of matlab.net.http.Message
objects.
Example: getFields([msg1,msg2],'Date')
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 return. Names are not case-sensitive.
Vector or comma-separated list of one or more
matlab.net.http.HeaderField
objects whoseName
properties are used to determine which fields to return. Names are not case-sensitive. Header field values in these objects are ignored.Vector or comma-separated list of
matlab.metadata.Class
objects that are subclasses ofHeaderField
.The
getFields
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')
Output Arguments
fields
— Fields matching input
array of matlab.net.http.HeaderField
objects
Fields matching input, returned as an array of matlab.net.http.HeaderField
objects. If no matches exist,
getFields
returns an empty
HeaderField
array. The name search is
case-insensitive.
indices
— Index values of fields
array of integers | []
Examples
Verify Required Field Added to Request Message
Add a missing Date header field to a request message using the RequestMessage.complete
method.
Create a request message to get text from the MathWorks® website.
uri = matlab.net.URI('https://www.mathworks.com');
req = matlab.net.http.RequestMessage;
Verify the message contains a Date field. The date value reflects your system information. The value indices{1} = []
indicates that req
does not contain a Date field.
request = complete(req,uri); [fields,indices] = getFields([req,request],?matlab.net.http.field.HTTPDateField)
fields = 1x0 HeaderField array with properties: Name Value
indices=1×2 cell array
{0x0 double} {1x0 double}
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)