Files
doc-fr/reference/dio/functions/dio-seek.xml
Yannick Torres bb0c140b8a Convert to UTF-8
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@297185 c90b9560-bf6c-de11-be94-00142212c4b1
2010-03-30 14:55:14 +00:00

147 lines
4.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: dams Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.dio-seek" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>dio_seek</refname>
<refpurpose>Déplace le pointeur interne de fichier</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>dio_seek</methodname>
<methodparam><type>resource</type><parameter>fd</parameter></methodparam>
<methodparam><type>int</type><parameter>pos</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>whence</parameter><initializer>SEEK_SET</initializer></methodparam>
</methodsynopsis>
<para>
<function>dio_seek</function> sert à modifier la position du
pointeur de fichier dans le fichier.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>fd</parameter></term>
<listitem>
<para>
La ressource de fichier retournée par <function>dio_open</function>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>pos</parameter></term>
<listitem>
<para>
La nouvelle position.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>whence</parameter></term>
<listitem>
<para>
Spécifie comment la position <parameter>pos</parameter> devrait être
interprétée :
<itemizedlist>
<listitem>
<para>
<constant>SEEK_SET</constant> (défaut) : spécifie que
<parameter>pos</parameter> est spécifié à partir du début du
fichier.
</para>
</listitem>
<listitem>
<para>
<constant>SEEK_CUR</constant> : spécifie que
<parameter>pos</parameter> est un nombre de caractères à partir de
la position courante dans le fichier. Ce nombre peut être positif ou
négatif.
</para>
</listitem>
<listitem>
<para>
<constant>SEEK_END</constant> : spécifie que
<parameter>pos</parameter> est un nombre de caractères à partir de
la fin du fichier. Une valeur négative spécifie une position à
l'intérieur du domaine courant du fichier; une valeur positive
spécifie une position passée de la fin courante. Si vous spécifiez
une position après la fin et que vous y écriviez des données, vous
allez agrandir le fichier avec des zéros jusqu'à cette position.
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Positionnement dans un fichier</title>
<programlisting role="php">
<![CDATA[
<?php
$fd = dio_open('/dev/ttyS0', O_RDWR);
dio_seek($fd, 10, SEEK_SET);
// la position est maintenant à 10 caractères depuis le début du fichier
dio_seek($fd, -2, SEEK_CUR);
// la position est maintenant à 8 caractères depuis le début du fichier
dio_seek($fd, -5, SEEK_END);
// la position est maintenant à 5 caractères depuis la fin du fichier
dio_seek($fd, 10, SEEK_END);
// la position est maintenant à 10 caractères après la fin du fichier.
// Les 10 caractères entre la fin du fichier et la position courante sont
// complétés par des zéros.
dio_close($fd);
?>
]]>
</programlisting>
</example>
</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
-->