[#boost-urls-grammar-ci_equal]
= xref:boost.adoc[boost]::xref:boost/urls.adoc[urls]::xref:boost/urls/grammar.adoc[grammar]::ci_equal
:relfileprefix: ../../../
:mrdocs:


A case‐insensitive equals predicate for strings

== Synopsis


Declared in `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/grammar/ci_string.hpp#L314[boost/url/grammar/ci_string.hpp]>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
using ci_equal = /* implementation-defined */::xref:boost/urls/grammar/implementation_defined/ci_equal.adoc[ci_equal];
----

== Description


The function object returns `true` when    two strings are equal, ignoring case.    This is a suitable equality predicate for    unordered containers.    The function is defined only for strings    containing low‐ASCII characters.


=== Example

[,cpp]
----
boost::unordered_map< std::string, std::string, ci_hash, ci_equal > m1;

std::unordered_map  < std::string, std::string, ci_hash, ci_equal > m2; // (since C++20)
----


== See Also


xref:boost/urls/grammar/ci_hash.adoc[ci&lowbar;hash],        xref:boost/urls/grammar/ci_less.adoc[ci&lowbar;less]&period;






[.small]#Created with https://www.mrdocs.com[MrDocs]#