Files
php-doc-ru/reference/sync/syncreaderwriter/construct.xml
2022-03-01 09:23:33 +03:00

130 lines
4.5 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: f12b4010435efc7a015e65fbd274740710368487 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="syncreaderwriter.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SyncReaderWriter::__construct</refname>
<refpurpose>Создаёт новый объект SyncReaderWriter</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <methodname>SyncReaderWriter::__construct</methodname>
<methodparam choice="opt"><type>string</type><parameter>name</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>autounlock</parameter><initializer>1</initializer></methodparam>
</methodsynopsis>
<para>
Создаёт именованный или безымянный объект чтения-записи.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>name</parameter></term>
<listitem>
<para>
Имя средства чтения-записи, если это именованный объект чтения-записи.
</para>
<note>
<para>
Если имя уже существует, оно должно быть доступно для открытия текущим пользователем,
от имени которого запущен процесс, иначе будет выброшено исключение
с бессмысленным сообщением об ошибке.
</para>
</note>
<note>
<simpara>
В Windows параметр <parameter>name</parameter> не должен содержать обратных слешей.
</simpara>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>autounlock</parameter></term>
<listitem>
<para>
Указывает, следует ли автоматически разблокировать средство чтения-записи
при завершении скрипта PHP.
</para>
<warning>
<para>
Если объект: Именованное средство чтения-записи с автоматической блокировкой FALSE,
объект заблокирован для чтения или записи, и скрипт PHP завершается до того,
как объект будет разблокирован, тогда базовые объекты окажутся в несогласованном состоянии.
</para>
</warning>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Новый объект <classname>SyncReaderWriter</classname>.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Исключение выбрасывается, если средство чтения-записи не может быть создано или открыто.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования <function>SyncReaderWriter::__construct</function></title>
<programlisting role="php">
<![CDATA[
<?php
$readwrite = new SyncReaderWriter("FileCacheLock");
$readwrite->readlock();
/* ... */
$readwrite->readunlock();
$readwrite->writelock();
/* ... */
$readwrite->writeunlock();
?>
]]>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><methodname>SyncReaderWriter::readlock</methodname></member>
<member><methodname>SyncReaderWriter::readunlock</methodname></member>
<member><methodname>SyncReaderWriter::writelock</methodname></member>
<member><methodname>SyncReaderWriter::writeunlock</methodname></member>
</simplelist>
</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
-->