splitn documentation is not clear

[durka]

An iterator over substrings of the given string slice, separated by a pattern, restricted to returning at most count items.

The last element returned, if any, will contain the remainder of the string slice.

Is the last element yielded by the iterator the remainder after the N items, or is the remainder included in N? The answer is the latter, but I don't think it's clear. Or am I the problem here?

[frewsxcv]

restricted to returning at most count items

This is supposed to indicate to the user how many items are returned by the iterator. Were you thinking splitn might returncount + 1 items?

[durka]

That was my confusion. The examples make it clear though.

[frewsxcv]

PR opened that attempts to address this: #36930

[frewsxcv]

I'm going to consider the changes in #36930 as resolving this. If someone feels otherwise, let me know and I'll reopen.