Funktsioon substr

Funktsioon substr lõikab välja ja tagastab alamstringi stringist. String ise sellega ei muutu. Esimese parameetrina võtab funktsioon stringi, teise - sümboli positsiooni, kust lõikamist alustada, ja kolmandana - sümbolite arvu. Pane tähele, et stringi sümbolite nummerdamine algab nullist.

Teine parameeter võib olla negatiivne - sel juhul algab loendamine stringi lõpust, kusjuures viimase sümboli number on -1.

Kolmandat parameetrit ei pea määrama - sel juhul lõigatakse kuni stringi lõpuni.

Funktsioon töötab korrektselt ainult ladina tähtedega (ühe baitiga sümbolitega).

Süntaks

substr(string $string, int $offset, ?int $length = null): string

Näide

Lõikame välja 3 sümbolit stringist alates positsioonist 1 (teisest sümbolist, kuna esimesel on number 0):

<?php
	echo substr('abcde', 1, 3);
?>

Koodi täitmise tulemus:

'bcd'

Näide

Lõikame kõik sümbolid kuni stringi lõpuni välja, alates teisest sümbolist (selle number on 1):

<?php
	echo substr('abcde', 1);
?>

Koodi täitmise tulemus:

'bcde'

Näide

Lõikame välja kolmanda ja teise sümboli lõpust, selleks määrame lõikamise alguse -3 (see on kolmanda sümboli number lõpust), ja sümbolite arvu - 2:

<?php
	echo substr('abcde', -3, 2);
?>

Koodi täitmise tulemus:

'cd'

Näide

Lõikame välja 2 viimast sümbolit, selleks määrame eelviimase sümboli positsiooni (see on -2), aga kolmandat parameetrit ei määra - sel juhul lõigatakse kuni stringi lõpuni:

<?php
	echo substr('abcde', -2);
?>

Koodi täitmise tulemus:

'de'

Näide

Lõikame välja viimase sümboli:

<?php
	echo substr('abcde', -1);
?>

Koodi täitmise tulemus:

'e'

Vaata ka

funktsiooni substr_replace,
mis lõikab stringi osa välja ja asendab selle teisega