scilab/modules/string/help/pt_BR/strcmpi.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"
  17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
  18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
  19           xmlns:scilab="http://www.scilab.org" xml:id="strcmpi" xml:lang="pt">
  20     <refnamediv>
  21         <refname>strcmpi</refname>
  22         <refpurpose>
  23           compara strings (caso independente) <emphasis role="bold">(Obsolete => strcmp(..,"i"))</emphasis>
  24         </refpurpose>
  25     </refnamediv>
  26     <refsynopsisdiv>
  27         <title>Seqüência de Chamamento</title>
  28         <synopsis>res = strcmpi(string_one,string_two)</synopsis>
  29     </refsynopsisdiv>
  30     <refsection>
  31         <title>Parâmetros</title>
  32         <variablelist>
  33             <varlistentry>
  34                 <term>string_one</term>
  35                 <listitem>
  36                     <para>string ou matriz de strings</para>
  37                 </listitem>
  38             </varlistentry>
  39             <varlistentry>
  40                 <term>string_two</term>
  41                 <listitem>
  42                     <para>string ou matriz de strings</para>
  43                 </listitem>
  44             </varlistentry>
  45             <varlistentry>
  46                 <term>res</term>
  47                 <listitem>
  48                     <para>matriz</para>
  49                 </listitem>
  50             </varlistentry>
  51         </variablelist>
  52     </refsection>
  53     <refsection>
  54         <title>Descrição</title>
  55         <para>
  56             <literal>res = strcmpi(string_one,string_two)</literal> retorna um
  57             valor inteiro indicando a relação entre os strings.
  58         </para>
  59         <para>Um valor inteiro maior que zero indica que o primeiro caractere que
  60             não corresponde possui valor maior em <literal>string_one</literal> que em
  61             <literal>string_two</literal>
  62         </para>
  63         <para>Um valor negativo indica o contrário.</para>
  64         <warning>
  65             This function is obsolete. Please use <literal>strcmp(s1,s2,"i")</literal> instead.
  66         </warning>
  67     </refsection>
  68     <refsection>
  69         <title>Exemplos</title>
  70         <programlisting role="example"><![CDATA[
  71 TXT1 = ['scilab','SciLab';'Strcmp','STRcmp'];
  72 TXT2 = ['ScIlAb','sciLab';'sTrCmP','StrCMP'];
  73 strcmpi(TXT1,TXT2)
  74 strcmpi(TXT1,'scilab')
  75  ]]></programlisting>
  76     </refsection>
  77     <refsection role="see also">
  78         <title>Ver Também</title>
  79         <simplelist type="inline">
  80             <member>
  81                 <link linkend="strcat">strcat</link>
  82             </member>
  83             <member>
  84                 <link linkend="strcmp">strcmp</link>
  85             </member>
  86         </simplelist>
  87     </refsection>
  88     <refsection>
  89         <title>Histórico</title>
  90         <revhistory>
  91             <revision>
  92                 <revnumber>6.0</revnumber>
  93                 <revdescription>
  94                     Function tagged as obsolete. Will be removed from Scilab 6.1
  95                 </revdescription>
  96             </revision>
  97         </revhistory>
  98     </refsection>
  99 </refentry>