1 // Copyright (c) 2010 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_MIME_UTIL_H__ 6 #define NET_BASE_MIME_UTIL_H__ 7 #pragma once 8 9 #include <string> 10 #include <vector> 11 12 #include "base/file_path.h" 13 14 namespace net { 15 16 // Get the mime type (if any) that is associated with the given file extension. 17 // Returns true if a corresponding mime type exists. 18 bool GetMimeTypeFromExtension(const FilePath::StringType& ext, 19 std::string* mime_type); 20 21 // Get the mime type (if any) that is associated with the given file. Returns 22 // true if a corresponding mime type exists. 23 bool GetMimeTypeFromFile(const FilePath& file_path, std::string* mime_type); 24 25 // Get the preferred extension (if any) associated with the given mime type. 26 // Returns true if a corresponding file extension exists. The extension is 27 // returned without a prefixed dot, ex "html". 28 bool GetPreferredExtensionForMimeType(const std::string& mime_type, 29 FilePath::StringType* extension); 30 31 // Check to see if a particular MIME type is in our list. 32 bool IsSupportedImageMimeType(const char* mime_type); 33 bool IsSupportedMediaMimeType(const char* mime_type); 34 bool IsSupportedNonImageMimeType(const char* mime_type); 35 bool IsSupportedJavascriptMimeType(const char* mime_type); 36 37 // Get whether this mime type should be displayed in view-source mode. 38 // (For example, XML.) 39 bool IsViewSourceMimeType(const char* mime_type); 40 41 // Convenience function. 42 bool IsSupportedMimeType(const std::string& mime_type); 43 44 // Returns true if this the mime_type_pattern matches a given mime-type. 45 // Checks for absolute matching and wildcards. mime-types should be in 46 // lower case. 47 bool MatchesMimeType(const std::string &mime_type_pattern, 48 const std::string &mime_type); 49 50 // Returns true if and only if all codecs are supported, false otherwise. 51 bool AreSupportedMediaCodecs(const std::vector<std::string>& codecs); 52 53 // Parses a codec string, populating |codecs_out| with the prefix of each codec 54 // in the string |codecs_in|. For example, passed "aaa.b.c,dd.eee", if 55 // |strip| == true |codecs_out| will contain {"aaa", "dd"}, if |strip| == false 56 // |codecs_out| will contain {"aaa.b.c", "dd.eee"}. 57 // See http://www.ietf.org/rfc/rfc4281.txt. 58 void ParseCodecString(const std::string& codecs, 59 std::vector<std::string>* codecs_out, 60 bool strip); 61 62 // Check to see if a particular MIME type is in our list which only supports a 63 // certain subset of codecs. 64 bool IsStrictMediaMimeType(const std::string& mime_type); 65 66 // Check to see if a particular MIME type is in our list which only supports a 67 // certain subset of codecs. Returns true if and only if all codecs are 68 // supported for that specific MIME type, false otherwise. If this returns 69 // false you will still need to check if the media MIME tpyes and codecs are 70 // supported. 71 bool IsSupportedStrictMediaMimeType(const std::string& mime_type, 72 const std::vector<std::string>& codecs); 73 74 // Get the extensions for images files. 75 // Note that we do not erase the existing elements in the the provided vector. 76 // Instead, we append the result to it. 77 void GetImageExtensions(std::vector<FilePath::StringType>* extensions); 78 79 // Get the extensions for audio files. 80 // Note that we do not erase the existing elements in the the provided vector. 81 // Instead, we append the result to it. 82 void GetAudioExtensions(std::vector<FilePath::StringType>* extensions); 83 84 // Get the extensions for video files. 85 // Note that we do not erase the existing elements in the the provided vector. 86 // Instead, we append the result to it. 87 void GetVideoExtensions(std::vector<FilePath::StringType>* extensions); 88 89 // Get the extensions associated with the given mime type. 90 // There could be multiple extensions for a given mime type, like "html,htm" 91 // for "text/html". 92 // Note that we do not erase the existing elements in the the provided vector. 93 // Instead, we append the result to it. 94 void GetExtensionsForMimeType(const std::string& mime_type, 95 std::vector<FilePath::StringType>* extensions); 96 97 } // namespace net 98 99 #endif // NET_BASE_MIME_UTIL_H__ 100