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