* `strcmpi` is deprecated. Please use `strcmp(..,"i")`instead.
[scilab.git] / scilab / modules / string / help / ru_RU / strcmp.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) INRIA - 
5  * 
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="strcmp" xml:lang="ru">
17     <refnamediv>
18         <refname>strcmp</refname>
19         <refpurpose>сравнение символьных строк</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Синтаксис</title>
23         <synopsis>res = strcmp(string_one, string_two, ['i'])</synopsis>
24     </refsynopsisdiv>
25     <refsection>
26         <title>Аргументы</title>
27         <variablelist>
28             <varlistentry>
29                 <term>string_one</term>
30                 <listitem>
31                     <para>
32                         символьная строка или матрица символьных строк.
33                     </para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>string_two</term>
38                 <listitem>
39                     <para>
40                         символьная строка или матрица символьных строк.
41                     </para>
42                 </listitem>
43             </varlistentry>
44             <varlistentry>
45                 <term>'i'</term>
46                 <listitem>
47                     <para>
48                         необязательный параметр для того, чтобы функция <function>strcmp</function>
49                         не учитывала регистр, значение по умолчанию - <literal>'s'</literal>.
50                     </para>
51                 </listitem>
52             </varlistentry>
53             <varlistentry>
54                 <term>res</term>
55                 <listitem>
56                     <para>матрица целочисленных значений.</para>
57                 </listitem>
58             </varlistentry>
59         </variablelist>
60     </refsection>
61     <refsection>
62         <title>Описание</title>
63         <para>
64             <code>res = strcmp(string_one, string_two)</code> (или
65             <code>res = strcmp(string_one, string_two, 's')</code>) возвращает
66             интегральное значение, указывающее отношение между строками.
67         </para>
68         <para>
69             Значение больше нуля указывает, что первый символ, который не соответствует, имеет большее значение в <varname>string_one</varname>, чем в <varname>string_two</varname>, а значение меньше нуля указывает обратное.
70         </para>
71         <para>
72             Значение равное нулю указывает на то, что
73             <varname>string_one</varname> и <varname>string_two</varname>
74             равны.
75         </para>
76         <para>
77             <code>res = strcmp(string_one, string_two, 'i')</code> возвращает
78             <literal>0</literal>, если <varname>string_one</varname> равна
79             <varname>string_two</varname> (независимо от регистра), а
80             <literal>1</literal> указывает обратное.
81         </para>
82     </refsection>
83     <refsection>
84         <title>Примеры</title>
85         <programlisting role="example"><![CDATA[
86 TXT1 = ['scilab','SciLab';'Strcmp','STRcmp'];
87 TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP'];
88 strcmp(TXT1,TXT2)
89 strcmp(TXT1,'scilab')
90 strcmp(TXT1,'SciLab')
91 strcmp(TXT1,TXT2,'i')
92 strcmp(TXT1,TXT2,'s')
93     ]]></programlisting>
94     </refsection>
95     <refsection role="see also">
96         <title>Смотрите также</title>
97         <simplelist type="inline">
98             <member>
99                 <link linkend="convstr">convstr</link>
100             </member>
101             <member>
102                 <link linkend="comparison">comparison</link>
103             </member>
104         </simplelist>
105     </refsection>
106 </refentry>