|
1 | 1 | /***
|
2 | 2 | * ==++==
|
3 | 3 | *
|
4 |
| -* Copyright (c) Microsoft Corporation. All rights reserved. |
| 4 | +* Copyright (c) Microsoft Corporation. All rights reserved. |
5 | 5 | * Licensed under the Apache License, Version 2.0 (the "License");
|
6 | 6 | * you may not use this file except in compliance with the License.
|
7 | 7 | * You may obtain a copy of the License at
|
8 | 8 | * http://www.apache.org/licenses/LICENSE-2.0
|
9 |
| -* |
| 9 | +* |
10 | 10 | * Unless required by applicable law or agreed to in writing, software
|
11 | 11 | * distributed under the License is distributed on an "AS IS" BASIS,
|
12 | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
@@ -94,7 +94,7 @@ namespace web {
|
94 | 94 | }
|
95 | 95 | return *this;
|
96 | 96 | }
|
97 |
| - |
| 97 | + |
98 | 98 | _ASYNCRTIMP utility::string_t join();
|
99 | 99 |
|
100 | 100 | utility::string_t m_scheme;
|
@@ -138,11 +138,11 @@ namespace web {
|
138 | 138 | /// ('/path?query#frag').
|
139 | 139 | ///
|
140 | 140 | /// This implementation does not provide any scheme-specific handling -- an example of this
|
141 |
| - /// would be the following: 'http://path1/path'. This is a valid URI, but it's not a valid |
142 |
| - /// http-uri -- that is, it's syntactically correct but does not conform to the requirements |
143 |
| - /// of the http scheme (http requires a host). |
144 |
| - /// We could provide this by allowing a pluggable 'scheme' policy-class, which would provide |
145 |
| - /// extra capability for validating and canonicalizing a URI according to scheme, and would |
| 141 | + /// would be the following: 'http://path1/path'. This is a valid URI, but it's not a valid |
| 142 | + /// http-uri -- that is, it's syntactically correct but does not conform to the requirements |
| 143 | + /// of the http scheme (http requires a host). |
| 144 | + /// We could provide this by allowing a pluggable 'scheme' policy-class, which would provide |
| 145 | + /// extra capability for validating and canonicalizing a URI according to scheme, and would |
146 | 146 | /// introduce a layer of type-safety for URIs of differing schemes, and thus differing semantics.
|
147 | 147 | ///
|
148 | 148 | /// One issue with implementing a scheme-independent URI facility is that of comparing for equality.
|
@@ -178,15 +178,15 @@ namespace web {
|
178 | 178 |
|
179 | 179 | /// <summary>
|
180 | 180 | /// Encodes a URI component according to RFC 3986.
|
181 |
| - /// Note if a full URI is specified instead of an individual URI component all |
| 181 | + /// Note if a full URI is specified instead of an individual URI component all |
182 | 182 | /// characters not in the unreserved set are escaped.
|
183 | 183 | /// </summary>
|
184 | 184 | /// <param name="raw">The URI as a string.</param>
|
185 | 185 | /// <returns>The encoded string.</returns>
|
186 | 186 | _ASYNCRTIMP static utility::string_t __cdecl encode_uri(const utility::string_t &raw, uri::components::component = components::full_uri);
|
187 | 187 |
|
188 | 188 | /// <summary>
|
189 |
| - /// Encodes a string by converting all characters except for RFC 3986 unreserved characters to their |
| 189 | + /// Encodes a string by converting all characters except for RFC 3986 unreserved characters to their |
190 | 190 | /// hexadecimal representation.
|
191 | 191 | /// </summary>
|
192 | 192 | /// <param name="utf8data">The UTF-8 string data.</param>
|
@@ -227,14 +227,14 @@ namespace web {
|
227 | 227 | uri() { m_uri = _XPLATSTR("/");};
|
228 | 228 |
|
229 | 229 | /// <summary>
|
230 |
| - /// Creates a URI from the given encoded string. This will throw an exception if the string |
| 230 | + /// Creates a URI from the given encoded string. This will throw an exception if the string |
231 | 231 | /// does not contain a valid URI. Use uri::validate if processing user-input.
|
232 | 232 | /// </summary>
|
233 | 233 | /// <param name="uri_string">A pointer to an encoded string to create the URI instance.</param>
|
234 | 234 | _ASYNCRTIMP uri(const utility::char_t *uri_string);
|
235 | 235 |
|
236 | 236 | /// <summary>
|
237 |
| - /// Creates a URI from the given encoded string. This will throw an exception if the string |
| 237 | + /// Creates a URI from the given encoded string. This will throw an exception if the string |
238 | 238 | /// does not contain a valid URI. Use uri::validate if processing user-input.
|
239 | 239 | /// </summary>
|
240 | 240 | /// <param name="uri_string">An encoded URI string to create the URI instance.</param>
|
|
0 commit comments