>
> This change looks wrong:
>
> PyDoc_STRVAR(rpartition__doc__,
> -"S.rpartition(sep) -> (head, sep, tail)\n\
> +"S.rpartition(sep) -> (tail, sep, head)\n\
>
> It looks like the code itself does the right thing, but I wasn't quite
> confident of that.
>
It is correct. There may be some confusion in terminology. Head and
tail do not mean left-side or right-side. Instead, they refer to the
"small part chopped-off" and "the rest that is still choppable". Think
of head and tail in the sense of car and cdr.
A post-condition invariant for both str.partition() and str.rpartition() is:
assert sep not in head
For non-looping cases, users will likely to use different variable names
when they unpack the tuple:
left, middle, right = s.rpartition(p)
But when they perform multiple partitions, the "tail" or "rest"
terminology is more appropriate for the part of the string that may
still contain separators.
Raymond
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4