Class: MatchData

Inherits:
Object show all
Defined in:
lib/mug/matchdata/each.rb,
lib/mug/matchdata/hash.rb

Instance Method Summary collapse

Instance Method Details

#each(&b) ⇒ Object

Iterates over each capture group in the MatchData object, including $& (the entire matched string), yielding the captured string.



7
8
9
10
 
# File 'lib/mug/matchdata/each.rb', line 7

def each &b
	return enum_for(:each) unless block_given?
	to_a.each{|v| yield v }
end

#each_capture(&b) ⇒ Object

Iterates over each capture group in the MatchData object, yielding the capture position and captured string.

The capture positions are either all Strings or all Integers, depending on whether the original Regexp had named capture groups or not.



18
19
20
21
22
23
24
25
 
# File 'lib/mug/matchdata/each.rb', line 18

def each_capture &b
	return enum_for(:each_capture) unless block_given?
	if names.empty?
		captures.each_with_index{|v,i| yield i+1, v }
	else
		names.each{|n| yield n, self[n] }
	end
end

#each_named_capture(&b) ⇒ Object

Iterates over each named capture group in the MatchData object, yielding the capture name and string.



29
30
31
32
 
# File 'lib/mug/matchdata/each.rb', line 29

def each_named_capture &b
	return enum_for(:each_named_capture) unless block_given?
	names.each{|n| yield n, self[n] }
end

#each_positional_capture(include_names: false, &b) ⇒ Object

Iterates over each positional capture group in the MatchData object, yielding the capture position and string.

If include_names is given and true, treats named captures as positional captures.

WARNING: if mixing named and positional captures, no positional captures will be available using this method!



42
43
44
45
46
 
# File 'lib/mug/matchdata/each.rb', line 42

def each_positional_capture include_names: false, &b
	return enum_for(:each_positional_capture, include_names: include_names) unless block_given?
	return unless names.empty? || include_names
	captures.each_with_index{|v,i| yield i+1, v }
end

#named_captures ⇒ Object

Returns a Hash object of capture name => captured string.



18
19
20
 
# File 'lib/mug/matchdata/hash.rb', line 18

def named_captures
	Hash[ names.map{|n| [n, self[n]] } ]
end

#positional_captures(include_names: false) ⇒ Object

Returns a Hash object of capture position => captured string.

If include_names is given and true, treats named captures as positional captures.

WARNING: if mixing named and positional captures, no positional captures will be available using this method!



29
30
31
32
 
# File 'lib/mug/matchdata/hash.rb', line 29

def positional_captures include_names: false
	return {} unless names.empty? || include_names
	Hash[ captures.each_with_index.map{|v,i| [i+1, v] } ]
end

#to_h ⇒ Object

Returns a Hash object of capture position => captured string.

The capture positions are either all Strings or all Integers, depending on whether the original Regexp had named capture groups or not.



9
10
11
12
13
14
15
 
# File 'lib/mug/matchdata/hash.rb', line 9

def to_h
	if names.empty?
		Hash[ captures.each_with_index.map{|v,i| [i+1, v] } ]
	else
		Hash[ names.map{|n| [n, self[n]] } ]
	end
end