841d105a8c5599101f972a908f8c361d27dab826
[scilab.git] / scilab / modules / fileio / help / ru_RU / path_filename / pathconvert.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  *
7  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at
11  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
12  *
13  -->
14 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="pathconvert">
15     <refnamediv>
16         <refname>pathconvert</refname>
17         <refpurpose>преобразование имён путей между POSIX и Windows.</refpurpose>
18     </refnamediv>
19     <refsynopsisdiv>
20         <title>Последовательность вызова</title>
21         <synopsis>paths = pathconvert(paths [,flagtrail [,flagexpand [,type]]])</synopsis>
22     </refsynopsisdiv>
23     <refsection>
24         <title>Аргументы</title>
25         <variablelist>
26             <varlistentry>
27                 <term>paths</term>
28                 <listitem>
29                     <para>
30                         матрица строк, указывающая набор путей к файлам.
31                     </para>
32                 </listitem>
33             </varlistentry>
34             <varlistentry>
35                 <term>flagtrail</term>
36                 <listitem>
37                     <para>
38                         необязательное логическое значение, используемое для
39                         добавления завершающего разделителя к путям (<literal>\</literal>
40                         или <literal>/</literal> в зависимости от целевого формата пути).
41                         Его значение по умолчанию равно <constant>%t</constant>.
42                     </para>
43                  </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>flagexpand</term>
47                 <listitem>
48                     <para>
49                         необязательное логическое значение, используемое для составления
50                         пути из переменных, идущих впереди. Его значение по умолчанию
51                         ИСТИНА (<constant>%t</constant>).
52                     </para>
53                 </listitem>
54             </varlistentry>
55             <varlistentry>
56                 <term>type</term>
57                 <listitem>
58                     <para>
59                         необязательное строковое значение, используемое для определения
60                         целевого формата пути: <literal>'u'</literal> для формата пути
61                         POSIX (GNU/Linux, ...) и <literal>'w'</literal> формата пути Windows.
62                     </para>
63                 </listitem>
64             </varlistentry>
65         </variablelist>
66     </refsection>
67     <refsection>
68         <title>Описание</title>
69         <para>
70             Функция <function>pathconvert</function> используется для преобразования
71             набора имён путей в формат, совместимый с операционной системой. Например,
72             стиль путей в Windows использует <literal>/</literal> для разделителей
73             файлов, в то время как в других операционных системах это <literal>\</literal>.
74         </para>
75         <para>
76             По умолчанию пути преобразуются в формат путей текущей операционной
77             системы (но можно определить и другой формат путей с помощью
78             аргумента <varname>type</varname>).
79         </para>
80         <para>
81             <note>
82                 Заметьте: пути в Windows, начинающиеся с префикса буквы диска,
83                 преобразуются в пути POSIX, используя соглашение cygwin (с
84                 <literal>/cygdrive</literal>). Например: <literal>C:\tmp</literal>
85                 будет преобразовано в <literal>/cygdrive/C/tmp</literal>.
86             </note>
87         </para>
88         <para>
89             <varname>flagtrail</varname> используется для добавления или удаления
90             разделителя файлов (в зависимости от целевого формата пути) к концу
91             путей. Когда этот параметр установлен в ИСТИНУ, то заключительный
92             разделитель файлов добавляется. В противном случае заключительный
93             разделитель удаляется.
94         </para>
95         <para>
96             <varname>flagexpand</varname> используется для развёртывания
97             переменных окружения Scilab'а, стоящих в путях впереди.
98             Принимаются следующие переменные:
99             <itemizedlist>
100                 <listitem>
101                     <constant>SCI</constant>
102                 </listitem>
103                 <listitem>
104                     <constant>WSCI</constant>
105                 </listitem>
106                 <listitem>
107                     <constant>SCIHOME</constant>
108                 </listitem>
109                 <listitem>
110                     <constant>TMPDIR</constant>
111                 </listitem>
112                 <listitem>
113                     <literal>home</literal> (или <literal>~</literal>)
114                 </listitem>
115             </itemizedlist>
116             <caution>
117                 <constant>WSCI</constant> не известна в GNU/Linux, а
118                 <literal>~</literal> в значении "путь" неизвестна в
119                 Windows.
120             </caution>
121         </para>
122     </refsection>
123     <refsection>
124         <title>Примеры</title>
125         <programlisting role="example"><![CDATA[
126 pathconvert("SCI/modules/foo", %f, %t, "w")
127 pathconvert("SCI\modules\foo", %f, %t, "u")
128 pathconvert("SCI\modules\foo", %t, %t, "u")
129 pathconvert("SCI/modules/foo", %f, %f, "w")
130 pathconvert("SCI/modules/foo", %t, %f, "w")
131 pathconvert("C:/tmp", %f, %f, "u")
132 pathconvert("/cygdrive/c/tmp", %f, %f, "w")
133  ]]></programlisting>
134     </refsection>
135     <refsection role="see also">
136         <title>Смотрите также</title>
137         <simplelist type="inline">
138             <member>
139                 <link linkend="basename">basename</link>
140             </member>
141             <member>
142                 <link linkend="listfiles">listfiles</link>
143             </member>
144             <member>
145                 <link linkend="dirname">dirname</link>
146             </member>
147         </simplelist>
148     </refsection>
149 </refentry>
150