[doc] misc. fix & improvements
[scilab.git] / scilab / modules / fileio / help / pt_BR / directory / chdir.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) 2008 - INRIA
5  * ...
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  * Copyright (C) 2019 - Samuel GOUGEON
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
19           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
20           xmlns:scilab="http://www.scilab.org" xml:id="chdir" xml:lang="pt">
21     <refnamediv>
22         <refname>chdir</refname>
23         <refpurpose>muda o diretório corrente do Scilab</refpurpose>
24     </refnamediv>
25     <refnamediv xml:id="cd">
26         <refname>cd</refname>
27         <refpurpose>muda o diretório corrente do Scilab</refpurpose>
28     </refnamediv>
29     <refsynopsisdiv>
30         <title>Seqüência de Chamamento</title>
31         <synopsis>
32             b = chdir(path)
33             realpath = cd(path)
34             cd path
35         </synopsis>
36     </refsynopsisdiv>
37     <refsection>
38         <title>Parâmetros</title>
39         <variablelist>
40             <varlistentry>
41                 <term>b</term>
42                 <listitem>
43                     <para>um booleano %t se a operação chdir estiver ok.</para>
44                 </listitem>
45             </varlistentry>
46             <varlistentry>
47                 <term>path</term>
48                 <listitem>
49                     <para>um string</para>. O caminho padrão é <literal>home</literal>.
50                 </listitem>
51             </varlistentry>
52             <varlistentry>
53                 <term>realpath</term>
54                 <listitem>
55                     <para>um string, o nome real do endereço após a conversão do nome do
56                         endereço (ver abaixo)
57                     </para>
58                 </listitem>
59             </varlistentry>
60         </variablelist>
61     </refsection>
62     <refsection>
63         <title>Descrição</title>
64         <para>Muda o diretório corrente do Scilab para aquele dado por
65             <literal>path</literal>. Note que a conversão de endereço é realizada e
66             (<link linkend="SCI">SCI</link>,
67                 <link linkend="SCIHOME">SCIHOME</link>,
68                 <link linkend="TMPDIR">TMPDIR</link>,
69                 <link linkend="home">home</link>, etc).
70             Por exemplo <literal>SCI/modules/core/macros</literal> é um padrão válido
71             tanto pra Unix quanto para Windows.
72         </para>
73     </refsection>
74     <refsection>
75         <title>Exemplos</title>
76         <programlisting role="example"><![CDATA[
77 chdir("SCI/etc")
78 pwd
79 cd ..
80 cd TMPDIR
81 p = cd()
82 p == home
83      ]]></programlisting>
84         <screen><![CDATA[
85 --> chdir("SCI/etc")
86  ans  =
87   T
88
89 --> pwd
90  ans  =
91  C:\Programs\scilab\scilab-6.0.2\etc
92
93
94 --> cd ..
95  ans  =
96  C:\Programs\scilab\scilab-6.0.2
97
98 --> cd TMPDIR
99  ans  =
100  C:\Users\Me\AppData\Local\Temp\SCI_TMP_5444_26901
101
102 --> p = cd()
103  p  =
104  C:\Users\Me
105
106 --> p == home
107  ans  =
108   T
109 ]]></screen>
110     </refsection>
111     <refsection>
112         <title>Ver Também</title>
113         <simplelist type="inline">
114             <member>
115                 <link linkend="isdir">isdir</link>
116             </member>
117             <member>
118                 <link linkend="pwd">pwd</link>
119             </member>
120             <member>
121                 <link linkend="home">home</link>
122             </member>
123             <member>
124                 <link linkend="filebrowser">filebrowser</link>
125             </member>
126             <member>
127                 <link linkend="uigetdir">uigetdir</link>
128             </member>
129         </simplelist>
130     </refsection>
131 </refentry>