<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.strcoll" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>strcoll</refname>

<refpurpose>Сравнивает строки с учётом текущей локали</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>int</type><methodname>strcoll</methodname>

<methodparam><type>string</type><parameter>string1</parameter></methodparam>

<methodparam><type>string</type><parameter>string2</parameter></methodparam>

</methodsynopsis>

<para>

Обратите внимание, что эта функция учитывает регистр символов, и в

отличие от функции <function>strcmp</function>, не безопасна для обработки

данных в двоичной форме.

</para>

<para>

Функция <function>strcoll</function> при сравнении использует установки

текущей локали. Если установлена локаль языка C или стандарта POSIX, функция

ведёт себя аналогично функции <function>strcmp</function>.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>string1</parameter></term>

<listitem>

<para>

Первая строка.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>string2</parameter></term>

<listitem>

<para>

Вторая строка.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Функция возвращает отрицательное число, если значение <parameter>string1</parameter> меньше

значения <parameter>string2</parameter>, положительное число, если

значение <parameter>string1</parameter> больше

значения <parameter>string2</parameter>, и 0, если значения равны.

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>preg_match</function></member>

<member><function>strcmp</function></member>

<member><function>strcasecmp</function></member>

<member><function>substr</function></member>

<member><function>stristr</function></member>

<member><function>strncasecmp</function></member>

<member><function>strncmp</function></member>

<member><function>strstr</function></member>

<member><function>setlocale</function></member>

</simplelist>

</para>

</refsect1>

</refentry>