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

123 lines
3.4 KiB
XML
Raw Permalink 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: f03806fcd8fe03a0501bd40b6e3939ff6589a1d2 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="phardata.offsetset" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>PharData::offsetSet</refname>
<refpurpose>Изменение содержимого файла</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="PharData">
<modifier>public</modifier> <type>void</type><methodname>PharData::offsetSet</methodname>
<methodparam><type>string</type><parameter>localName</parameter></methodparam>
<methodparam><type class="union"><type>resource</type><type>string</type></type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
Это реализация интерфейса <interfacename>ArrayAccess</interfacename>,
позволяющая манипулировать содержимым tar/zip-архива в стиле доступа к элементам
массива. offsetSet используется для изменения контента существующего
файла, либо для создания нового.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>localName</parameter></term>
<listitem>
<para>
Имя файла (относительный путь).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
Содержимое файла.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Ничего не возвращает.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Выбрасывает исключение <classname>PharException</classname> в случае проблем с записью на диск.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>PharData::offsetSet</function></title>
<para>
offsetSet не нужно вызывать напрямую. Используйте синтаксис <literal>[]</literal>.
</para>
<programlisting role="php">
<![CDATA[
<?php
$p = new PharData('/path/to/my.tar');
try {
// вызов offsetSet
$p['file.txt'] = 'Привет';
} catch (Exception $e) {
echo 'Не удалось изменить file.txt:', $e;
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&phardata.note.performance;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>Phar::offsetSet</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
-->