Source code

Revision control

Copy as Markdown

Other Tools

/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at */
#ifndef mozilla_dom_MimeType_h
#define mozilla_dom_MimeType_h
#include "mozilla/TextUtils.h"
#include "nsTHashMap.h"
#include "nsTArray.h"
template <typename char_type>
struct HashKeyType;
template <>
struct HashKeyType<char16_t> {
using HashType = nsStringHashKey;
template <>
struct HashKeyType<char> {
using HashType = nsCStringHashKey;
template <typename char_type>
class TMimeType final {
~TMimeType() = default;
class ParameterValue : public nsTString<char_type> {
bool mRequiresQuoting;
ParameterValue() : mRequiresQuoting(false) {}
static nsTArray<nsTDependentSubstring<char_type>> SplitMimetype(
const nsTSubstring<char_type>& aMimeType);
bool mIsBase64{false};
nsTString<char_type> mType;
nsTString<char_type> mSubtype;
nsTHashMap<typename HashKeyType<char_type>::HashType, ParameterValue>
nsTArray<nsTString<char_type>> mParameterNames;
TMimeType(const nsTSubstring<char_type>& aType,
const nsTSubstring<char_type>& aSubtype)
: mType(aType), mSubtype(aSubtype) {}
static RefPtr<TMimeType<char_type>> Parse(
const nsTSubstring<char_type>& aMimeType);
// @param aMimeType - the mimetype string
// @param aOutEssence - will hold the value of the content-type
// @param aOutCharset - will hold the value of the charset
// @return true if the mimetype was parsed, false otherwise.
static bool Parse(const nsTSubstring<char_type>& aMimeType,
nsTSubstring<char_type>& aOutEssence,
nsTSubstring<char_type>& aOutCharset);
void Serialize(nsTSubstring<char_type>& aStr) const;
// Returns the `<mType>/<mSubtype>`
void GetEssence(nsTSubstring<char_type>& aOutput) const;
bool IsBase64() const { return mIsBase64; }
// @param aName - the name of the parameter
// @return true if the parameter name is found, false otherwise.
bool HasParameter(const nsTSubstring<char_type>& aName) const;
// @param aName - the name of the parameter
// @param aOutput - will hold the value of the parameter (quoted if necessary)
// @param aAppend - if true, the method will append to the string;
// otherwise the string is truncated before appending.
// @param aWithQuotes - if true, output can contain quoted string
// @return true if the parameter name is found, false otherwise.
bool GetParameterValue(const nsTSubstring<char_type>& aName,
nsTSubstring<char_type>& aOutput, bool aAppend = false,
bool aWithQuotes = true) const;
// @param aName - the name of the parameter
// @param aValue - the value of the parameter
void SetParameterValue(const nsTSubstring<char_type>& aName,
const nsTSubstring<char_type>& aValue);
using MimeType = TMimeType<char16_t>;
using CMimeType = TMimeType<char>;
#endif // mozilla_dom_MimeType_h