Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Enhance the -split operator with negative maximum token counts to split from the end #4765

Copy link
Copy link
@mklement0

Description

@mklement0
Issue body actions

As approved in #4721 (comment), and later amended in #5125 (comment):

After the enhancement, only a <Max-substrings> value of 0 will be accepted as the explicit signal that all tokens should be returned, however many are found in the input string(s).

Negative <Max-substrings> values will work analogously to the already supported positive values, except that:

  • they return the specified number of strings from the end of the string(s).

  • all individually extracted tokens are returned in input order, and whatever unsplit part remains, if any, is returned as the first token.

Examples:

PS> 'a b c d' -split ' ', -2  # split into (at most) 2 strings from the end
a b c  # prefix
d        # requested token

PS> 'a b c d' -split ' ', -3  # split into (at most) 3 strings from the end
a b   # prefix
c       
d 

PS> 'a b' -split ' ', -2  # 2 resulting strings - complete split; same as 0 in this case
a
b

Note that both -split ' ', 1 and -split ' ', -1 are no-ops: they request no splitting at all, and the sign of the <Max-substrings> argument is therefore irrelevant.

Reporting the prefix (unsplit part) first enables the following idiom:

PS> $prefix, $tokens = 'a b c d' -split ' ', -3 # -> $prefix = 'a b', $tokens = 'c', 'd'

Environment data

PowerShell Core v6.0.0-beta.8
Reactions are currently unavailable

Metadata

Metadata

Assignees

No one assigned

    Labels

    Breaking-Changebreaking change that may affect usersbreaking change that may affect usersCommittee-ReviewedPS-Committee has reviewed this and made a decisionPS-Committee has reviewed this and made a decisionHacktoberfestPotential candidate to participate in HacktoberfestPotential candidate to participate in HacktoberfestIssue-Enhancementthe issue is more of a feature request than a bugthe issue is more of a feature request than a bugResolution-FixedThe issue is fixed.The issue is fixed.Up-for-GrabsUp-for-grabs issues are not high priorities, and may be opportunities for external contributorsUp-for-grabs issues are not high priorities, and may be opportunities for external contributorsWG-Languageparser, language semanticsparser, language semantics

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      Morty Proxy This is a proxified and sanitized view of the page, visit original site.