Files
doc-fr/reference/strings/functions/substr-replace.xml
David Manusset 34b976e4c6 typo
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@197283 c90b9560-bf6c-de11-be94-00142212c4b1
2005-10-01 08:23:25 +00:00

106 lines
3.5 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- EN-Revision: 1.5 Maintainer: didou Status: ready -->
<!-- Reviewed: yes -->
<refentry id="function.substr-replace">
<refnamediv>
<refname>substr_replace</refname>
<refpurpose>Remplace un segment dans une chaîne</refpurpose>
</refnamediv>
<refsect1>
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>substr_replace</methodname>
<methodparam><type>mixed</type><parameter>string</parameter></methodparam>
<methodparam><type>string</type><parameter>replacement</parameter></methodparam>
<methodparam><type>int</type><parameter>start</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>length</parameter></methodparam>
</methodsynopsis>
<para>
<function>substr_replace</function> remplace un segment de la
chaîne <parameter>string</parameter> par la chaîne
<parameter>replacement</parameter>. Le segment est délimité
par <parameter>start</parameter> et éventuellement par
<parameter>length</parameter>. La chaîne de résultat est retournée.
Si <parameter>string</parameter> est un tableau, alors un tableau est
retourné.
</para>
<para>
Si <parameter>start</parameter> est positif, le remplacement
se fera à partir du <parameter>start</parameter>-ième caractère
de <parameter>string</parameter>.
</para>
<para>
Si <parameter>start</parameter> est négatif, le remplacement
se fera à partir du <parameter>start</parameter>-ième caractère
en partant de la fin de la chaîne <parameter>string</parameter>.
</para>
<para>
Si <parameter>length</parameter> est fourni et positif, il
représentera la longueur du segment de code remplacé dans la
chaîne <parameter>string</parameter>. S'il est négatif, il
représentera la longueur du segment remplacé, mais compté
dans l'ordre inverse de la chaîne <parameter>string</parameter>.
S'il est omis, il prendra la valeur par défaut de la taille
de la chaîne, et remplacera tout jusqu'à la fin de la chaîne
<parameter>string</parameter>.
</para>
<para>
<example>
<title>Exemple avec <function>substr_replace</function></title>
<programlisting role="php">
<![CDATA[
<?php
$var = 'ABCDEFGH:/MNRPQR/';
echo "Original : $var<hr>\n";
// Remplace toute la chaîne $var par 'bob'.
echo substr_replace($var, 'bob', 0) . "<br />\n";
echo substr_replace($var, 'bob', 0, strlen($var)) . "<br />\n";
// Insert 'bob' au début de la chaîne
echo substr_replace($var, 'bob', 0, 0) . "<br />\n";
// Remplace la séquence 'MNRPQR' par 'bob'.
echo substr_replace($var, 'bob', 10, -1) . "<br />\n";
echo substr_replace($var, 'bob', -7, -1) . "<br />\n";
// Efface la séquence 'MNRPQR' de $var.
echo substr_replace($var, '', 10, -1) . "<br />\n";
?>
]]>
</programlisting>
</example>
</para>
&note.bin-safe;
<para>
Voir aussi
<function>str_replace</function> et
<function>substr</function>.
</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:"../../../../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
-->