mirror of
https://github.com/ruby/ruby.git
synced 2025-08-24 05:25:34 +02:00
41e24c2f3e
(https://github.com/ruby/strscan/pull/126)
Split off from https://github.com/ruby/ruby/pull/12322
9bee37e0f5
49 lines
1.1 KiB
Markdown
49 lines
1.1 KiB
Markdown
call-seq:
|
|
skip_until(pattern) -> matched_substring_size or nil
|
|
|
|
Attempts to [match][17] the given `pattern`
|
|
anywhere (at any [position][2]) in the [target substring][3];
|
|
does not modify the positions.
|
|
|
|
If the match attempt succeeds:
|
|
|
|
- Sets [match values][9].
|
|
- Returns the size of the matched substring.
|
|
|
|
```rb
|
|
scanner = StringScanner.new(HIRAGANA_TEXT)
|
|
scanner.string # => "こんにちは"
|
|
scanner.pos = 6
|
|
scanner.skip_until(/ち/) # => 6
|
|
put_match_values(scanner)
|
|
# Basic match values:
|
|
# matched?: true
|
|
# matched_size: 3
|
|
# pre_match: "こんに"
|
|
# matched : "ち"
|
|
# post_match: "は"
|
|
# Captured match values:
|
|
# size: 1
|
|
# captures: []
|
|
# named_captures: {}
|
|
# values_at: ["ち", nil]
|
|
# []:
|
|
# [0]: "ち"
|
|
# [1]: nil
|
|
put_situation(scanner)
|
|
# Situation:
|
|
# pos: 12
|
|
# charpos: 4
|
|
# rest: "は"
|
|
# rest_size: 3
|
|
```
|
|
|
|
If the match attempt fails:
|
|
|
|
- Clears match values.
|
|
- Returns `nil`.
|
|
|
|
```rb
|
|
scanner.skip_until(/nope/) # => nil
|
|
match_values_cleared?(scanner) # => true
|
|
```
|