cpython-lru_cache-weakref: Lib/string.py annotate

annotate Lib/string.py @ 25838:8540887bcec6 2.2

Backport of 2.183: Fix memory leak in add_subclass() found by NealN with valgrind.

author	Guido van Rossum <guido@python.org>
date	Fri, 18 Oct 2002 13:42:21 +0000
parents	b08b51dce264
children	2832628ee8cc

rev	line source
11707 6f4146846337 The third and final doc-string sweep by Ka-Ping Yee. Guido van Rossum <guido@python.org> parents: 11439 diff changeset	1 """A collection of string operations (most are no longer used in Python 1.6).
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	2
11707 6f4146846337 The third and final doc-string sweep by Ka-Ping Yee. Guido van Rossum <guido@python.org> parents: 11439 diff changeset	3 Warning: most of the code you see here isn't normally used nowadays. With
6f4146846337 The third and final doc-string sweep by Ka-Ping Yee. Guido van Rossum <guido@python.org> parents: 11439 diff changeset	4 Python 1.6, many of these functions are implemented as methods on the
6f4146846337 The third and final doc-string sweep by Ka-Ping Yee. Guido van Rossum <guido@python.org> parents: 11439 diff changeset	5 standard string object. They used to be implemented by a built-in module
6f4146846337 The third and final doc-string sweep by Ka-Ping Yee. Guido van Rossum <guido@python.org> parents: 11439 diff changeset	6 called strop, but strop is now obsolete itself.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	7
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	8 Public module variables:
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	9
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	10 whitespace -- a string containing all characters considered whitespace
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	11 lowercase -- a string containing all characters considered lowercase letters
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	12 uppercase -- a string containing all characters considered uppercase letters
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	13 letters -- a string containing all characters considered letters
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	14 digits -- a string containing all characters considered decimal digits
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	15 hexdigits -- a string containing all characters considered hexadecimal digits
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	16 octdigits -- a string containing all characters considered octal digits
14670 8db8606d84ea Fix serious typo! Fred Drake <fdrake@acm.org> parents: 14665 diff changeset	17 punctuation -- a string containing all characters considered punctuation
8db8606d84ea Fix serious typo! Fred Drake <fdrake@acm.org> parents: 14665 diff changeset	18 printable -- a string containing all characters considered printable
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	19
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	20 """
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	21
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	22 # Some strings for ctype-style character classification
1331 07900834cc97 * pdb.py: set 'privileged' property when evaluating expressions Guido van Rossum <guido@python.org> parents: 1291 diff changeset	23 whitespace = ' \t\n\r\v\f'
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	24 lowercase = 'abcdefghijklmnopqrstuvwxyz'
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	25 uppercase = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	26 letters = lowercase + uppercase
18776 22b2f4b436af Added the constants ascii_letters, ascii_lowercase, and ascii_uppercase Fred Drake <fdrake@acm.org> parents: 16657 diff changeset	27 ascii_lowercase = lowercase
22b2f4b436af Added the constants ascii_letters, ascii_lowercase, and ascii_uppercase Fred Drake <fdrake@acm.org> parents: 16657 diff changeset	28 ascii_uppercase = uppercase
22b2f4b436af Added the constants ascii_letters, ascii_lowercase, and ascii_uppercase Fred Drake <fdrake@acm.org> parents: 16657 diff changeset	29 ascii_letters = ascii_lowercase + ascii_uppercase
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	30 digits = '0123456789'
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	31 hexdigits = digits + 'abcdef' + 'ABCDEF'
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	32 octdigits = '01234567'
15872 3685ef2a55a4 Whitespace normalization. Tim Peters <tim.peters@gmail.com> parents: 15610 diff changeset	33 punctuation = """!"#$%&'()*+,-./:;<=>?@[\]^_`{\|}~"""
14665 6fcf5a70533c Richard Mortier <rmm1002@users.sourceforge.net>: Fred Drake <fdrake@acm.org> parents: 13620 diff changeset	34 printable = digits + letters + punctuation + whitespace
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	35
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	36 # Case conversion helpers
585 37905fe1892a New implementation method for case conversion. Guido van Rossum <guido@python.org> parents: 559 diff changeset	37 _idmap = ''
37905fe1892a New implementation method for case conversion. Guido van Rossum <guido@python.org> parents: 559 diff changeset	38 for i in range(256): _idmap = _idmap + chr(i)
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	39 del i
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	40
1788 56a986e49f56 * Lib/string.py: find/rfind is now the main implementation and Guido van Rossum <guido@python.org> parents: 1746 diff changeset	41 # Backward compatible names for exceptions
56a986e49f56 * Lib/string.py: find/rfind is now the main implementation and Guido van Rossum <guido@python.org> parents: 1746 diff changeset	42 index_error = ValueError
56a986e49f56 * Lib/string.py: find/rfind is now the main implementation and Guido van Rossum <guido@python.org> parents: 1746 diff changeset	43 atoi_error = ValueError
56a986e49f56 * Lib/string.py: find/rfind is now the main implementation and Guido van Rossum <guido@python.org> parents: 1746 diff changeset	44 atof_error = ValueError
56a986e49f56 * Lib/string.py: find/rfind is now the main implementation and Guido van Rossum <guido@python.org> parents: 1746 diff changeset	45 atol_error = ValueError
56a986e49f56 * Lib/string.py: find/rfind is now the main implementation and Guido van Rossum <guido@python.org> parents: 1746 diff changeset	46
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	47 # convert UPPER CASE letters to lower case
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	48 def lower(s):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	49 """lower(s) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	50
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	51 Return a copy of the string s converted to lowercase.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	52
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	53 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	54 return s.lower()
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	55
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	56 # Convert lower case letters to UPPER CASE
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	57 def upper(s):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	58 """upper(s) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	59
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	60 Return a copy of the string s converted to uppercase.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	61
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	62 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	63 return s.upper()
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	64
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	65 # Swap lower case letters and UPPER CASE
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	66 def swapcase(s):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	67 """swapcase(s) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	68
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	69 Return a copy of the string s with upper case characters
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	70 converted to lowercase and vice versa.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	71
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	72 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	73 return s.swapcase()
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	74
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	75 # Strip leading and trailing tabs and spaces
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	76 def strip(s):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	77 """strip(s) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	78
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	79 Return a copy of the string s with leading and trailing
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	80 whitespace removed.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	81
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	82 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	83 return s.strip()
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	84
3957 f01e7af1dd60 Add optional third parameter to split() and splitfields(), giving the Guido van Rossum <guido@python.org> parents: 3799 diff changeset	85 # Strip leading tabs and spaces
f01e7af1dd60 Add optional third parameter to split() and splitfields(), giving the Guido van Rossum <guido@python.org> parents: 3799 diff changeset	86 def lstrip(s):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	87 """lstrip(s) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	88
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	89 Return a copy of the string s with leading whitespace removed.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	90
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	91 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	92 return s.lstrip()
3957 f01e7af1dd60 Add optional third parameter to split() and splitfields(), giving the Guido van Rossum <guido@python.org> parents: 3799 diff changeset	93
f01e7af1dd60 Add optional third parameter to split() and splitfields(), giving the Guido van Rossum <guido@python.org> parents: 3799 diff changeset	94 # Strip trailing tabs and spaces
f01e7af1dd60 Add optional third parameter to split() and splitfields(), giving the Guido van Rossum <guido@python.org> parents: 3799 diff changeset	95 def rstrip(s):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	96 """rstrip(s) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	97
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	98 Return a copy of the string s with trailing whitespace
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	99 removed.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	100
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	101 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	102 return s.rstrip()
3957 f01e7af1dd60 Add optional third parameter to split() and splitfields(), giving the Guido van Rossum <guido@python.org> parents: 3799 diff changeset	103
f01e7af1dd60 Add optional third parameter to split() and splitfields(), giving the Guido van Rossum <guido@python.org> parents: 3799 diff changeset	104
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	105 # Split a string into a list of space/tab-separated words
11991 81702a7354ec Marc-Andre Lemburg: the maxsplit argument for split() and replace() Guido van Rossum <guido@python.org> parents: 11741 diff changeset	106 def split(s, sep=None, maxsplit=-1):
11439 316be08c9ecd split() docstring: Made signature and description for the first Fred Drake <fdrake@acm.org> parents: 11383 diff changeset	107 """split(s [,sep [,maxsplit]]) -> list of strings
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	108
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	109 Return a list of the words in the string s, using sep as the
21848 fd424f519a8e string.split() docstring described the interpretation of the maxsplit Fred Drake <fdrake@acm.org> parents: 18776 diff changeset	110 delimiter string. If maxsplit is given, splits at no more than
fd424f519a8e string.split() docstring described the interpretation of the maxsplit Fred Drake <fdrake@acm.org> parents: 18776 diff changeset	111 maxsplit places (resulting in at most maxsplit+1 words). If sep
fd424f519a8e string.split() docstring described the interpretation of the maxsplit Fred Drake <fdrake@acm.org> parents: 18776 diff changeset	112 is not specified, any whitespace string is a separator.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	113
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	114 (split and splitfields are synonymous)
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	115
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	116 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	117 return s.split(sep, maxsplit)
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	118 splitfields = split
196 48fc0b8f33d9 Added join() and joinfields() functions. Guido van Rossum <guido@python.org> parents: 102 diff changeset	119
2778 17fdec2fb309 make split and splitfields, join and joinfields synonyms Guido van Rossum <guido@python.org> parents: 2541 diff changeset	120 # Join fields with optional separator
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	121 def join(words, sep = ' '):
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	122 """join(list [,sep]) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	123
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	124 Return a string composed of the words in list, with
13620 5b727ab37092 Spelling fixes supplied by Rob W. W. Hooft. All these are fixes in either Thomas Wouters <thomas@python.org> parents: 13315 diff changeset	125 intervening occurrences of sep. The default separator is a
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	126 single space.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	127
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	128 (joinfields and join are synonymous)
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	129
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	130 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	131 return sep.join(words)
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	132 joinfields = join
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	133
1291 517d29ebc840 * ftplib.py: added abort() command (sends oob data). Guido van Rossum <guido@python.org> parents: 1260 diff changeset	134 # Find substring, raise exception if not found
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	135 def index(s, *args):
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	136 """index(s, sub [,start [,end]]) -> int
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	137
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	138 Like find but raises ValueError when the substring is not found.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	139
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	140 """
13315 58183679c90a Martin von Löwis <martin@loewis.home.cs.tu-berlin.de>: Fred Drake <fdrake@acm.org> parents: 12248 diff changeset	141 return s.index(*args)
1291 517d29ebc840 * ftplib.py: added abort() command (sends oob data). Guido van Rossum <guido@python.org> parents: 1260 diff changeset	142
1403 6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret Guido van Rossum <guido@python.org> parents: 1357 diff changeset	143 # Find last substring, raise exception if not found
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	144 def rindex(s, *args):
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	145 """rindex(s, sub [,start [,end]]) -> int
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	146
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	147 Like rfind but raises ValueError when the substring is not found.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	148
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	149 """
13315 58183679c90a Martin von Löwis <martin@loewis.home.cs.tu-berlin.de>: Fred Drake <fdrake@acm.org> parents: 12248 diff changeset	150 return s.rindex(*args)
1746 1940892d2fe3 Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1403 diff changeset	151
1940892d2fe3 Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1403 diff changeset	152 # Count non-overlapping occurrences of substring
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	153 def count(s, *args):
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	154 """count(s, sub[, start[,end]]) -> int
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	155
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	156 Return the number of occurrences of substring sub in string
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	157 s[start:end]. Optional arguments start and end are
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	158 interpreted as in slice notation.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	159
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	160 """
13315 58183679c90a Martin von Löwis <martin@loewis.home.cs.tu-berlin.de>: Fred Drake <fdrake@acm.org> parents: 12248 diff changeset	161 return s.count(*args)
1403 6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret Guido van Rossum <guido@python.org> parents: 1357 diff changeset	162
1291 517d29ebc840 * ftplib.py: added abort() command (sends oob data). Guido van Rossum <guido@python.org> parents: 1260 diff changeset	163 # Find substring, return -1 if not found
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	164 def find(s, *args):
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	165 """find(s, sub [,start [,end]]) -> in
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	166
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	167 Return the lowest index in s where substring sub is found,
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	168 such that sub is contained within s[start,end]. Optional
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	169 arguments start and end are interpreted as in slice notation.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	170
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	171 Return -1 on failure.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	172
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	173 """
13315 58183679c90a Martin von Löwis <martin@loewis.home.cs.tu-berlin.de>: Fred Drake <fdrake@acm.org> parents: 12248 diff changeset	174 return s.find(*args)
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	175
1403 6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret Guido van Rossum <guido@python.org> parents: 1357 diff changeset	176 # Find last substring, return -1 if not found
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	177 def rfind(s, *args):
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	178 """rfind(s, sub [,start [,end]]) -> int
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	179
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	180 Return the highest index in s where substring sub is found,
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	181 such that sub is contained within s[start,end]. Optional
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	182 arguments start and end are interpreted as in slice notation.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	183
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	184 Return -1 on failure.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	185
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	186 """
13315 58183679c90a Martin von Löwis <martin@loewis.home.cs.tu-berlin.de>: Fred Drake <fdrake@acm.org> parents: 12248 diff changeset	187 return s.rfind(*args)
1403 6278933d02e3 * string.py: added rindex(), rfind(); changed index() to interpret Guido van Rossum <guido@python.org> parents: 1357 diff changeset	188
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	189 # for a bit of speed
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	190 _float = float
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	191 _int = int
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	192 _long = long
23219 b08b51dce264 Backport the following changes: Walter Dörwald <walter@livinglogic.de> parents: 21848 diff changeset	193 try:
b08b51dce264 Backport the following changes: Walter Dörwald <walter@livinglogic.de> parents: 21848 diff changeset	194 _StringTypes = (str, unicode)
b08b51dce264 Backport the following changes: Walter Dörwald <walter@livinglogic.de> parents: 21848 diff changeset	195 except NameError:
b08b51dce264 Backport the following changes: Walter Dörwald <walter@livinglogic.de> parents: 21848 diff changeset	196 _StringTypes = (str,)
6821 b19cd4313126 At Barry's suggestion, plug the security leak by using an empty Guido van Rossum <guido@python.org> parents: 6820 diff changeset	197
1357 2fac209e1c3f * profile.py, pdb.py: added help() function Guido van Rossum <guido@python.org> parents: 1331 diff changeset	198 # Convert string to float
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	199 def atof(s):
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	200 """atof(s) -> float
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	201
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	202 Return the floating point number represented by the string s.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	203
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	204 """
12248 70154e2e9c89 Marc-Andre's third try at this bulk patch seems to work (except that Guido van Rossum <guido@python.org> parents: 11991 diff changeset	205 return _float(s)
70154e2e9c89 Marc-Andre's third try at this bulk patch seems to work (except that Guido van Rossum <guido@python.org> parents: 11991 diff changeset	206
1357 2fac209e1c3f * profile.py, pdb.py: added help() function Guido van Rossum <guido@python.org> parents: 1331 diff changeset	207
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	208 # Convert string to integer
12248 70154e2e9c89 Marc-Andre's third try at this bulk patch seems to work (except that Guido van Rossum <guido@python.org> parents: 11991 diff changeset	209 def atoi(s , base=10):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	210 """atoi(s [,base]) -> int
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	211
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	212 Return the integer represented by the string s in the given
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	213 base, which defaults to 10. The string s must consist of one
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	214 or more digits, possibly preceded by a sign. If base is 0, it
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	215 is chosen from the leading characters of s, 0 for octal, 0x or
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	216 0X for hexadecimal. If base is 16, a preceding 0x or 0X is
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	217 accepted.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	218
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	219 """
12248 70154e2e9c89 Marc-Andre's third try at this bulk patch seems to work (except that Guido van Rossum <guido@python.org> parents: 11991 diff changeset	220 return _int(s, base)
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	221
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	222
1357 2fac209e1c3f * profile.py, pdb.py: added help() function Guido van Rossum <guido@python.org> parents: 1331 diff changeset	223 # Convert string to long integer
12248 70154e2e9c89 Marc-Andre's third try at this bulk patch seems to work (except that Guido van Rossum <guido@python.org> parents: 11991 diff changeset	224 def atol(s, base=10):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	225 """atol(s [,base]) -> long
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	226
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	227 Return the long integer represented by the string s in the
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	228 given base, which defaults to 10. The string s must consist
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	229 of one or more digits, possibly preceded by a sign. If base
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	230 is 0, it is chosen from the leading characters of s, 0 for
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	231 octal, 0x or 0X for hexadecimal. If base is 16, a preceding
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	232 0x or 0X is accepted. A trailing L or l is not accepted,
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	233 unless base is 0.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	234
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	235 """
12248 70154e2e9c89 Marc-Andre's third try at this bulk patch seems to work (except that Guido van Rossum <guido@python.org> parents: 11991 diff changeset	236 return _long(s, base)
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	237
1357 2fac209e1c3f * profile.py, pdb.py: added help() function Guido van Rossum <guido@python.org> parents: 1331 diff changeset	238
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	239 # Left-justify a string
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	240 def ljust(s, width):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	241 """ljust(s, width) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	242
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	243 Return a left-justified version of s, in a field of the
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	244 specified width, padded with spaces as needed. The string is
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	245 never truncated.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	246
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	247 """
13315 58183679c90a Martin von Löwis <martin@loewis.home.cs.tu-berlin.de>: Fred Drake <fdrake@acm.org> parents: 12248 diff changeset	248 return s.ljust(width)
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	249
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	250 # Right-justify a string
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	251 def rjust(s, width):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	252 """rjust(s, width) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	253
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	254 Return a right-justified version of s, in a field of the
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	255 specified width, padded with spaces as needed. The string is
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	256 never truncated.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	257
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	258 """
13315 58183679c90a Martin von Löwis <martin@loewis.home.cs.tu-berlin.de>: Fred Drake <fdrake@acm.org> parents: 12248 diff changeset	259 return s.rjust(width)
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	260
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	261 # Center a string
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	262 def center(s, width):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	263 """center(s, width) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	264
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	265 Return a center version of s, in a field of the specified
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	266 width. padded with spaces as needed. The string is never
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	267 truncated.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	268
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	269 """
13315 58183679c90a Martin von Löwis <martin@loewis.home.cs.tu-berlin.de>: Fred Drake <fdrake@acm.org> parents: 12248 diff changeset	270 return s.center(width)
5 5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	271
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	272 # Zero-fill a number, e.g., (12, 3) --> '012' and (-3, 3) --> '-03'
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	273 # Decadent feature: the argument may be a string or a number
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	274 # (Use of this is deprecated; it should be a string as with ljust c.s.)
5570dbb1ce55 Initial revision Guido van Rossum <guido@python.org> parents: diff changeset	275 def zfill(x, width):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	276 """zfill(x, width) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	277
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	278 Pad a numeric string x with zeros on the left, to fill a field
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	279 of the specified width. The string x is never truncated.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	280
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	281 """
23219 b08b51dce264 Backport the following changes: Walter Dörwald <walter@livinglogic.de> parents: 21848 diff changeset	282 if not isinstance(x, _StringTypes):
b08b51dce264 Backport the following changes: Walter Dörwald <walter@livinglogic.de> parents: 21848 diff changeset	283 x = repr(x)
b08b51dce264 Backport the following changes: Walter Dörwald <walter@livinglogic.de> parents: 21848 diff changeset	284 return x.zfill(width)
724 476bb7e5b854 Add function to expand tabs. Guido van Rossum <guido@python.org> parents: 585 diff changeset	285
476bb7e5b854 Add function to expand tabs. Guido van Rossum <guido@python.org> parents: 585 diff changeset	286 # Expand tabs in a string.
476bb7e5b854 Add function to expand tabs. Guido van Rossum <guido@python.org> parents: 585 diff changeset	287 # Doesn't take non-printing chars into account, but does understand \n.
2958 4f9d4e73057c default tabsize to 8 Guido van Rossum <guido@python.org> parents: 2778 diff changeset	288 def expandtabs(s, tabsize=8):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	289 """expandtabs(s [,tabsize]) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	290
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	291 Return a copy of the string s with all tab characters replaced
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	292 by the appropriate number of spaces, depending on the current
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	293 column, and the tabsize (default 8).
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	294
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	295 """
13315 58183679c90a Martin von Löwis <martin@loewis.home.cs.tu-berlin.de>: Fred Drake <fdrake@acm.org> parents: 12248 diff changeset	296 return s.expandtabs(tabsize)
1078 245003c006a6 Misc changes and new modules. whrandom is "objectified". SOCKET.py Guido van Rossum <guido@python.org> parents: 1052 diff changeset	297
3639 70183592370e add translate() -- which was in strop per release 1.3 Guido van Rossum <guido@python.org> parents: 2958 diff changeset	298 # Character translation through look-up table.
3799 2f27501db3c3 Added 3rd optional argument to translate(), a string of characters to delete. Guido van Rossum <guido@python.org> parents: 3669 diff changeset	299 def translate(s, table, deletions=""):
15610 ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	300 """translate(s,table [,deletions]) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	301
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	302 Return a copy of the string s, where all characters occurring
15610 ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	303 in the optional argument deletions are removed, and the
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	304 remaining characters have been mapped through the given
15610 ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	305 translation table, which must be a string of length 256. The
ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	306 deletions argument is not allowed for Unicode strings.
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	307
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	308 """
15610 ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	309 if deletions:
ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	310 return s.translate(table, deletions)
ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	311 else:
ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	312 # Add s[:0] so that if s is Unicode and table is an 8-bit string,
ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	313 # table is converted to Unicode. This means that table cannot
ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	314 # be a dictionary -- for that feature, use u.translate() directly.
ed315b55f19e Make string.translate(s, table) work for Unicode s. Two things are Guido van Rossum <guido@python.org> parents: 14670 diff changeset	315 return s.translate(table + s[:0])
1078 245003c006a6 Misc changes and new modules. whrandom is "objectified". SOCKET.py Guido van Rossum <guido@python.org> parents: 1052 diff changeset	316
3669 1d134ecda094 Added capitalize() and capwords(). Guido van Rossum <guido@python.org> parents: 3639 diff changeset	317 # Capitalize a string, e.g. "aBc dEf" -> "Abc def".
1d134ecda094 Added capitalize() and capwords(). Guido van Rossum <guido@python.org> parents: 3639 diff changeset	318 def capitalize(s):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	319 """capitalize(s) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	320
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	321 Return a copy of the string s with only its first character
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	322 capitalized.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	323
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	324 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	325 return s.capitalize()
3669 1d134ecda094 Added capitalize() and capwords(). Guido van Rossum <guido@python.org> parents: 3639 diff changeset	326
1d134ecda094 Added capitalize() and capwords(). Guido van Rossum <guido@python.org> parents: 3639 diff changeset	327 # Capitalize the words in a string, e.g. " aBc dEf " -> "Abc Def".
1d134ecda094 Added capitalize() and capwords(). Guido van Rossum <guido@python.org> parents: 3639 diff changeset	328 # See also regsub.capwords().
4076 eda29bef880c Add optional separator character to capwords(), for completeness. Guido van Rossum <guido@python.org> parents: 3957 diff changeset	329 def capwords(s, sep=None):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	330 """capwords(s, [sep]) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	331
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	332 Split the argument into words using split, capitalize each
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	333 word using capitalize, and join the capitalized words using
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	334 join. Note that this replaces runs of whitespace characters by
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	335 a single space.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	336
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	337 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	338 return join(map(capitalize, s.split(sep)), sep or ' ')
3669 1d134ecda094 Added capitalize() and capwords(). Guido van Rossum <guido@python.org> parents: 3639 diff changeset	339
3799 2f27501db3c3 Added 3rd optional argument to translate(), a string of characters to delete. Guido van Rossum <guido@python.org> parents: 3669 diff changeset	340 # Construct a translation string
2f27501db3c3 Added 3rd optional argument to translate(), a string of characters to delete. Guido van Rossum <guido@python.org> parents: 3669 diff changeset	341 _idmapL = None
2f27501db3c3 Added 3rd optional argument to translate(), a string of characters to delete. Guido van Rossum <guido@python.org> parents: 3669 diff changeset	342 def maketrans(fromstr, tostr):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	343 """maketrans(frm, to) -> string
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	344
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	345 Return a translation table (a string of 256 bytes long)
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	346 suitable for use in string.translate. The strings frm and to
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	347 must be of the same length.
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	348
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	349 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	350 if len(fromstr) != len(tostr):
11741 da7f5f6a849d Detabify. Fred Drake <fdrake@acm.org> parents: 11707 diff changeset	351 raise ValueError, "maketrans arguments must have same length"
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	352 global _idmapL
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	353 if not _idmapL:
11741 da7f5f6a849d Detabify. Fred Drake <fdrake@acm.org> parents: 11707 diff changeset	354 _idmapL = map(None, _idmap)
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	355 L = _idmapL[:]
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	356 fromstr = map(ord, fromstr)
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	357 for i in range(len(fromstr)):
11741 da7f5f6a849d Detabify. Fred Drake <fdrake@acm.org> parents: 11707 diff changeset	358 L[fromstr[i]] = tostr[i]
16532 7fc64df13db0 String method conversion. Eric S. Raymond <esr@thyrsus.com> parents: 15872 diff changeset	359 return join(L, "")
3669 1d134ecda094 Added capitalize() and capwords(). Guido van Rossum <guido@python.org> parents: 3639 diff changeset	360
5213 5b407e0cbc71 Added new functions replace() and replace1(). Guido van Rossum <guido@python.org> parents: 5188 diff changeset	361 # Substring replacement (global)
11991 81702a7354ec Marc-Andre Lemburg: the maxsplit argument for split() and replace() Guido van Rossum <guido@python.org> parents: 11741 diff changeset	362 def replace(s, old, new, maxsplit=-1):
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	363 """replace (str, old, new[, maxsplit]) -> string
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	364
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	365 Return a copy of string str with all occurrences of substring
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	366 old replaced by new. If the optional argument maxsplit is
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	367 given, only the first maxsplit occurrences are replaced.
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	368
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	369 """
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	370 return s.replace(old, new, maxsplit)
6964 33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	371
33be7d5d498b Added doc string, provided by Charles Waldman (with some reformatting Guido van Rossum <guido@python.org> parents: 6821 diff changeset	372
1078 245003c006a6 Misc changes and new modules. whrandom is "objectified". SOCKET.py Guido van Rossum <guido@python.org> parents: 1052 diff changeset	373 # Try importing optional built-in module "strop" -- if it exists,
245003c006a6 Misc changes and new modules. whrandom is "objectified". SOCKET.py Guido van Rossum <guido@python.org> parents: 1052 diff changeset	374 # it redefines some string operations that are 100-1000 times faster.
1331 07900834cc97 * pdb.py: set 'privileged' property when evaluating expressions Guido van Rossum <guido@python.org> parents: 1291 diff changeset	375 # It also defines values for whitespace, lowercase and uppercase
07900834cc97 * pdb.py: set 'privileged' property when evaluating expressions Guido van Rossum <guido@python.org> parents: 1291 diff changeset	376 # that match <ctype.h>'s definitions.
1078 245003c006a6 Misc changes and new modules. whrandom is "objectified". SOCKET.py Guido van Rossum <guido@python.org> parents: 1052 diff changeset	377
245003c006a6 Misc changes and new modules. whrandom is "objectified". SOCKET.py Guido van Rossum <guido@python.org> parents: 1052 diff changeset	378 try:
11383 aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	379 from strop import maketrans, lowercase, uppercase, whitespace
aca7b5eaf5e8 Mainlining the string_methods branch. See branch revision log Barry Warsaw <barry@python.org> parents: 11379 diff changeset	380 letters = lowercase + uppercase
1746 1940892d2fe3 Merge alpha100 branch back to main trunk Guido van Rossum <guido@python.org> parents: 1403 diff changeset	381 except ImportError:
11741 da7f5f6a849d Detabify. Fred Drake <fdrake@acm.org> parents: 11707 diff changeset	382 pass # Use the original versions

Mercurial > cpython-lru_cache-weakref

annotate Lib/string.py @ 25838:8540887bcec6 2.2