Dokumentacja języka JavaScript 1.5:Obiekty:String:substr
z Mozilla Developer Center, polskiego centrum programistów Mozilli.
Spis treści |
[edytuj] Podsumowanie
Zwraca określoną liczbę początkowych znaków w łańcuchu znaków w określonej lokalizacji.
| Metoda obiektu: String | |
| Zaimplementowana w: | JavaScript 1.0, NES2.0 |
[edytuj] Składnia
substr(start[, length])
[edytuj] Parametry
-
start - Lokalizacja, w której rozpoczyna się wyciąganie znaków (wartość liczbowa pomiędzy 0, a jeden znak mniej niż długość łańcucha znaków).
-
length - Liczba znaków do wyciągnięcia.
[edytuj] Opis
start jest indeksem znaków. Pierwszym znakiem w indeksie jest 0 i ostatnim znakiem w indeksie jest liczba o 1 mniejsza niż długość łańcucha znaków. substr rozpoczyna wyciąganie znaków w start i ściąga liczbę length znaków.
Jeśli start jest dodanie i jest długością łańcucha znaków lub dłuższą wartością, substr nie zwraca znaków.
Jeśli start jest ujemne, substr stosuje to jako indeks znaków z końca łańcucha znaków. Jeśli start jest ujemne i abs(start) jest większe niż długość łańcucha znaków to substr stosuje 0 jest początkiem indeksu.
Jeśli length jest 0 lub ujemne, substr nie zwróci znaków. Jeśli length jest opuszczony, start wyciągnie znaki do końca łańcucha znaków.
[edytuj] Przykłady
[edytuj] Przykład: Zastosowanie substr
Rozpatrz poniższy skrypt:
str = "abcdefghij";
document.writeln("(1,2): ", str.substr(1,2));
document.writeln("(-2,2): ", str.substr(-2,2));
document.writeln("(1): ", str.substr(1));
document.writeln("(-20, 2): ", str.substr(-20,2));
document.writeln("(20, 2): ", str.substr(20,2));
Ten skrypt wyświetli:
(1,2): bc (-2,2): ij (1): bcdefghij (-20, 2): ab (20, 2):