summaryrefslogtreecommitdiffstats
path: root/Doc/library/re.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/library/re.rst')
-rw-r--r--Doc/library/re.rst28
1 files changed, 17 insertions, 11 deletions
diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index 17da18e..88912eb 100644
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -1078,16 +1078,21 @@ method is invaluable for converting textual data into data structures that can b
easily read and modified by Python as demonstrated in the following example that
creates a phonebook.
-First, get the input using triple-quoted string syntax::
+First, here is the input. Normally it may come from a file, here we are using
+triple-quoted string syntax::
- >>> input = """Ross McFluff 834.345.1254 155 Elm Street
- Ronald Heathmore 892.345.3428 436 Finley Avenue
- Frank Burger 925.541.7625 662 South Dogwood Way
- Heather Albrecht 548.326.4584 919 Park Place"""
+ >>> input = """Ross McFluff: 834.345.1254 155 Elm Street
-Then, convert the string into a list with each line having its own entry::
+ Ronald Heathmore: 892.345.3428 436 Finley Avenue
+ Frank Burger: 925.541.7625 662 South Dogwood Way
- >>> entries = re.split("\n", input)
+
+ Heather Albrecht: 548.326.4584 919 Park Place"""
+
+The entries are separated by one or more newlines. Now we convert the string
+into a list with each nonempty line having its own entry::
+
+ >>> entries = re.split("\n+", input)
>>> entries
['Ross McFluff 834.345.1254 155 Elm Street',
'Ronald Heathmore 892.345.3428 436 Finley Avenue',
@@ -1098,16 +1103,17 @@ Finally, split each entry into a list with first name, last name, telephone
number, and address. We use the ``maxsplit`` paramater of :func:`split`
because the address has spaces, our splitting pattern, in it::
- >>> [re.split(" ", entry, 3) for entry in entries]
+ >>> [re.split(":? ", entry, 3) for entry in entries]
[['Ross', 'McFluff', '834.345.1254', '155 Elm Street'],
['Ronald', 'Heathmore', '892.345.3428', '436 Finley Avenue'],
['Frank', 'Burger', '925.541.7625', '662 South Dogwood Way'],
['Heather', 'Albrecht', '548.326.4584', '919 Park Place']]
-With a ``maxsplit`` of ``4``, we could seperate the house number from the street
-name::
+The ``:?`` pattern matches the colon after the last name, so that it does not
+occur in the result list. With a ``maxsplit`` of ``4``, we could seperate the
+house number from the street name::
- >>> [re.split(" ", entry, 4) for entry in entries]
+ >>> [re.split(":? ", entry, 4) for entry in entries]
[['Ross', 'McFluff', '834.345.1254', '155', 'Elm Street'],
['Ronald', 'Heathmore', '892.345.3428', '436', 'Finley Avenue'],
['Frank', 'Burger', '925.541.7625', '662', 'South Dogwood Way'],