mirror of
https://github.com/php/doc-it.git
synced 2026-03-24 23:52:12 +01:00
d5ead59d5b
* Convert Italian translation from 'matrice' to 'array' * Fix grammar error * Fix typo * "associativo" instead of "associativa" * "composto" instead of "composta" * Clarification * "indicizzato" instead of "indicizzata" --------- Co-authored-by: Davide Pastore <pasdavide@gmail.com>
134 lines
5.0 KiB
XML
134 lines
5.0 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!-- EN-Revision: n/a Maintainer: darvina Status: ready -->
|
|
<!-- splitted from ./en/functions/strings.xml, last change in rev 1.2 -->
|
|
<refentry xml:id="function.str-replace" xmlns="http://docbook.org/ns/docbook">
|
|
<refnamediv>
|
|
<refname>str_replace</refname>
|
|
<refpurpose>
|
|
Sostituisce tutte le occorrenze della stringa cercata con la stringa di sostituzione
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Descrizione</title>
|
|
<methodsynopsis>
|
|
<type>mixed</type><methodname>str_replace</methodname>
|
|
<methodparam><type>mixed</type><parameter>search</parameter></methodparam>
|
|
<methodparam><type>mixed</type><parameter>replace</parameter></methodparam>
|
|
<methodparam><type>mixed</type><parameter>subject</parameter></methodparam>
|
|
<methodparam choice="opt"><type>int</type><parameter role="reference">count</parameter></methodparam>
|
|
</methodsynopsis>
|
|
<para>
|
|
Questa funzione restituisce una stringa, od un array, con tutte le occorrenze
|
|
di <parameter>search</parameter> nella stringa <parameter>subject</parameter>
|
|
sostituite con il valore del parametro <parameter>replace</parameter>. Se non occorrono
|
|
particolari capacità di sostituzione (tipo le espressioni regolari), si dovrebbe utilizzare
|
|
questa funzione invece di <function>ereg_replace</function> o
|
|
<function>preg_replace</function>.
|
|
</para>
|
|
<para>
|
|
Dal PHP 4.0.5, ogni parametro di <function>str_replace</function>
|
|
può essere un <type>array</type>.
|
|
</para>
|
|
<warning>
|
|
<simpara>
|
|
Nelle versioni di PHP antecedenti la 4.3.3 esisteva un errore quando si utilizzano
|
|
gli array per <parameter>search</parameter> e <parameter>replace</parameter>
|
|
che faceva ignorare gli indici vuoti di <parameter>search</parameter>
|
|
avanzando il puntatore interno di
|
|
<parameter>replace</parameter>, questo è stato corretto dal
|
|
PHP 4.3.3, ogni script che si basava su questo errore,
|
|
per potere simulare il comportamento originale,
|
|
dovrebbe rimuovere gli elementi vuoti prima di richiamare questa funzione.
|
|
</simpara>
|
|
</warning>
|
|
<para>
|
|
Se <parameter>subject</parameter> è un array, allora la ricerca e la
|
|
sostituzione sono eseguite su ogni elemento di
|
|
<parameter>subject</parameter>, ed il valore restituito è pure un
|
|
array.
|
|
</para>
|
|
<para>
|
|
Se <parameter>search</parameter> e
|
|
<parameter>replace</parameter> sono array, allora
|
|
<function>str_replace</function> prende i valori da ciascun array
|
|
e li usa per svolgere la ricerca e la sostituzione in
|
|
<parameter>subject</parameter>. Se
|
|
<parameter>replace</parameter> ha meno valori di
|
|
<parameter>search</parameter>, allora si utilizzeranno delle stringhe vuote
|
|
per completare i rimanenti valori da sostituire. Se <parameter>search</parameter>
|
|
è un array e <parameter>replace</parameter> è una stringa, allora
|
|
questa stringa di sostituzione sarà utilizzata per ogni valore di
|
|
<parameter>search</parameter>. Il contrario non avrebbe
|
|
senso.
|
|
</para>
|
|
<para>
|
|
<example>
|
|
<title>Esempi di uso di <function>str_replace</function></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// Provides: <body text='black'>
|
|
$bodytag = str_replace("%body%", "black", "<body text='%body%'>");
|
|
|
|
// Provides: Hll Wrld f PHP
|
|
$vowels = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U");
|
|
$onlyconsonants = str_replace($vowels, "", "Hello World of PHP");
|
|
|
|
// Provides: You should eat pizza, beer, and ice cream every day
|
|
$phrase = "You should eat fruits, vegetables, and fiber every day.";
|
|
$healthy = array("fruits", "vegetables", "fiber");
|
|
$yummy = array("pizza", "beer", "ice cream");
|
|
|
|
$newphrase = str_replace($healthy, $yummy, $phrase);
|
|
|
|
// Use of the count parameter is available as of PHP 5.0.0
|
|
$str = str_replace("ll", "", "good golly miss molly!", $count);
|
|
echo $count; // 2
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
|
|
¬e.bin-safe;
|
|
|
|
<note>
|
|
<simpara>
|
|
Dal PHP 5.0.0 il numero di stringhe trovate e
|
|
e sostituite, sarà restituito nel parametro, passato per riferimento,
|
|
<parameter>count</parameter>.
|
|
Nelle versioni antecedenti al PHP 5.0.0 questo parametro non è disponibile.
|
|
</simpara>
|
|
</note>
|
|
<para>
|
|
Vedere anche:
|
|
<function>str_ireplace</function>,
|
|
<function>substr_replace</function>,
|
|
<function>ereg_replace</function>,
|
|
<function>preg_replace</function> e
|
|
<function>strtr</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:"~/.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
|
|
-->
|