| OLD | NEW |
| (Empty) |
| 1 // Copyright 2013 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef NET_BASE_URL_UTIL_H_ | |
| 6 #define NET_BASE_URL_UTIL_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 | |
| 10 #include "base/compiler_specific.h" | |
| 11 #include "net/base/net_export.h" | |
| 12 #include "url/url_parse.h" | |
| 13 | |
| 14 class GURL; | |
| 15 | |
| 16 namespace net { | |
| 17 | |
| 18 // Returns a new GURL by appending the given query parameter name and the | |
| 19 // value. Unsafe characters in the name and the value are escaped like | |
| 20 // %XX%XX. The original query component is preserved if it's present. | |
| 21 // | |
| 22 // Examples: | |
| 23 // | |
| 24 // AppendQueryParameter(GURL("http://example.com"), "name", "value").spec() | |
| 25 // => "http://example.com?name=value" | |
| 26 // AppendQueryParameter(GURL("http://example.com?x=y"), "name", "value").spec() | |
| 27 // => "http://example.com?x=y&name=value" | |
| 28 NET_EXPORT GURL AppendQueryParameter(const GURL& url, | |
| 29 const std::string& name, | |
| 30 const std::string& value); | |
| 31 | |
| 32 // Returns a new GURL by appending or replacing the given query parameter name | |
| 33 // and the value. If |name| appears more than once, only the first name-value | |
| 34 // pair is replaced. Unsafe characters in the name and the value are escaped | |
| 35 // like %XX%XX. The original query component is preserved if it's present. | |
| 36 // | |
| 37 // Examples: | |
| 38 // | |
| 39 // AppendOrReplaceQueryParameter( | |
| 40 // GURL("http://example.com"), "name", "new").spec() | |
| 41 // => "http://example.com?name=value" | |
| 42 // AppendOrReplaceQueryParameter( | |
| 43 // GURL("http://example.com?x=y&name=old"), "name", "new").spec() | |
| 44 // => "http://example.com?x=y&name=new" | |
| 45 NET_EXPORT GURL AppendOrReplaceQueryParameter(const GURL& url, | |
| 46 const std::string& name, | |
| 47 const std::string& value); | |
| 48 | |
| 49 // Iterates over the key-value pairs in the query portion of |url|. | |
| 50 class NET_EXPORT QueryIterator { | |
| 51 public: | |
| 52 explicit QueryIterator(const GURL& url); | |
| 53 ~QueryIterator(); | |
| 54 | |
| 55 std::string GetKey() const; | |
| 56 std::string GetValue() const; | |
| 57 const std::string& GetUnescapedValue(); | |
| 58 | |
| 59 bool IsAtEnd() const; | |
| 60 void Advance(); | |
| 61 | |
| 62 private: | |
| 63 const GURL& url_; | |
| 64 url::Component query_; | |
| 65 bool at_end_; | |
| 66 url::Component key_; | |
| 67 url::Component value_; | |
| 68 std::string unescaped_value_; | |
| 69 | |
| 70 DISALLOW_COPY_AND_ASSIGN(QueryIterator); | |
| 71 }; | |
| 72 | |
| 73 // Looks for |search_key| in the query portion of |url|. Returns true if the | |
| 74 // key is found and sets |out_value| to the unescaped value for the key. | |
| 75 // Returns false if the key is not found. | |
| 76 NET_EXPORT bool GetValueForKeyInQuery(const GURL& url, | |
| 77 const std::string& search_key, | |
| 78 std::string* out_value); | |
| 79 | |
| 80 } // namespace net | |
| 81 | |
| 82 #endif // NET_BASE_URL_UTIL_H_ | |
| OLD | NEW |