Name
	n3594 - add streq()

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>

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

	This paper is an alternative to n3455 from Yair Lenga.

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

Description
	strcmp(3) is too confusing, and many projects come up with a
	wrapper streq() to do one of the common operations with it:
	Compare two strings for equality, returning a boolean.

	By developing such a wrapper in shadow utils, and replacing code
	that used strcmp(3) to use the wrapper, I've found and fixed
	several bugs.

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

		bool
		streq(const char *s1, const char *s2)
		{
			return strcmp(s1, s2) == 0;
		}

Proposed wording
	Based on N3550.

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

	+7.28.4.3+1  The <b>streq</b> function
	+
	+Synopsis
	+1	#include <string.h>
	+	bool streq(const char *s1, const char *s2);
	+
	+Description
	+2	The <b>streq</b> function
	+	compares the strings pointed to by
	+	<tt>s1</tt> and <tt>s2</tt>.
	+
	+Returns
	+3	The <b>streq</b> function returns true
	+	if the strings are equal.

    7.33.4.5  Wide string comparison functions
	## New section after 7.33.4.5.2 ("The wcscmp function"):

	+7.33.4.5.2+1  The <b>wcseq</b> function
	+
	+Synopsis
	+1	#include <wchar.h>
	+	bool wcseq(const wchar_t *s1, const wchar_t *s2);
	+
	+Description
	+2	The <b>wcseq</b> function
	+	is equivalent to
	+	<b>streq</b>,
	+	except that it handles wide strings.