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>