-
Notifications
You must be signed in to change notification settings - Fork 11
/
Copy pathstr-replace.xml
133 lines (126 loc) · 5 KB
/
str-replace.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
<?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 una matrice, 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 una <type>matrice</type>.
</para>
<warning>
<simpara>
Nelle versioni di PHP antecedenti la 4.3.3 esisteva un errore quando si utilizzano
le matrici 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> è una matrice, allora la ricerca e la
sostituzione sono eseguite su ogni elemento di
<parameter>subject</parameter>, ed il valore restituito è pure una
matrice.
</para>
<para>
Se <parameter>search</parameter> e
<parameter>replace</parameter> sono matrici, allora
<function>str_replace</function> prende i valori da ciascuna matrice
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>
è una matrice 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
-->