mirror of
https://github.com/ruby/ruby.git
synced 2025-08-24 13:34:17 +02:00
41e24c2f3e
(https://github.com/ruby/strscan/pull/126)
Split off from https://github.com/ruby/ruby/pull/12322
9bee37e0f5
43 lines
1 KiB
Markdown
43 lines
1 KiB
Markdown
call-seq:
|
|
skip(pattern) match_size or nil
|
|
|
|
Attempts to [match][17] the given `pattern`
|
|
at the beginning of the [target substring][3];
|
|
|
|
If the match succeeds:
|
|
|
|
- Increments the [byte position][2] by substring.bytesize,
|
|
and may increment the [character position][7].
|
|
- Sets [match values][9].
|
|
- Returns the size (bytes) of the matched substring.
|
|
|
|
```rb
|
|
scanner = StringScanner.new(HIRAGANA_TEXT)
|
|
scanner.string # => "こんにちは"
|
|
scanner.pos = 6
|
|
scanner.skip(/に/) # => 3
|
|
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: 9
|
|
# charpos: 3
|
|
# rest: "ちは"
|
|
# rest_size: 6
|
|
|
|
scanner.skip(/nope/) # => nil
|
|
match_values_cleared?(scanner) # => true
|
|
```
|