<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) 2008 - INRIA
 * ...
 *
 * Copyright (C) 2012 - 2016 - Scilab Enterprises
 *
 * This file is hereby licensed under the terms of the GNU GPL v2.0,
 * pursuant to article 5.3.4 of the CeCILL v.2.1.
 * This file was originally licensed under the terms of the CeCILL v2.1,
 * and continues to be available under such terms.
 * For more information, see the COPYING file which you should have received
 * along with this program.
 *
 -->
<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="dirname">
    <refnamediv>
        <refname>dirname</refname>
        <refpurpose>
           получает имя директории из имён файлов <emphasis role="bold">(obsolete)</emphasis>
        </refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Синтаксис</title>
        <synopsis>dirs = dirname(files[, flag [,flagexpand]])</synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Аргументы</title>
        <variablelist>
            <varlistentry>
                <term>files</term>
                <listitem>
                    <para>
                        матрица строк, содержащая пути к файлам.
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>flag</term>
                <listitem>
                    <para>
                        необязательное логическое значение, используемое для
                        преобразования указанных путей для текущей операционной
                        системы. Значение по умолчанию ИСТИНА (<constant>%t</constant>).
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>flagexpand</term>
                <listitem>
                    <para>
                        необязательный логическое значение, используемое для
                        составления пути из переменных, идущих впереди. Используется
                        только вместе с аргументом <varname>flag</varname>. Значение
                        по умолчанию ИСТИНА (<constant>%t</constant>).
                    </para>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>dirs</term>
                <listitem>
                    <para>матрица строк.</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Описание</title>
        <warning>
          <literal>dirname(…)</literal> is obsolete and will be removed from Scilab 6.1.x.
          Please use <literal>fileparts(…)</literal> instead.
        </warning>
        <para>
            Функция <function>dirname</function> возвращает путь директории, составленный
            из файлов, указанных в <varname>files</varname>.
        </para>
        <para>
            Если <varname>flag</varname> равен ИСТИНЕ, то пути сначала преобразуются для
            текущей операционной системы (например, <code>'C:/Tmp/folder'</code> будет
            преобразован в Windows в <code>'C:\Tmp\folder'</code>).
        </para>
        <para>
            Если <varname>flagexpand</varname> равен ИСТИНЕ, то переменные в начале пути
            (<literal>home</literal>, <constant>SCI</constant>, <constant>SCIHOME</constant>,
            ...) расширяются для текущей операционной системы (например, <code>'home\tmp'</code>
            будет преобразован в GNU/Linux в <literal>'home/&lt;user&gt;/tmp'</literal>,
            где <literal>&lt;user&gt;</literal> - это имя учётной записи пользователя).
        </para>
        <para>
            Смотрите подробную информацию о <varname>flag</varname> и <varname>flagexpand</varname>
            в разделе, посвящённому <link linkend="pathconvert">pathconvert</link>.
        </para>
    </refsection>
    <refsection>
        <title>Примеры</title>
        <programlisting role="example"><![CDATA[
dirs=dirname('/tmp/folder/poo')
dirs=dirname('/tmp/folder/')
dirs=dirname('/')

dirs=dirname('C:\tmp\folder\poo')
dirs=dirname('C:\tmp\folder\')
dirs=dirname('C:\')

dirs=dirname(['SCI/etc/scilab.start', 'SCI/etc/scilab.quit'])
 ]]></programlisting>
    </refsection>
    <refsection role="see also">
        <title>Смотрите также</title>
        <simplelist type="inline">
            <member>
                <link linkend="fileparts">fileparts</link>
            </member>
            <member>
                <link linkend="basename">basename</link>
            </member>
            <member>
                <link linkend="listfiles">listfiles</link>
            </member>
            <member>
                <link linkend="pathconvert">pathconvert</link>
            </member>
        </simplelist>
    </refsection>
    <refsection role="history">
        <title>История</title>
        <revhistory>
            <revision>
                <revnumber>6.0.2</revnumber>
                <revdescription>
                    dirname() is tagged obsolete, to be removed from Scilab 6.1.x.
                    fileparts() replaces it.
                </revdescription>
            </revision>
        </revhistory>
    </refsection>
</refentry>

