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

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

<refnamediv>

<refname>strncasecmp</refname>

<refpurpose>バイナリセーフで大文字小文字を区別しない文字列比較を、最初の n 文字について行う</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>int</type><methodname>strncasecmp</methodname>

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

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

<methodparam><type>int</type><parameter>length</parameter></methodparam>

</methodsynopsis>

<para>

この関数は、<function>strcasecmp</function> に似ていますが、

各文字列から比較する文字数(の上限)(<parameter>len</parameter>)

を指定できるという違いがあります。どちらかの文字列が

<parameter>len</parameter>より短い場合、その文字列の長さが比較時に使用されます。

</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>

<varlistentry>

<term><parameter>length</parameter></term>

<listitem>

<para>

比較する文字列の長さ。

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

&strings.comparison.return;

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

&standard.changelog.binary-safe-string-comparison;

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title><function>strncasecmp</function> の例</title>

<programlisting role="php">

</programlisting>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

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

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

<member><function>substr_compare</function></member>

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

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

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

</simplelist>

</para>

</refsect1>

</refentry>