зеркало из https://github.com/mozilla/gecko-dev.git
127 строки
4.2 KiB
C++
127 строки
4.2 KiB
C++
/* -*- 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 http://mozilla.org/MPL/2.0/. */
|
|
// IWYU pragma: private, include "nsString.h"
|
|
|
|
#ifndef nsAString_h___
|
|
#define nsAString_h___
|
|
|
|
#include "nsStringFwd.h"
|
|
#include "nsStringIterator.h"
|
|
#include "mozilla/TypedEnumBits.h"
|
|
|
|
#include <string.h>
|
|
#include <stdarg.h>
|
|
|
|
#define kNotFound -1
|
|
|
|
namespace mozilla {
|
|
namespace detail {
|
|
// NOTE: these flags are declared public _only_ for convenience inside
|
|
// the string implementation. And they are outside of the string
|
|
// class so that the type is the same for both narrow and wide
|
|
// strings.
|
|
|
|
// bits for mDataFlags
|
|
enum class StringDataFlags : uint16_t
|
|
{
|
|
// Some terminology:
|
|
//
|
|
// "dependent buffer" A dependent buffer is one that the string class
|
|
// does not own. The string class relies on some
|
|
// external code to ensure the lifetime of the
|
|
// dependent buffer.
|
|
//
|
|
// "shared buffer" A shared buffer is one that the string class
|
|
// allocates. When it allocates a shared string
|
|
// buffer, it allocates some additional space at
|
|
// the beginning of the buffer for additional
|
|
// fields, including a reference count and a
|
|
// buffer length. See nsStringHeader.
|
|
//
|
|
// "adopted buffer" An adopted buffer is a raw string buffer
|
|
// allocated on the heap (using moz_xmalloc)
|
|
// of which the string class subsumes ownership.
|
|
//
|
|
// Some comments about the string data flags:
|
|
//
|
|
// SHARED, OWNED, and FIXED are all mutually exlusive. They
|
|
// indicate the allocation type of mData. If none of these flags
|
|
// are set, then the string buffer is dependent.
|
|
//
|
|
// SHARED, OWNED, or FIXED imply TERMINATED. This is because
|
|
// the string classes always allocate null-terminated buffers, and
|
|
// non-terminated substrings are always dependent.
|
|
//
|
|
// VOIDED implies TERMINATED, and moreover it implies that mData
|
|
// points to char_traits::sEmptyBuffer. Therefore, VOIDED is
|
|
// mutually exclusive with SHARED, OWNED, and FIXED.
|
|
|
|
TERMINATED = 1 << 0, // IsTerminated returns true
|
|
VOIDED = 1 << 1, // IsVoid returns true
|
|
SHARED = 1 << 2, // mData points to a heap-allocated, shared buffer
|
|
OWNED = 1 << 3, // mData points to a heap-allocated, raw buffer
|
|
FIXED = 1 << 4, // mData points to a fixed-size writable, dependent buffer
|
|
LITERAL = 1 << 5 // mData points to a string literal; DataFlags::TERMINATED will also be set
|
|
};
|
|
|
|
// bits for mClassFlags
|
|
enum class StringClassFlags : uint16_t
|
|
{
|
|
FIXED = 1 << 0, // |this| is of type nsTFixedString
|
|
NULL_TERMINATED = 1 << 1 // |this| requires its buffer is null-terminated
|
|
};
|
|
|
|
MOZ_MAKE_ENUM_CLASS_BITWISE_OPERATORS(StringDataFlags)
|
|
MOZ_MAKE_ENUM_CLASS_BITWISE_OPERATORS(StringClassFlags)
|
|
|
|
} // namespace detail
|
|
} // namespace mozilla
|
|
|
|
// declare nsAString
|
|
#include "string-template-def-unichar.h"
|
|
#include "nsTSubstring.h"
|
|
#include "string-template-undef.h"
|
|
|
|
// declare nsACString
|
|
#include "string-template-def-char.h"
|
|
#include "nsTSubstring.h"
|
|
#include "string-template-undef.h"
|
|
|
|
|
|
/**
|
|
* ASCII case-insensitive comparator. (for Unicode case-insensitive
|
|
* comparision, see nsUnicharUtils.h)
|
|
*/
|
|
class nsCaseInsensitiveCStringComparator
|
|
: public nsCStringComparator
|
|
{
|
|
public:
|
|
nsCaseInsensitiveCStringComparator()
|
|
{
|
|
}
|
|
typedef char char_type;
|
|
|
|
virtual int operator()(const char_type*, const char_type*,
|
|
uint32_t, uint32_t) const override;
|
|
};
|
|
|
|
class nsCaseInsensitiveCStringArrayComparator
|
|
{
|
|
public:
|
|
template<class A, class B>
|
|
bool Equals(const A& aStrA, const B& aStrB) const
|
|
{
|
|
return aStrA.Equals(aStrB, nsCaseInsensitiveCStringComparator());
|
|
}
|
|
};
|
|
|
|
// included here for backwards compatibility
|
|
#ifndef nsSubstringTuple_h___
|
|
#include "nsSubstringTuple.h"
|
|
#endif
|
|
|
|
#endif // !defined(nsAString_h___)
|