1 /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2 /* vim: set ts=8 sts=2 et sw=2 tw=80: */
3 /* This Source Code Form is subject to the terms of the Mozilla Public
4 * License, v. 2.0. If a copy of the MPL was not distributed with this
5 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
14 #define NSID_LENGTH 39
17 * A "unique identifier". This is modeled after OSF DCE UUIDs.
22 * @name Identifier values
38 * Ensures everything is zeroed out.
43 * Equivalency method. Compares this nsID with another.
44 * @return <b>true</b> if they are the same, <b>false</b> if not.
47 inline bool Equals(const nsID
& aOther
) const {
48 // At the time of this writing, modern compilers (namely Clang) inline this
49 // memcmp call into a single SIMD operation on x86/x86-64 architectures (as
50 // long as we compare to zero rather than returning the full integer return
51 // value), which is measurably more efficient to any manual comparisons we
53 #if defined(__x86_64__) || defined(__i386__)
54 return !memcmp(this, &aOther
, sizeof *this);
56 // However, on ARM architectures, compilers still tend to generate a direct
57 // memcmp call, which we'd like to avoid.
58 return (((uint32_t*)&m0
)[0] == ((uint32_t*)&aOther
.m0
)[0]) &&
59 (((uint32_t*)&m0
)[1] == ((uint32_t*)&aOther
.m0
)[1]) &&
60 (((uint32_t*)&m0
)[2] == ((uint32_t*)&aOther
.m0
)[2]) &&
61 (((uint32_t*)&m0
)[3] == ((uint32_t*)&aOther
.m0
)[3]);
65 inline bool operator==(const nsID
& aOther
) const { return Equals(aOther
); }
68 * nsID Parsing method. Turns a {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
71 bool Parse(const char* aIDStr
);
73 #ifndef XPCOM_GLUE_AVOID_NSPR
75 * nsID string encoder. Returns an allocated string in
76 * {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} format. Caller should free string.
77 * YOU SHOULD ONLY USE THIS IF YOU CANNOT USE ToProvidedString() BELOW.
79 char* ToString() const;
82 * nsID string encoder. Builds a string in
83 * {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} format, into a char[NSID_LENGTH]
84 * buffer provided by the caller (for instance, on the stack).
86 void ToProvidedString(char (&aDest
)[NSID_LENGTH
]) const;
88 #endif // XPCOM_GLUE_AVOID_NSPR
90 // Infallibly duplicate an nsID. Must be freed with free().
96 #ifndef XPCOM_GLUE_AVOID_NSPR
98 * A stack helper class to convert a nsID to a string. Useful
99 * for printing nsIDs. For example:
101 * printf("%s", nsIDToCString(aID).get());
103 class nsIDToCString
{
105 explicit nsIDToCString(const nsID
& aID
) {
106 aID
.ToProvidedString(mStringBytes
);
109 const char* get() const { return mStringBytes
; }
112 char mStringBytes
[NSID_LENGTH
];
123 #define NS_DEFINE_CID(_name, _cidspec) const nsCID _name = _cidspec
125 #define NS_DEFINE_NAMED_CID(_name) static const nsCID k##_name = _name
127 #define REFNSCID const nsCID&
130 * An "interface id" which can be used to uniquely identify a given
137 * A macro shorthand for <tt>const nsIID&<tt>
140 #define REFNSIID const nsIID&
144 * obsolete - do not use this macro
147 #define NS_DEFINE_IID(_name, _iidspec) const nsIID _name = _iidspec
150 * A macro to build the static const IID accessor method. The Dummy
151 * template parameter only exists so that the kIID symbol will be linked
152 * properly (weak symbol on linux, gnu_linkonce on mac, multiple-definitions
153 * merged on windows). Dummy should always be instantiated as "void".
156 #define NS_DECLARE_STATIC_IID_ACCESSOR(the_iid) \
157 template <typename T, typename U> \
160 #define NS_DEFINE_STATIC_IID_ACCESSOR(the_interface, the_iid) \
161 template <typename T> \
162 struct the_interface::COMTypeInfo<the_interface, T> { \
163 static const nsIID kIID NS_HIDDEN; \
165 template <typename T> \
166 const nsIID the_interface::COMTypeInfo<the_interface, T>::kIID NS_HIDDEN = \
170 * A macro to build the static const CID accessor method
173 #define NS_DEFINE_STATIC_CID_ACCESSOR(the_cid) \
174 static const nsID& GetCID() { \
175 static const nsID cid = the_cid; \
179 #define NS_GET_IID(T) (T::COMTypeInfo<T, void>::kIID)
180 #define NS_GET_TEMPLATE_IID(T) (T::template COMTypeInfo<T, void>::kIID)