2.2.6.1 Metody klasy string

Metody klasy string, dla napisów 8 bitowych jak również dla napisów Unicode:

capitalize(): Zwraca kopię napisu z pierwszym znakiem zmienionym na wielką literę.

center(szerokość): Zwraca kopię napisu wycentrowaną w napisie o szerokości szerokość. Wypełnienie jest uzyskane za pomocą znaków spacji. Jeśli szerokość jest mniejsza od len(s) zwracany jest oryginalny napis.

count(napis[, początek[, koniec]]): Zwraca ilość wystąpień napisu napis w napisie S[początek:koniec]. Opcjonalne argumenty początek i koniec są interpretowane tak samo, jak w operacji wycinania.

decode([encoding[, errors]]): Zwraca odkodowaną wersję napisu, wykorzystując kodek zarejestrowany dla kodowania zdefiniowanego parametrem encoding. parametr encoding domyślnie przyjmuje wartość domyślnego kodowania napisów. Parametr errors jest wykorzystywany w celu określenia alternatywnego sposobu obsługi błędów. Domyślną wartością tego parametru jest 'strict', co w rezultacie powoduje wywoływanie wyjątka ValueError w przypadku wystąpienia błędu kodowania. Innymi wartościami parametru errors mogą być 'ignore' oraz 'replace'. Dodano w wersji 2.2.

encode([kodowanie[, błędy]]): Zwraca zakodowaną wersję napisu. Domyślnym kodowaniem jest aktualne kodowanie napisu. Parametr błędy służy zdefiniowaniu metody obsługi błędów. Domyślną wartością dla błędy jest 'strict', wymuszające wywołanie wyjątku ValueErrordla wszystkich błędów kodowania. Innymi dopuszczalnymi wartościami są: 'ignore' i 'replace'. Dodano w wersji 2.0.

endswith(przyrostek[, początek[, koniec]]): Zwraca wynik sprawdzenia, czy napis jest zakończony napisem przyrostek. Przy wystąpieniu argumentu początek, sprawdzenie rozpoczyna się od tego znaku. Przy wystąpieniu argumentu koniec porównanie zakończy się na tym znaku.

expandtabs([wielkość]): Zwraca kopię napisu ze wszystkimi znakami tabulacji zastąpionymi przez znaki spacji. Jeśli wielkość nie zostanie podana, przyjmuje się rozmiar tabulacji jako 8 znaków.

find(napis[, początek[, koniec]]): Zwraca najniższy indeks wystąpienia napisu napis, takiego, aby napis był zawarty w przedziale [początek, koniec). Opcjonalne argumenty początek i koniec są interpretowane tak samo, jak w operacji wycinania. Zwraca -1 jeśli napis nie został znaleziony.

index(napis[, początek[, koniec]]): Działanie podobne do find(), ale wywołuje wyjątek ValueError jeśli napis nie zostanie znaleziony.

isalnum(): Zwraca wynik sprawdzenia, czy wszystkie znaki napisu są znakami alfanumerycznymi i napis składa się przynajmniej z jednego znaku.

isalpha(): Zwraca wynik sprawdzenia, czy wszystkie znaki napisu są literami i napis składa się przynajmniej z jednego znaku.

isdigit(): Zwraca wynik sprawdzenia, czy wszystkie znaki napisu są cyframi.

islower(): Zwraca wynik sprawdzenia, czy wszystkie litery napisu są małymi literami i napis składa się przynajmniej z jednego znaku.

isspace(): Zwraca wynik sprawdzenia, czy wszystkie znaki napisu są białymi znakami i napis składa się przynajmniej z jednego znaku.

istitle(): Zwraca wynik sprawdzenia, czy napis ma strukturę tytułu, to znaczy każdy wyraz napisu musi zaczynać się wielką literą i składać wyłącznie z małych liter lub znaków nieliterowych.

isupper(): Zwraca wynik sprawdzenia, czy wszystkie litery napisu są wielkimi literami i napis składa się przynajmniej z jednego znaku.

join(sek): Zwraca napis stanowiący połączenie napisów wchodzących w skład sekwencji sek. Separator pomiędzy elementami stanowi napis, którego metodę wywołujemy.

ljust(szerokość): Zwraca kopię napisu wyrównaną do lewej w napisie o szerokości szerokość. Wypełnienie jest uzyskane za pomocą znaków spacji. Jeśli szerokość jest mniejsza od len(s) zwracany jest oryginalny napis.

lower(): Zwraca kopię napisu zamienionego na małe litery.

lstrip([chars]): Zwraca kopię napisu z usuniętymi znakami z początku napisu. W przypadku, gdy parametr chars nie został podany, lub ma wartość None, usunięte zostaną białe znaki. Jeśli parametr ten jest podany i nie ma wartości None, musi być typu napisowego. Z początku napisu, u którego wywołaliśmy tę metodę, zostaną usunięte znaki wchodzące w skład parametru chars. Zmieniono w wersji 2.2.2: Obsługa argumentu chars.

replace(stary, nowy[, ilość]): Zwraca kopię napisu z wszystkimi wystąpieniami napisu stary zastąpionymi przez nowy. Jeśli zostanie podany argument ilość, zostanie zastąpiona tylko pierwsza ilość wystąpień.

rfind(napis [,początek [, koniec]]): Zwraca najwyższy indeks wystąpienia napisu napis, takiego, aby napis był zawarty w przedziale [początek, koniec). Opcjonalne argumenty początek i koniec są interpretowane tak samo, jak w operacji wycinania. Zwraca -1 jeśli napis nie został znaleziony.

rindex(sub[, start[, end]]): Działanie podobne do rfind(), ale wywołuje wyjątek ValueError jeśli napis nie zostanie znaleziony.

rjust(szerokość): Zwraca kopię napisu wyrównaną do prawej w napisie o szerokości szerokość. Wypełnienie jest uzyskane za pomocą znaków spacji. Jeśli szerokość jest mniejsza od len(s) zwracany jest oryginalny napis.

rstrip([chars]): Zwraca kopię napisu z usuniętymi znakami z końca napisu. W przypadku, gdy parametr chars nie został podany, lub ma wartość None, usunięte zostaną białe znaki. Jeśli parametr ten jest podany i nie ma wartości None, musi być typu napisowego. Z końca napisu, u którego wywołaliśmy tę metodę, zostaną usunięte znaki wchodzące w skład parametru chars. Zmieniono w wersji 2.2.2: Obsługa argumentu chars.

split([separator [, ilość]]): Zwraca listę słów wchodzących w skład napisu z wykorzystaniem napisu separator jako separatora wyrazów. Jeśli jest podana ilość wykonana jest najwyżej ilość podziałów. Jeśli separator nie jest podany, lub jest równy None separatorem jest jakikolwiek biały znak.

splitlines([zachowaj_końce]): Zwraca listę wierszy wchodzących w skład napisu podzielonych na znaku podziału wiersza. Znaki podziału wiersza nie zostają włączone do składników listy wynikowej o ile nie zostanie podany argument zachowaj_końce zwracający wartość prawdziwą.

startswith(prefix[, start[, end]]): Zwraca wynik sprawdzenia, czy napis zaczyna się napisem prefix. Przy wystąpieniu argumentu start, sprawdzenie rozpoczyna się od tego znaku. Przy wystąpieniu argumentu end porównanie zakończy się na tym znaku.

strip([chars]): Zwraca kopię napisu z usuniętymi znakami z początku i końca napisu. W przypadku, gdy parametr chars nie został podany, lub ma wartość None, usunięte zostaną białe znaki. Jeśli parametr ten jest podany i nie ma wartości None, musi być typu napisowego. Z początku i końca napisu, u którego wywołaliśmy tę metodę, zostaną usunięte znaki wchodzące w skład parametru chars. Zmieniono w wersji 2.2.2: Obsługa argumentu chars.

swapcase(): Zwraca kopię napisu z małymi literami zamienionymi na wielkie i vice versa.

title(): Zwraca kopie napisu zamienioną na strukturę tytułu, to znaczy każdy wyraz napisu zostaje zamieniony na rozpoczynający się wielką literą z pozostałymi literami zamienionymi na małe.

translate(krotka[, usuń]): Zwraca kopię napisu z usuniętymi wszystkimi literami występującymi w usuń, a pozostałe litery zostają odwzorowane z wykorzystaniem podanej krotki translacji krotka, która musi być 256 znakowym napisem.

upper(): Zwraca kopię napisu z wszystkimi literami zamienionymi na wielkie litery.

zfill(width): Zwraca napis uzupełniony z lewej strony zerami do szeroości podanej w parametrze width. W przypadku, gdy wartość parametru width jest mniejsza od długości napisu, zostanie zwrócony oryginalny napis. Dodano w wersji 2.2.2.

Zajrzyj do Informacji na temat tej publikacji... aby pomóc w jej rozwoju.