File: bytebegin.rdoc

package info (click to toggle)
ruby3.4 3.4.5-1~exp1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 154,784 kB
  • sloc: ruby: 1,259,653; ansic: 829,955; yacc: 28,233; pascal: 7,359; sh: 3,864; python: 1,799; cpp: 1,158; asm: 808; makefile: 801; javascript: 414; lisp: 109; perl: 62; awk: 36; sed: 4; xml: 4
file content (30 lines) | stat: -rw-r--r-- 921 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
Returns the offset (in bytes) of the beginning of the specified match.

When non-negative integer argument +n+ is given,
returns the offset of the beginning of the <tt>n</tt>th match:

  m = /(.)(.)(\d+)(\d)/.match("THX1138.")
  # => #<MatchData "HX1138" 1:"H" 2:"X" 3:"113" 4:"8">
  m[0]       # => "HX1138"
  m.bytebegin(0) # => 1
  m[3]       # => "113"
  m.bytebegin(3) # => 3

  m = /(т)(е)(с)/.match('тест')
  # => #<MatchData "тес" 1:"т" 2:"е" 3:"с">
  m[0]       # => "тес"
  m.bytebegin(0) # => 0
  m[3]       # => "с"
  m.bytebegin(3) # => 4

When string or symbol argument +name+ is given,
returns the offset of the beginning for the named match:

  m = /(?<foo>.)(.)(?<bar>.)/.match("hoge")
  # => #<MatchData "hog" foo:"h" bar:"g">
  m[:foo]        # => "h"
  m.bytebegin('foo') # => 0
  m[:bar]        # => "g"
  m.bytebegin(:bar)  # => 2

Related: MatchData#byteend, MatchData#byteoffset.