-
Notifications
You must be signed in to change notification settings - Fork 42
/
shmop-write.xml
157 lines (151 loc) · 4.17 KB
/
shmop-write.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f1446c725b05024034664159db4d5f34b56421d0 Maintainer: conni Status: ready -->
<refentry xml:id="function.shmop-write" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>shmop_write</refname>
<refpurpose>Schreibt Daten in einen gemeinsamen Speicherbereich</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>shmop_write</methodname>
<methodparam><type>Shmop</type><parameter>shmop</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
<methodparam><type>int</type><parameter>offset</parameter></methodparam>
</methodsynopsis>
<para>
<function>shmop_write</function> schreibt Daten in einen gemeinsamen
Speicherbereich.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>shmop</parameter></term>
<listitem>
<para>
Der Bezeichner für den gemeinsamen Speicherbereich, der von
<function>shmop_open</function> erzeugt wurde.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
Ein String, der in den gemeinsamen Speicherbereich geschrieben werden
soll.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<para>
Gibt an, von welcher Position ab Daten in den gemeinsamen
Speicherbereich geschrieben werden sollen. Der Offset muss größer oder
gleich Null und kleiner oder gleich der tatsächlichen Größe des
gemeinsamen Speicherbereichs sein.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Die Länge der geschriebenen Daten <parameter>data</parameter> oder &false;,
falls ein Fehler auftrat.
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Wenn <parameter>offset</parameter> außerhalb des zulässigen Bereichs liegt
oder in einen schreibgeschützten gemeinsamen Speicherbereich geschrieben
werden soll, wird ein <classname>ValueError</classname> ausgelöst.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Vor PHP 8.0.0 wurde bei einem Fehler &false; zurückgegeben.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>shmop</parameter> erwartet nun eine
<classname>Shmop</classname>-Instanz; vorher wurde eine
<type>resource</type> erwartet.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>In den gemeinsamen Speicherbereich schreiben</title>
<programlisting role="php">
<![CDATA[
<?php
$shm_bytes_written = shmop_write($shm_id, $my_string, 0);
?>
]]>
</programlisting>
</example>
</para>
<para>
In diesem Beispiel werden die Daten der Variablen
<literal>$my_string</literal> in den gemeinsamen Speicherbereich
geschrieben. Die Variable <literal>$shm_bytes_written</literal> enthält die
Anzahl der geschriebenen Bytes.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>shmop_read</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
-->