Files
php-doc-ru/reference/filesystem/functions/lstat.xml
Sergey Panteleev 6d43fd64d7 Исправление форматирования
[skip-spellcheck]
[skip-lint]
2022-12-27 03:42:36 +03:00

132 lines
3.6 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 871a231f4a1caa5fb258ae53b1bb7d1fb2a0f949 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.lstat" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>lstat</refname>
<refpurpose>Возвращает информацию о файле или символической ссылке</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>array</type><type>false</type></type><methodname>lstat</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Собирает статистику на файл или символическую ссылку с именем
<parameter>filename</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Путь к файлу или символической ссылке.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Обратитесь к странице руководства функции <function>stat</function> для
получения информации о структуре массива, который возвращает
<function>lstat</function>. Эта функция идентична функции
<function>stat</function>, за исключением того, что если
<parameter>filename</parameter> является символической ссылкой,
возвращается статус символической ссылки, а не того файла, на
который она указывает.
</para>
<para>
Возвращает &false; в случае возникновения ошибки.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
&fs.emits.warning.on.failure;
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Сравнение функций <function>stat</function> и <function>lstat</function></title>
<programlisting role="php">
<![CDATA[
<?php
symlink('uploads.php', 'uploads');
// Отличия между uploads.php и uploads
array_diff(stat('uploads'), lstat('uploads'));
?>
]]>
</programlisting>
&example.outputs.similar;
<para>
Отличия в возвращаемых результатах между этими файлами.
</para>
<screen>
<![CDATA[
Array
(
[ino] => 97236376
[mode] => 33188
[size] => 34
[atime] => 1223580003
[mtime] => 1223581848
[ctime] => 1223581848
[blocks] => 8
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&note.clearstatcache;
&tip.fopen-wrapper.stat;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>stat</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->