diff options
| author | Leonard Richardson <leonardr@segfault.org> | 2021-06-01 19:58:18 -0400 |
|---|---|---|
| committer | Leonard Richardson <leonardr@segfault.org> | 2021-06-01 19:58:18 -0400 |
| commit | 70f546b1e689a70e2f103795efce6d261a3dadf7 (patch) | |
| tree | e803f70d1e1e5625c8f31e5495201f0be462cb3d /doc/source/index.rst | |
| parent | a00624d7fc2e29b41b286f46844cb75f4d96ff63 (diff) | |
The 'replace_with()' method now takes a variable number of arguments,
and can be used to replace a single element with a sequence of elements.
Patch by Bill Chandos.
Diffstat (limited to 'doc/source/index.rst')
| -rw-r--r-- | doc/source/index.rst | 25 |
1 files changed, 19 insertions, 6 deletions
diff --git a/doc/source/index.rst b/doc/source/index.rst index 88b8475..01cb6df 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -2097,22 +2097,35 @@ whether something has been decomposed, you can check its ------------------ ``PageElement.replace_with()`` removes a tag or string from the tree, -and replaces it with the tag or string of your choice:: +and replaces it with one or more tags or strings of your choice:: markup = '<a href="http://example.com/">I linked to <i>example.com</i></a>' soup = BeautifulSoup(markup, 'html.parser') a_tag = soup.a new_tag = soup.new_tag("b") - new_tag.string = "example.net" + new_tag.string = "example.com" a_tag.i.replace_with(new_tag) a_tag - # <a href="http://example.com/">I linked to <b>example.net</b></a> + # <a href="http://example.com/">I linked to <b>example.com</b></a> -``replace_with()`` returns the tag or string that was replaced, so + bold_tag = soup.new_tag("b") + bold_tag.string = "example" + i_tag = soup.new_tag("i") + i_tag.string = "net" + a_tag.b.replace_with(bold_tag, ".", i_tag) + + a_tag + # <a href="http://example.com/">I linked to <b>example</b>.<i>net</i></a> + +``replace_with()`` returns the tag or string that got replaced, so that you can examine it or add it back to another part of the tree. +`The ability to pass multiple arguments into replace_with() is new +in Beautiful Soup 4.10.0.` + + ``wrap()`` ---------- @@ -2126,7 +2139,7 @@ returns the new wrapper:: soup.p.wrap(soup.new_tag("div")) # <div><p><b>I wish I was bold.</b></p></div> -This method is new in Beautiful Soup 4.0.5. +`This method is new in Beautiful Soup 4.0.5.` ``unwrap()`` --------------------------- @@ -2177,7 +2190,7 @@ You can call ``Tag.smooth()`` to clean up the parse tree by consolidating adjace # A one, a two # </p> -The ``smooth()`` method is new in Beautiful Soup 4.8.0. +`This method is new in Beautiful Soup 4.8.0.` Output ====== |