b39302320a8c6387b2929dfa43586e4f4b7d3bbd
[scilab.git] / 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>