Add support for the extended header parameter syntax in Content-Disposition h...

net/base/net_util.h

 // Copyright (c) 2010 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef NET_BASE_NET_UTIL_H_
 #define NET_BASE_NET_UTIL_H_
 #pragma once
 
 #include "build/build_config.h"
 
@@ skipping 24 matching lines @@
 namespace url_parse {
 struct Parsed;
 }
 
 namespace net {
 
 // Used by FormatUrl to specify handling of certain parts of the url.
 typedef uint32 FormatUrlType;
 typedef uint32 FormatUrlTypes;
 
+// Used by GetHeaderParamValue to determine how to handle quotes in the value.
+class QuoteRule {
+ public:
+  enum Type {
+    KEEP_OUTER_QUOTES,
+    REMOVE_OUTER_QUOTES,
+  };
+
+ private:
+  QuoteRule();
+};
+
 // Nothing is ommitted.
 extern const FormatUrlType kFormatUrlOmitNothing;
 
 // If set, any username and password are removed.
 extern const FormatUrlType kFormatUrlOmitUsernamePassword;
 
 // If the scheme is 'http://', it's removed.
 extern const FormatUrlType kFormatUrlOmitHTTP;
 
 // Omits the path if it is just a slash and there is no query or ref.  This is
@@ skipping 62 matching lines @@
 // Returns the empty string if the header is not found.
 std::wstring GetSpecificHeader(const std::wstring& headers,
                                const std::wstring& name);
 std::string GetSpecificHeader(const std::string& headers,
                               const std::string& name);
 
 // Return the value of the HTTP response header field's parameter named
 // 'param_name'.  Returns the empty string if the parameter is not found or is
 // improperly formatted.
 std::wstring GetHeaderParamValue(const std::wstring& field,
-                                 const std::wstring& param_name);
+                                 const std::wstring& param_name,
+                                 QuoteRule::Type quote_rule);
 std::string GetHeaderParamValue(const std::string& field,
-                                const std::string& param_name);
+                                const std::string& param_name,
+                                QuoteRule::Type quote_rule);
 
 // Return the filename extracted from Content-Disposition header. The following
 // formats are tried in order listed below:
 //
-// 1. RFC 2047
-// 2. Raw-8bit-characters :
+// 1. RFC 5987
+// 2. RFC 2047
+// 3. Raw-8bit-characters :
 //    a. UTF-8, b. referrer_charset, c. default os codepage.
-// 3. %-escaped UTF-8.
+// 4. %-escaped UTF-8.
 //
-// In step 2, if referrer_charset is empty(i.e. unknown), 2b is skipped.
-// In step 3, the fallback charsets tried in step 2 are not tried. We
+// In step 3, if referrer_charset is empty(i.e. unknown), 3b is skipped.
+// In step 4, the fallback charsets tried in step 3 are not tried. We
 // can consider doing that later.
 //
-// When a param value is ASCII, but is not in format #1 or format #3 above,
+// When a param value is ASCII, but is not in format #2 or format #4 above,
 // it is returned as it is unless it's pretty close to two supported
 // formats but not well-formed. In that case, an empty string is returned.
 //
 // In any case, a caller must check for the empty return value and resort to
 // another means to get a filename (e.g. url).
 //
 // This function does not do any escaping and callers are responsible for
 // escaping 'unsafe' characters (e.g. (back)slash, colon) as they see fit.
 //
 // TODO(jungshik): revisit this issue. At the moment, the only caller
@@ skipping 225 matching lines @@
 
 // Returns the port field of the sockaddr in |info|.
 uint16* GetPortFieldFromAddrinfo(const struct addrinfo* info);
 
 // Returns the value of |info's| port (in host byte ordering).
 int GetPortFromAddrinfo(const struct addrinfo* info);
 
 }  // namespace net
 
 #endif  // NET_BASE_NET_UTIL_H_