You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
172 lines
5.0 KiB
Plaintext
172 lines
5.0 KiB
Plaintext
# Strings
|
|
|
|
These methods are available on both regular and Unicode strings.
|
|
|
|
^ .capitalize()
|
|
|
|
! For regular strings, this method depends on the currently
|
|
configured locale to decide what is 'lowercase' and what is
|
|
'uppercase'.
|
|
|
|
Returns a copy of the string with the first character
|
|
capitalized, and the rest of the characters lowercased.
|
|
|
|
^ .center(`width`[, `fillchar`])
|
|
|
|
Returns a copy of the string, centered by padding it with the
|
|
fill character on both sides until the given width is reached.
|
|
|
|
width::
|
|
The desired width of the final string.
|
|
|
|
fillchar::
|
|
**Optional.** The character to use as a fill character.
|
|
This is a space character by default.
|
|
|
|
^ .count(`sub`[, `start`[, `end`]])
|
|
|
|
Returns the number of non-overlapping occurrences of the given
|
|
substring in the given range.
|
|
|
|
sub::
|
|
The substring to search for.
|
|
|
|
start::
|
|
**Optional.** The starting point for the search.
|
|
Interpreted as in slice notation. Defaults to the start
|
|
of the string.
|
|
|
|
end::
|
|
**Optional.** The end point for the search. Interpreted
|
|
as in slice notation. Defaults to the end of the string.
|
|
|
|
^ .decode([`encoding`[, `errors`]])
|
|
|
|
Returns a `unicode` string containing a copy of the original
|
|
string, decoded using the codec registered for the specified
|
|
encoding.
|
|
|
|
__Since Python 2.7:__ You can also specify the arguments to this
|
|
method as keyword arguments, for clarity.
|
|
|
|
encoding::
|
|
**Optional.** The encoding that the string is currently
|
|
in. If not specified, the value from
|
|
{>sys}(`sys.getdefaultencoding`) is used.
|
|
|
|
errors::
|
|
**Optional.** The error handling scheme to use. Can be
|
|
any of the following values, or any other name that is
|
|
registered through {>codecs}(`codecs.register_error`).
|
|
|
|
strict::
|
|
This is the default. Encoding errors raise a
|
|
`UnicodeError` exception, or a subclass thereof.
|
|
|
|
ignore::
|
|
When an error is encountered, ignore the
|
|
character, and move on to the next one.
|
|
|
|
replace::
|
|
When an error is encountered, replace the
|
|
problematic character with U+FFFD, for the
|
|
built-in Unicode codecs.
|
|
|
|
^ .encode([`encoding`[, `errors`]])
|
|
|
|
Returns a regular string containing a copy of the original
|
|
string, encoded using the codec registered for the specified
|
|
encoding.
|
|
|
|
__Since Python 2.7:__ You can also specify the arguments to this
|
|
method as keyword arguments, for clarity.
|
|
|
|
encoding::
|
|
**Optional.** The encoding you wish to encode the string
|
|
to. If not specified, the value from
|
|
{>sys}(`sys.getdefaultencoding`) is used.
|
|
|
|
errors::
|
|
**Optional.** The error handling scheme to use. Can be
|
|
any of the following values, or any other name that is
|
|
registered through {>codecs}(`codecs.register_error`).
|
|
|
|
strict::
|
|
This is the default. Encoding errors raise a
|
|
`UnicodeError` exception, or a subclass thereof.
|
|
|
|
ignore::
|
|
When an error is encountered, ignore the
|
|
character, and move on to the next one.
|
|
|
|
replace::
|
|
When an error is encountered, replace the
|
|
problematic character with U+FFFD, for the
|
|
built-in Unicode codecs.
|
|
|
|
xmlcharrefreplace::
|
|
When an error is encountered, replace the
|
|
problematic character with the corresponding
|
|
XML entity.
|
|
|
|
backslashreplace::
|
|
When an error is encountered, replace the
|
|
problematic character with the corresponding
|
|
backslashed escape sequence.
|
|
|
|
^ .endswith(`suffix`[, `start`[, `end`]])
|
|
|
|
Returns a boolean, indicating whether the string ends with the
|
|
given suffix or not.
|
|
|
|
suffix::
|
|
The suffix to check for. You can either specify a single
|
|
string, or a tuple of strings to look for.
|
|
|
|
start::
|
|
**Optional.** The starting point for the search.
|
|
Interpreted as in slice notation. Defaults to the start
|
|
of the string.
|
|
|
|
end::
|
|
**Optional.** The end point for the search. Interpreted
|
|
as in slice notation. Defaults to the end of the string.
|
|
|
|
^ .expandtabs([`tabsize`])
|
|
|
|
Returns a copy of the string, with all tab characters replaced
|
|
by one or more spaces, depending on the specified tabsize.
|
|
|
|
The string is divided up into columns, each of which is as wide
|
|
as the given tabsize. After every part of the string that is not
|
|
a tab character, the current column is filled up with one or
|
|
more spaces, until the next column 'border' is reached. If there
|
|
are multiple tab characters in a row, the remaining tab
|
|
characters will fill up an entire column each.
|
|
|
|
! Every character that is not a tab, newline or return, will be
|
|
treated as being one position wide, even if they are not
|
|
displayed when printing the entire string.
|
|
|
|
tabsize::
|
|
**Optional.** The amount of spaces that a tab character
|
|
should be replaced with, at most. Defaults to 8.
|
|
|
|
^ .find(`sub`[, `start`[, `end`]])
|
|
|
|
Returns the first position in the string where the given
|
|
substring is found. If the substring is not found, the value
|
|
`-1` is returned.
|
|
|
|
sub::
|
|
The substring to search for.
|
|
|
|
start::
|
|
**Optional.** The starting point for the search.
|
|
Interpreted as in slice notation. Defaults to the start
|
|
of the string.
|
|
|
|
end::
|
|
**Optional.** The end point for the search. Interpreted
|
|
as in slice notation. Defaults to the end of the string.
|