1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-26 00:12:06 +01:00
Files
archived-doc-es/reference/pdo_pgsql/PDO/pgsqlLOBOpen.xml
Pedro Antonio Gil Rodríguez 0b091b2fad Actualizacion a la ultima version
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@330787 c90b9560-bf6c-de11-be94-00142212c4b1
2013-07-07 18:10:26 +00:00

130 lines
4.0 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 656d1610af1a960d87c8b7056e54d0d4c75fb123 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<!-- Generated by xml_proto.php v2.3. Found in /scripts directory of phpdoc. -->
<refentry xml:id="pdo.pgsqllobopen" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>PDO::pgsqlLOBOpen</refname>
<refpurpose>Abre un flujo de un objeto grande existente</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>resource</type><methodname>PDO::pgsqlLOBOpen</methodname>
<methodparam><type>string</type><parameter>oid</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>mode</parameter><initializer>"rb"</initializer></methodparam>
</methodsynopsis>
<para>
<function>PDO::pgsqlLOBOpen</function> obre un flujo para acceder a los datos
a los que hace referencia <parameter>oid</parameter>. Si <parameter>mode</parameter>
es <literal>r</literal>, el flujo será abierto para lectura; si
<parameter>mode</parameter> es <literal>w</literal>, el flujo será
abierto para escritura. Se pueden utilizar todas las funciones de sistema de ficheros usuales,
tales como <function>fread</function>, <function>fwrite</function> y
<function>fgets</function>, para manipular el contenido del flujo.
</para>
<note>
<simpara>
Esta función, y todas las manipulaciones del objeto grande,
debe ser invocada y realizada dentro de una transacción.
</simpara>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>oid</parameter></term>
<listitem>
<para>
Un identificador de objeto grande.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Si el modo es <literal>r</literal>, se abre el flujo para lectura.
Si el modo es <literal>w</literal>, se abre el flujo para escritura.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un recurso de flujo en caso de éxito &return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Un ejemplo de <function>PDO::pgsqlLOBOpen</function></title>
<para>
Siguiendo el ejemplo de <function>PDO::pgsqlLOBCreate</function>,
este trozo de código recupera el objeto grande de
la base de datos y lo envía al navegador.
</para>
<programlisting role="php">
<![CDATA[
<?php
$bd = new PDO('pgsql:dbname=test host=localhost', $usuario, $contraseña);
$bd->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$bd->beginTransaction();
$sentencia = $bd->prepare("select oid from BLOBS where ident = ?");
$sentencia->execute(array($some_id));
$sentencia->bindColumn('oid', $oid, PDO::PARAM_STR);
$sentencia->fetch(PDO::FETCH_BOUND);
$flujo = $bd->pgsqlLOBOpen($oid, 'r');
header("Content-type: application/octet-stream");
fpassthru($flujo);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>PDO::pgsqlLOBCreate</function></member>
<member><function>PDO::pgsqlLOBUnlink</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
-->