(PHP 4, PHP 5, PHP 7)

str_replace — Înlocuiește toate aparițiile șirului de căutare cu șirul de înlocuire

Descriere

Această funcție returnează un șir sau o matrice cu toate aparițiile de căutare în subiect înlocuite cu înlocuire.

Dacă nu aveți nevoie de reguli complexe de căutare/înlocuire (cum ar fi expresiile regulate), utilizarea acestei funcții este de preferat preg_replace() .

Lista parametrilor

Dacă căutare și înlocuire sunt matrice, atunci str_replace() utilizează fiecare valoare din matricea corespunzătoare pentru a căuta și înlocui în subiect . Dacă matricea de înlocuire are mai puține elemente decât search , șirul gol va fi folosit ca șir de înlocuire pentru valorile rămase. Dacă căutarea este o matrice și înlocuirea este un șir, atunci acel șir de înlocuire va fi folosit pentru fiecare element al matricei de căutare. Cazul invers nu are sens.

Dacă căutarea sau înlocuirea sunt matrice, elementele lor vor fi procesate de la primul până la ultimul.

Valoarea de căutare, cunoscută și ca ac(ac). Puteți utiliza o matrice pentru mai multe valori de căutare.

A inlocui

Valoarea de înlocuire va fi folosită pentru a înlocui valorile de căutare. Puteți utiliza o matrice pentru mai multe valori.

Subiect

Șirul sau matricea pe care se efectuează căutarea și înlocuirea, cunoscută și ca carul de fân(un teanc de fân).

Dacă subiectul este o matrice, atunci căutarea și înlocuirea vor fi efectuate pe fiecare element subiect, iar rezultatul funcției va fi, de asemenea, o matrice.

Dacă este trecut, acesta va fi setat la numărul de înlocuiri efectuate.

Valori returnate

Această funcție returnează un șir sau o matrice cu valorile înlocuite.

Exemple

Exemplul #1 Exemple de utilizare a str_replace()

Exemplul #2 Exemple de trucuri potențiale cu str_replace()

Note

Notă: Această funcție este binară sigură.

Avertizare

Notă despre procedura de înlocuire

Deoarece str_replace() înlocuiește de la stânga la dreapta, atunci când se utilizează mai multe înlocuiri, poate înlocui o valoare introdusă anterior cu alta. Vezi și exemple pe această pagină.

Notă:

Această funcție ține cont de majuscule și minuscule. Folosiți str_ireplace() pentru înlocuirea fără majuscule.

Notă: În PHP 7.0.0 pe platforme pe 64 de biți, nu există limite realizabile privind lungimea șirurilor, pe sistemele pe 32 de biți și anterioare versiuni PHP, rândurile nu pot fi mai mari de 2 GB (2147483647 octeți).

Sintaxă

Un șir poate fi definit cu patru căi diferite:

• ghilimele simple
• ghilimele duble
• sintaxa nowdoc (din PHP 5.3.0)

Ghilimele simple

Cel mai simplu mod a defini un șir înseamnă a-l încadra între ghilimele simple (caracter " ).

Pentru a utiliza un singur ghilimele într-un șir, evadați-l cu o bară oblică inversă ( \ ). Dacă trebuie să scrieți bara oblică inversă, duplicați-o ( \\ ). Toate celelalte utilizări ale barei oblice inverse vor fi interpretate ca caractere normale: aceasta înseamnă că dacă încercați să utilizați alte secvențe de escape, cum ar fi \r sau \n, vor fi scoase ca atare în loc de orice comportament special.