-
Notifications
You must be signed in to change notification settings - Fork 39
/
pg-lo-write.xml
154 lines (147 loc) · 4.29 KB
/
pg-lo-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
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: conni Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Reviewer: samesch -->
<refentry xml:id="function.pg-lo-write" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pg_lo_write</refname>
<refpurpose>Schreibt in ein Large Object</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>int</type><type>false</type></type><methodname>pg_lo_write</methodname>
<methodparam><type>PgSql\Lob</type><parameter>lob</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>pg_lo_write</function> schreibt Daten ab der aktuellen Position
der internen Schreib-Lese-Marke in ein Large Object.
</para>
<para>
Um die Large Object- (lo) Schnittstelle benutzen zu können, müssen die
Kommandos innerhalb einer Transaktion ausgeführt werden.
</para>
<note>
<para>
Diese Funktion ersetzt die Funktion <function>pg_lowrite</function>.
</para>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>lob</parameter></term>
<listitem>
&pgsql.parameter.lob;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
Die Daten, die in das Large Object geschrieben werden. Falls
<parameter>length</parameter> vom Typ <type>int</type> ist und kleiner
als die Länge von <parameter>data</parameter>, werden nur
<parameter>length</parameter> Bytes geschrieben.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>length</parameter></term>
<listitem>
<para>
Die maximale Anzahl der Bytes, die geschrieben werden. Die Anzahl muss
größer als 0 und kleiner als die Länge von <parameter>data</parameter>
sein. Der Vorgabewert ist die Länge von <parameter>data</parameter>.
Diese Angabe ist optional.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Die Anzahl der Bytes, die in das Large Object geschrieben wurden, oder
&false;, falls ein Fehler auftrat.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&pgsql.changelog.lob-object;
<row>
<entry>8.0.0</entry>
<entry>
<parameter>length</parameter> ist jetzt nullbar.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>pg_lo_write</function>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
$doc_oid = 189762345;
$data = "Hiermit wird der Anfang des Large Objects überschrieben.";
$database = pg_connect("dbname=jacarta");
pg_query($database, "begin");
$handle = pg_lo_open($database, $doc_oid, "w");
$data = pg_lo_write($handle, $data);
pg_query($database, "commit");
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>pg_lo_create</function></member>
<member><function>pg_lo_open</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
-->