matlab.net.QueryParameter class

Пакет: matlab.net

Параметр во фрагменте запроса унифицированного идентификатора ресурса (URI)

Описание

Используйте QueryParameter класс, чтобы создать строку запроса URI формы:

name1=value1&name2=value2&name3=value3

где каждый name=value сегментом является QueryParameter объект, преобразованный в строку с помощью string метод. string метод на векторе QueryParameter объекты соединяют результаты с помощью & символ. string метод преобразует любые значения в строки и выполняет все необходимое кодирование специальных символов в результате.

Конструкция

obj = matlab.net.QueryParameter создает пустой параметр запроса.

obj = matlab.net.QueryParameter(paramName,paramValue) создает вектор параметра запроса paramNameparamValue парные аргументы. Можно задать несколько пар аргумента в любом порядке как paramName1,paramValue1,...,paramNameN,paramValueN.

пример

obj = matlab.net.QueryParameter(qStruct) создает вектор параметра запроса из структуры.

пример

obj = matlab.net.QueryParameter(queryStr) синтаксические анализы queryStr в запрос.

obj = matlab.net.QueryParameter(___,Format) задает формат, который будет использоваться в нескалярных значениях и может включать любой из входных параметров в предыдущих синтаксисах.

Входные параметры

развернуть все

Название параметра, заданное как строка или вектор символов.

Значение параметров, заданное как тип, требуется paramName.

Название и значение параметра, заданное как структура. Поля qStruct задайте название и значение параметра.

Типы данных: struct

Название и значение параметра, заданное как строка или вектор символов. queryStr завершенный, закодированный запрос, как это появилось бы в URI с дополнительным ведущим ? символ.

queryStr разделен в & символы в отдельный name=value параметры запроса. Name свойство установлено в name и Value свойство установлено в value.

Триплет символов формы % и две шестнадцатеричных цифры представляют закодированный процентом байт. Последовательность этих байтов обработана, когда UTF-8 закодировал символы, которые декодируются, чтобы сформировать Name и Value свойства QueryParameters. Кроме того, любой знак "плюс" '+' в queryStr обработан как пробел '%20'. Когда QueryParameter преобразован назад в строку, любое необходимое кодирование процента выполняется только на символах, которые должны быть закодированы. Это действие сделано, были ли те символы первоначально закодированы в queryStr, так результат string метод не может точно совпадать с queryStr. Значение, однако, является тем же самым, когда используется в URI.

Например, UTF-8, кодирующие за евро, подписывают E2 82 AC.

q1 = matlab.net.QueryParameter('V=%e2%82%ac')
q1 = 

  QueryParameter with properties:

      Name: "V"
     Value: "€"
    Format: csv

+ и %20 символы обработаны как пробелы.

q2 = matlab.net.QueryParameter('V=a+b%20c')
q2 = 

  QueryParameter with properties:

      Name: "V"
     Value: "a b c"
    Format: csv

string метод реализует кодирование процента на символах, которые требуют кодирования. Например, закодирован.

string(q1)
ans = V=%E2%82%AC

Однако символы в queryStr аргумент 'V=a+b%20c' не нужно кодирование.

q3 = string(q2)
q3 = V=a+b+c

Несмотря на то, что результат string метод не совпадает с queryStr, значения идентичны, когда используется в URI.

Свойства

развернуть все

Название параметра, заданное как строка или вектор символов.

Значение параметров, заданное как вещественное число, логическое, datetime (со значением кроме NaT), строка, вектор символов, или вектор или вектор ячейки этих значений. Если Value любой другой тип, затем Value должен поддержать string или char методы, которые преобразуют значение в вектор символов. Если пустой, Value обработан как пустая строка.

Формат кодировки, заданный как matlab.net.ArrayFormat перечисление, чтобы использовать в кодировании Value если это - вектор.

Методы

'char'Закодированный параметр запроса как вектор символов
строкаЗакодированный параметр запроса как строка

Атрибуты

Sealedtrue

Примеры

свернуть все

Создайте имя поля структуры this и набор это к значению that.

qStruct.this = 'that';
QP = matlab.net.QueryParameter(qStruct)
QP = 
  QueryParameter with properties:

      Name: "this"
     Value: 'that'
    Format: csv

Создайте вектор символов с двумя запросами, this=that и one=2. QueryParameter метод разделяет qStr в & символ в два QueryParameter объекты.

qStr = '?this=that&one=2';
QPs = matlab.net.QueryParameter(qStr);

name=value пары в qStr задайте Name и Value свойства.

name1 = QPs(1).Name
name1 = 
"this"
value1 = QPs(1).Value
value1 = 
"that"
name2 = QPs(2).Name
name2 = 
"one"
value2 = QPs(2).Value
value2 = 
"2"

Введенный в R2017b

Для просмотра документации необходимо авторизоваться на сайте