:relfileprefix: ../../../
[#boost-urls-grammar-ci_compare]

= xref:boost.adoc[pass:[boost]]::xref:boost/urls.adoc[pass:[urls]]::xref:boost/urls/grammar.adoc[pass:[grammar]]::ci_compare


Return the case-insensitive comparison of s0 and s1


== Synopsis

Declared in header `<https://www.github.com/boostorg/url/blob/develop/include/boost/url/grammar/ci_string.hpp#L120[boost/url/grammar/ci_string.hpp,window=blank_]>`

[source,cpp,subs="verbatim,macros,-callouts"]
----
int
ci_compare(
    core::string_view s0,
    core::string_view s1) noexcept;
----

== Description


This returns the lexicographical comparison
of two strings, ignoring case.
The function is defined only for strings
containing low-ASCII characters.

=== Example
[,cpp]
----
assert( ci_compare( "boost", "Boost" ) == 0 );
----

=== Exception Safety

Throws nothing.




== Return Value


0 if the strings are equal, -1 if
`s0` is less than `s1`, or 1 if `s0` is
greater than s1.



== Parameters

|===
| Name | Description 

| *s0*
| 
The first string

| *s1*
| 
The second string

|===




== See Also


xref:boost/urls/grammar/ci_is_equal-0b.adoc[ci_is_equal]
,
xref:boost/urls/grammar/ci_is_less.adoc[ci_is_less]
.