Bug 1792574, part 2 - Remove some unused macros from nsMemory.h. r=xpcom-reviewers,nika

  static nsIMemory* GetGlobalMemoryService();  // AddRefs

};

/**

 * Macro to free all elements of an XPCOM array of a given size using

 * freeFunc, then frees the array itself using free().

 *

 * Note that this macro (and its wrappers) can be used to deallocate a

 * partially- or completely-built array while unwinding an error

 * condition inside the XPCOM routine that was going to return the

 * array.  For this to work on a partially-built array, your code

 * needs to be building the array from index 0 upwards, and simply

 * pass the number of elements that have already been built (and thus

 * need to be freed) as |size|.

 *

 * Thanks to <alecf@netscape.com> for suggesting this form, which

 * allows the macro to be used with NS_RELEASE / NS_RELEASE_IF in

 * addition to free.

 *

 * @param size      Number of elements in the array.  If not a constant, this

 *                  should be a int32_t.  Note that this means this macro

 *                  will not work if size >= 2^31.

 * @param array     The array to be freed.

 * @param freeFunc  The function or macro to be used to free it.

 *                  For arrays of nsISupports (or any class derived

 *                  from it), NS_IF_RELEASE (or NS_RELEASE) should be

 *                  passed as freeFunc.  For most (all?) other pointer

 *                  types (including XPCOM strings and wstrings),

 *                  free should be used.

 */

#define NS_FREE_XPCOM_POINTER_ARRAY(size, array, freeFunc) \

  do {                                                     \

    int32_t iter_ = int32_t(size);                         \

    while (--iter_ >= 0) freeFunc((array)[iter_]);         \

    free((array));                                         \

  } while (0)

// convenience macros for commonly used calls.  mmmmm.  syntactic sugar.

/**

 * Macro to free arrays of non-refcounted objects allocated by the

 * shared allocator (nsMemory) such as strings and wstrings.  A

 * convenience wrapper around NS_FREE_XPCOM_POINTER_ARRAY.

 *

 * @param size      Number of elements in the array.  If not a constant, this

 *                  should be a int32_t.  Note that this means this macro

 *                  will not work if size >= 2^31.

 * @param array     The array to be freed.

 */

#define NS_FREE_XPCOM_ALLOCATED_POINTER_ARRAY(size, array) \

  NS_FREE_XPCOM_POINTER_ARRAY((size), (array), free)

/**

 * Macro to free an array of pointers to nsISupports (or classes

 * derived from it).  A convenience wrapper around

 * NS_FREE_XPCOM_POINTER_ARRAY.

 *

 * Note that if you know that none of your nsISupports pointers are

 * going to be 0, you can gain a bit of speed by calling

 * NS_FREE_XPCOM_POINTER_ARRAY directly and using NS_RELEASE as your

 * free function.

 *

 * @param size      Number of elements in the array.  If not a constant, this

 *                  should be a int32_t.  Note that this means this macro

 *                  will not work if size >= 2^31.

 * @param array     The array to be freed.

 */

#define NS_FREE_XPCOM_ISUPPORTS_POINTER_ARRAY(size, array) \

  NS_FREE_XPCOM_POINTER_ARRAY((size), (array), NS_IF_RELEASE)

#endif  // nsMemory_h__