Name
	n3617, alx-0024r1 - add memeq(), wmemeq()

Principles
	-  Codify existing practice to address evident deficiencies.
	-  Enable secure programming

Category
	Standardize common APIs

Author
	Alejandro Colomar <alx@kernel.org>

	Cc: Yair Lenga <yair.lenga@gmail.com>
	Cc: Joseph Myers <josmyers@redhat.com>
	Cc: Martin Uecker <uecker@tugraz.at>

History
	<https://www.alejandro-colomar.es/src/alx/alx/wg14/alx-0024.git/>

	r0 (2025-06-13):
	-  Initial draft.

	r1 (2025-06-26; n3617):
	-  Fix title.
	-  Fix type of parameters.

Rationale
	See the rationale for streq() in alx-0024 for why this wrapper
	is better than using memcmp(3) directly.

	Some projects use mem*() APIs instead of str*() APIs for
	performance reasons.  To enable those projects to write better
	code, we should add a memeq() API, just like there's a proposal
	for streq().

Prior art
	Some projects define this API, either as a macro or as a
	function.  Here's an example implementation:

		bool
		memeq(const void *m1, const void *m2, size_t n)
		{
			return memcmp(m1, m2, n) == 0;
		}

Proposed wording
	Based on N3550.

    7.28.4  String handling <string.h> :: Comparison functions
	## New section after 7.28.4.2 ("The memcmp function"):

	+7.28.4.2+1  The <b>memeq</b> function
	+
	+Synopsis
	+1	#include <string.h>
	+	bool memeq(const void *m1, const void *m2, size_t n);
	+
	+Description
	+2	The <b>memeq</b> function
	+	is equivalent to <b>memcmp</b>,
	+	except for the return value.
	+
	+Returns
	+3	The <b>memeq</b> function returns true
	+	if and only if all bytes are equal.

    7.33.4.5  Wide string comparison functions
	## New section after 7.33.4.5.6 ("The wmemcmp function"):

	+7.33.4.5.6+1  The <b>wmemeq</b> function
	+
	+Synopsis
	+1	#include <wchar.h>
	+	bool wmemeq(const wchar_t *m1, const wchar_t *m2, size_t n);
	+
	+Description
	+2	The <b>wmemeq</b> function
	+	is equivalent to
	+	<b>memeq</b>,
	+	except that it handles wide characters.