SequenceCases

SequenceCases[list,patt]

gives a list of the sublists in list that match the sequence pattern patt.

SequenceCases[list,pattrhs]

gives a list of the values of rhs corresponding to sublists that match patt.

SequenceCases[list,patt,n]

includes only the first n matches.

Details and Options

  • In SequenceCases[list,patt], patt can be an expression with head List that includes pattern constructs such as PatternSequence, Repeated (..), Blank (_), and BlankSequence (__).
  • The pattern patt can also be a pattern that matches a list but does not itself have head List.
  • With the default option setting OverlapsFalse, SequenceCases includes only sublists that do not overlap. With the setting OverlapsTrue, it includes sublists that overlap.
  • With Overlaps->All, multiple sublists that match the same pattern are all included. With Overlaps->True, only the first such matching sublist at a given position is included.

Examples

open allclose all

Basic Examples  (2)

Find sublists that match a pattern:

Perform a replacement on each match:

Count the length of all contiguous sequences of b:

Scope  (3)

Find sequences of elements that match a pattern:

Find all overlapping sequences in a list:

Evaluate a function on the cases found:

Options  (2)

Overlaps  (2)

Allow overlaps:

Allow no overlaps:

Allow overlaps starting at different positions:

Allow no overlaps:

Allow all overlaps:

Properties & Relations  (3)

Find the position of a sequence:

Find the actual sequence:

Count the number of cases:

Replace the sequence by an expression:

For lists of characters, SequenceCases is similar to StringCases:

SubsetCases matches the elements of the sequence in any order:

SequenceCases matches the sequence only in the specified order:

Wolfram Research (2015), SequenceCases, Wolfram Language function, https://reference.wolfram.com/language/ref/SequenceCases.html.

Text

Wolfram Research (2015), SequenceCases, Wolfram Language function, https://reference.wolfram.com/language/ref/SequenceCases.html.

CMS

Wolfram Language. 2015. "SequenceCases." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/SequenceCases.html.

APA

Wolfram Language. (2015). SequenceCases. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/SequenceCases.html

BibTeX

@misc{reference.wolfram_2023_sequencecases, author="Wolfram Research", title="{SequenceCases}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/SequenceCases.html}", note=[Accessed: 19-March-2024 ]}

BibLaTeX

@online{reference.wolfram_2023_sequencecases, organization={Wolfram Research}, title={SequenceCases}, year={2015}, url={https://reference.wolfram.com/language/ref/SequenceCases.html}, note=[Accessed: 19-March-2024 ]}