1
0
mirror of https://github.com/php/doc-es.git synced 2026-04-25 16:18:09 +02:00
Files
Philippe DELENTE 9f7804a633 Feature/update revision en misc page reference (#248)
* feat(translation): update revision EN

* feat(translation): update revision EN
2025-07-02 22:37:23 +02:00

132 lines
3.9 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cf2b279980fc54b7f2602a0687652c170a906930 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="streamwrapper.stream-seek" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>streamWrapper::stream_seek</refname>
<refpurpose>Coloca el puntero de flujo en una posición</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>streamWrapper::stream_seek</methodname>
<methodparam><type>int</type><parameter>offset</parameter></methodparam>
<methodparam><type>int</type><parameter>whence</parameter></methodparam>
</methodsynopsis>
<para>
Este método es llamado en respuesta a <function>fseek</function>.
</para>
<para>
La posición de lectura/escritura debe ser modificada para reflejar
la nueva posición <parameter>offset</parameter> y
<parameter>whence</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<para>
La posición a buscar en el flujo.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>whence</parameter></term>
<listitem>
<para>
Los valores posibles son:
<simplelist>
<member><constant>SEEK_SET</constant>: la nueva posición es <parameter>offset</parameter> bytes.</member>
<member><constant>SEEK_CUR</constant>: la nueva posición es la posición actual más <parameter>offset</parameter>.</member>
<member><constant>SEEK_END</constant>: la nueva posición es el final del fichero más <parameter>offset</parameter>.</member>
</simplelist>
</para>
<note>
<simpara>
La implementación actual nunca define <parameter>whence</parameter> como
<constant>SEEK_CUR</constant>; de hecho, estas búsquedas de posición son
convertidas internamente a búsquedas de tipo <constant>SEEK_SET</constant>.
</simpara>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna &true; si la posición ha sido actualizada,
&false; en caso contrario.
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Si no está implementado, &false; será utilizado como
valor de retorno.
</para>
</note>
<note>
<para>
En caso de éxito,
<methodname>streamWrapper::stream_tell</methodname> es llamado
directamente después de <methodname>streamWrapper::stream_seek</methodname>.
Si <methodname>streamWrapper::stream_tell</methodname> falla,
el valor retornado a la función llamante es &false;.
</para>
</note>
<note>
<para>
Todas las operaciones de desplazamiento en un flujo no requieren
necesariamente el uso de esta función. Los flujos PHP
tienen la lectura en búfer activada por omisión (ver también la
función <function>stream_set_read_buffer</function>) así como el
desplazamiento en este flujo, que puede ser realizado moviendo el puntero
del búfer.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>fseek</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
-->