Click here to return to the list of pages
The following methods all work on string values
These methods allow you to test a string for certain properties; they are
typically used in conditional expressions (e.g., for if
statements).
Description: The method count
returns the number of times that the
substring
appears in the string a_string
.
Syntax:
a_string.count(substring)
Parameters:
- substring (str
): The string to count the number of occurrences of.
Returns: int
Examples:
> "Harry Potter".count("r")
3
> "Alpha Beta".count("r")
0
> "Hermione Granger".count("P")
0
> new_string = "Hello world"
> new_string.count("l")
3
Full Documentation :count
Description: The method endswith
returns whether the given string
a_string
ends with the suffix
string.
Syntax:
a_string.endswith(suffix)
Parameters:
- suffix (str
): The string that could be at the end of the other string.
Returns: bool
Examples:
> "Harry Potter".endswith("Potter")
True
> "Hermione Granger".endswith("Potter")
False
> "Treehouse".endswith("House")
False
Full Documentation :endswith
Description: The method startswith
returns whether the given string
a_string
begins with the prefix
string.
Syntax:
a_string.startswith(prefix)
Parameters:
- prefix (str
): The string that could be at the beginning of the other
string.
Returns: bool
Examples:
> "Harry Potter".startswith("Harry")
True
> "Hermione Granger".startswith("Harry")
False
> "Treehouse".startswith("tree")
False
Full Documentation :startswith
Description: The method isdigit
returns whether the given string
isdigit
only has numerals in it (0, 1, 2, etc.).
Syntax:
a_string.isdigit()
Parameters: None
Returns: bool
Examples:
> "1234".isdigit()
True
> "Harry Potter".isdigit()
False
> "12pm".isdigit()
False
Full Documentation :isdigit
These methods are for changing capitalization in strings.
Description: The method title
returns a new version of the string
a_string
with the first letter of each word capitalized (as you would see in
the title of a book).
Syntax:
a_string.title()
Parameters: None
Returns: str
Examples:
> "This is a full sentence.".title()
'This Is A Full Sentence.'
> "hermione granger".title()
'Hermione Granger'
> "WHY AM I SHOUTING".title()
'Why Am I Shouting'
Full Documentation :title
Description: The method capitalize
returns a new version of the string
a_string
with only the first letter capitalized. Note that this does not
respect periods; only the first letter is capitalized!
Syntax:
a_string.capitalize()
Parameters: None
Returns: str
Examples:
> "This Is A Title Sentence.".capitalize()
'This is a title sentence.'
> "hermione granger".capitalize()
'Hermione granger'
> "WHY AM I SHOUTING".capitalize()
'Why am i shouting'
> "First sentence. Second sentence.".capitalize()
'First sentence. second sentence'
Full Documentation :capitalize
Description: The method upper
returns a new version of the string
a_string
with all of the characters capitalized (uppercase).
Syntax:
a_string.upper()
Parameters: None
Returns: str
Examples:
> "This Is A Title Sentence.".upper()
'THIS IS A TITLE SENTENCE'
> "hermione granger".upper()
'HERMIONE GRANGER'
> "why am i shouting".upper()
'WHY AM I SHOUTING'
Full Documentation :upper
Description: The method lower
returns a new version of the string
a_string
with all of the characters lowercase.
Syntax:
a_string.lower()
Parameters: None
Returns: str
Examples:
> "This Is A Title Sentence.".lower()
'this is a title sentence'
> "Hermione Granger".lower()
'hermione granger'
> "WHY AM I SHOUTING".lower()
'why am i shouting'
Full Documentation :lower
These methods are for splitting strings into lists or joining sequences (e.g., lists) into strings.
Description: The method split
returns a new list by breaking the string
a_string
into elements based on the separator
.
Syntax:
a_string.split(separator)
Parameters:
- separator (str
): The string that will be used to find splits. If left
out, this method will instead split on whitespace.
Returns: list
of str
Examples:
> "Harry Potter, Hermione Granger, Ron Weasley".split(',')
['Harry Potter', ' Hermione Granger', ' Ron Weasley']
> "and/or".split("/")
['and', 'or']
> "There will be no splits.".split("-")
['There will be no splits.']
> "".split("Empty string")
['']
> "Leaving out the argument will split on all whitespace!".split()
['Leaving', 'out', 'the', 'argument', 'will', 'split', 'on', 'all', 'whitespace!']
Full Documentation :split
Description: The method join
returns a new string by combining the
elements of a_sequence
using a_string
.
Syntax:
a_string.join(a_sequence)
Parameters:
- a_sequence (list
of str
or other sequence of str
): The sequence of
strings that will be joined together. You must make sure these are strings!
Returns: str
Examples:
> ','.join(['Harry Potter', 'Hermione Granger', 'Ron Weasley'])
'Harry Potter,Hermione Granger,Ron Weasley'
> "/".join(["and", "or"])
'and/or'
> "Nothing to join together".join([])
''
> "".join(["No", "Spaces", "Or", "Anything"])
''NoSpacesOrAnything'
Full Documentation :join
These methods are used to look through a string and find positional information.
Description: The method find
returns the numerical index of the first
appearance of substring
in a_string
. Remember, counting starts at 0. If
the substring is not in the string, then -1
is returned.
Syntax:
a_string.find(substring)
Parameters:
- substring (str
): The string to find in a_string
.
Returns: int
Examples:
> "Harry Potter".find('r')
2
> "Capitalization is Important".find('I')
18
> "Harry Potter".find('g')
-1
> "".find('e')
-1
> "You can check for more than one character!".find("can")
4
Full Documentation :find
These methods remove whitespace from strings (spaces, tabs, new lines, etc.).
Description: The method strip
returns a new string with any whitespace
(e.g., spaces or tabs) removed from both sides.
Syntax:
a_string.strip()
Parameters: None
Returns: str
Examples:
> " Garbage whitespace ".strip()
'Garbage whitespace'
> "Works on either side ".strip()
'Works on either side'
> "Common task is to remove newlines\n\n".strip()
'Common task is to remove newlines'
Full Documentation :strip
Description: The method lstrip
returns a new string with any whitespace
(e.g., spaces or tabs) removed from only the LEFT side.
Syntax:
a_string.lstrip()
Parameters: None
Returns: str
Examples:
> " Garbage whitespace".lstrip()
'Garbage whitespace'
> "Works on one side only ".lstrip()
'Works on one side only '
Full Documentation :lstrip
Description: The method rstrip
returns a new string with any whitespace
(e.g., spaces or tabs) removed from only the RIGHT side.
Syntax:
a_string.rstrip()
Parameters: None
Returns: str
Examples:
> "Garbage whitespace ".rstrip()
'Garbage whitespace'
> " Works on one side only".rstrip()
' Works on one side only'
Full Documentation :rstrip
This method is used to conveniently edit strings.
Description: The method replace
returns a new string based on
a_string
, but with any occurrence of old
replaced by new
.
Syntax:
a_string.replace(old, new)
Parameters:
- old (str
): The original text to find in the string.
- new (str
): The new text to change the old
text into.
Returns: str
Examples:
> "Can you open the door?".replace("open", "close")
'Can you close the door?'
> "Multipl? occurr?nc?s".replace("?", "e")
'Multiple occurrences'
> "Useful for e-r-a-s-i-n-g too!".replace("-", "")
'Useful for erasing too!'
Full Documentation :replace
Description: The method format
returns a new string based on
a_string
, but with the parameters added in to replace any {}
with any
number of parameters given in args
.
Syntax:
a_string.format(*args)
Parameters:
- args (Any type): 0 or more values that will be injected into a_string
,
replacing any occurrences of {}
in order.
Returns: str
Examples:
> "The sum of 1+1 is {}".format(2)
'The sum of 1+1 is 2'
> "{} arguments can be {}".format("Multiple", "passed")
'Multiple arguments can be passed'
Full Documentation :format