Схема URI, иногда названная протоколом, появляясь перед :// символы в виде строки или вектора символов. Scheme всегда возвращает строку. Если не пустой, то Scheme должен быть http или https. Однако это соглашение не осуществляется. MATLAB^® не поддерживает другие схемы, такие как file.

Пример: http

Пример: https

Информация о пользователе в виде строки или вектора символов. UserInfo появляется перед Host свойство сопровождается @ символ. string процент метода - кодирует специальные символы. Когда установка UserInfo, не кодируйте значение.

Пример: name

Пример: name:password

Имя хоста в виде строки или вектора символов. Значение находится в формате Системы доменных имен (DNS) или как адрес версии 4 (IPv4) или версии 6 (IPv6) межсетевого протокола. string процент метода - кодирует символы, которые не позволены в части, относящейся к хосту URI. Символы точки (.) неизменны. Когда установка Host, не кодируйте значение.

Пример: www.mathworks.com

Пример: 2222:7344:0db8:0000:0100:8a2e:0370:85a3 Адрес IPv6

Номер порта в виде номера, или как строка или вектор символов, представляющий номер в области значений 0–65535, сохраненный как uint16.

Пример: 8000

Сегменты пути в виде вектора строки или строки или как вектор символов или массив ячеек из символьных векторов. Результатом всегда является вектор из строк. Чтобы видеть значение закодированного пути, используйте EncodedPath свойство.

Путь в URI задан EncodedPath свойство. EncodedPath серия сегментов, разделенных / символ, где каждый из тех сегментов является членом Path.

Path(1)/Path(2)/Path(3)/.../Path(end)

/ символы не появляются в Path, но EncodedPath содержит их. Например,

uri = matlab.net.URI;
uri.Path = {'products' 'matlab'};
P = uri.Path

P = 
    "products"    "matlab"

EP = uri.EncodedPath

EP = products/matlab

Если вы устанавливаете Path к вектору символов или скалярной строке, которая содержит / символ, затем значение разделено в сегменты в / 'characters'. Результат совпадает с определением вектора из строк или массива ячеек из символьных векторов.

uri.Path = 'products/matlab';
P = uri.Path

P = 
    "products"    "matlab"

Всегда существует еще один Path сегмент, чем количество / символы в EncodedPath. Любой сегмент может быть пустой строкой. Если Path(1) пустая строка, затем EncodedPath начинается с /. Если Path(end) пустая строка, затем EncodedPath endsWith.

uri.Path = '/products/matlab/';
EP = uri.EncodedPath

EP = /products/matlab/

Когда установка Path к нескалярному массиву строк или массиву ячеек, символы, не позволенные во фрагменте пути URI, закодированы процентом в EncodedPath. Включать # символ,

uri.Path = {'foo#bar'};EP = uri.EncodedPath

EP = foo%23bar

Не кодируйте # символ. Если вы делаете, то закодированные символы закодированы снова.

uri.Path = {'foo%23Fbar'};
EP = uri.EncodedPath

EP = foo%2523Fbar

Path может быть относительным или абсолютным. Абсолютный путь один больше чем с одним сегментом, первый сегмент которого пуст. Это закодировано как строка, начинающаяся с / символ сопровождается второй строкой. Это определение абсолютного пути соответствует path-absolute, заданный в разделе RFC 3986 3.3. Относительный путь является тем, первая строка которого непуста. Это закодировано без ведущего /. Например, создайте абсолютный путь:

uri1 = matlab.net.URI;
uri1.Path = {'' 'products' 'matlab'};
EP = uri1.EncodedPath

EP = /products/matlab

Создайте относительный путь:

uri2 = matlab.net.URI;
uri2.Path = {'products' 'matlab'};
EP = uri2.EncodedPath

EP = products/matlab

Если URI содержит Scheme, HostUserInfo или Port свойство и Path не пусто, затем EncodedPath имеет ведущий /. / символ разделяет Path из других свойств. Поэтому различие между абсолютными и относительными путями существует только для URIs, которые не содержат Scheme, HostUserInfo , или Port свойства. Например, uri1 абсолютный путь.

uri1.EncodedPath

ans = /products/matlab

Установите Host:

uri1.Host = 'www.mathworks.com';
disp(string(uri1))

//www.mathworks.com/products/matlab

Установите Host из относительного пути uri2:

uri2.EncodedPath

ans = products/matlab

uri2.Host = 'www.mathworks.com';
disp(string(uri2))

//www.mathworks.com/products/matlab

Чтобы создать URI с путем, который указывает на корень, устанавливает Path к string.empty или ["" ""].

uri.Path = {'products' 'matlab' ''};
EP = uri.EncodedPath

EP = products/matlab/

Установить Path к папке добавьте пустую строку в конец вектора. Это соглашение добавляет запаздывающий / к EncodedPath.

uri.Path = {'products' 'matlab' ''};
EP = uri.EncodedPath

EP = products/matlab/

Запрос URI в виде вектора из matlab.net.QueryParameter объекты или строка, содержащая закодированный запрос с дополнительным ведущим ? символ.

Направление к вторичному ресурсу в виде строки или вектора символов. string процент метода - кодирует символы, которые не позволены во фрагменте фрагмента URI. Когда установка Fragment, не кодируйте значение.

Пример: в URI https://www.mathworks.com/help/matlab/ref/weboptions.html#examples, Fragment свойством является examples.

Является ли URI абсолютным в виде true или false. Абсолютный URI имеет непустой Scheme свойство. Если URI не является абсолютным, то это относительно. Для определения absolute-URI, смотрите Унифицированный идентификатор ресурса (URI) RFC 3986: Типовой Синтаксис — Раздел 4,3 Абсолютных URI.

Path свойство в абсолютном URI всегда обрабатывается как абсолютный путь и EncodedPath свойство всегда содержит ведущий / символ. Чтобы отправить сообщение, URI должен быть абсолютным и должен также содержать непустой Host свойство.

Типы данных: логический

Закодированный фрагмент полномочий URI в виде строки или вектора символов со связанным появлением пунктуации, только если свойство непусто. Формат EncodedAuthority UserInfo@HostПорт. Установка EncodedAuthority ярлык установке UserInfo, Host, и Port свойства, за исключением того, что необходимо закодировать специальные символы.

Пример: в URI https://user:pwd@www.mathworks.com:8000/product/matlab?abc=def&this=that#xyz, EncodedAuthority свойством является user:pwd@www.mathworks.com:8000.

Закодированный путь в виде строки или вектора символов. Считайте это свойство получить Path свойство как закодированная строка, как это появилось бы в закодированном URI. Если у вас есть уже закодированный путь как строка, то установленный EncodedPath свойство вместо Path свойство предотвратить далее кодирование. При чтении EncodedPath, это имеет ведущий / если Path не [] и существуют непустые компоненты в URI перед Path.

Установка EncodedPath к пустому массиву ('', [] или string.empty) эквивалентно установке Path к тому значению.

Если нет никакого Path свойство в закодированном URI, затем EncodedPath возвращает пустую строку, "". Однако EncodedPath никогда не пустой массив.

Пример: в URI https://www.mathworks.com/solutions/robotics, EncodedPath свойством является /solutions/robotics.

Закодированный запрос в виде строки или вектора символов. EncodedQuery возвращает то же значение как вызов string метод на Query свойство. Установка EncodedQuery эквивалентно установке Query свойство.

Пример: в URI https://www.mathworks.com/support/search_results.html?q=+weboptions+product:"MATLAB+Compiler", EncodedQuery свойством является q=+weboptions+product:%22MATLAB+Compiler%22.

Целый закодированный URI в виде строки или вектора символов. EncodedURI возвращает то же значение как matlab.net.URI.string метод. Установка EncodedURI эквивалентно вызову URI конструктор с 'literal' аргумент.