Class: Array

Inherits:
Object show all
Defined in:
lib/mug/top.rb,
lib/mug/bool.rb,
lib/mug/array/minus.rb,
lib/mug/array/extend.rb

Instance Method Summary collapse

Instance Method Details

#bottom!(n = 1, &blk) ⇒ Object 



104
105
106
 
# File 'lib/mug/top.rb', line 104

def bottom! n=1, &blk
	replace(bottom n, &blk)
end

#bottom_by!(n = 1, &blk) ⇒ Object 



107
108
109
110
 
# File 'lib/mug/top.rb', line 107

def bottom_by! n=1, &blk
	return enum_for(:bottom_by!, n) unless block_given?
	replace(bottom_by n, &blk)
end

#extend(*args, &block) ⇒ Object

See Also:



48
49
50
 
# File 'lib/mug/array/extend.rb', line 48

def extend *args, &block
	dup.extend!( *args, &block )
end

#extend!(size, *rest) ⇒ Object

Extend this Array.

In the first form, when a size and an optional obj are sent, the array is extended with size copies of obj. Take notice that all elements will reference the same object obj.

The second form appends a copy of the array passed as a parameter (the array is generated by calling #to_ary on the parameter). In the last form, the array is extended by the given size. Each new element in the array is created by passing the element’s index to the given block and storing the return value.

@call-seq extend!(size=0, obj=nil) @call-seq extend!(array) @call-seq extend!(size) {|index| block }

Raises:

  • (ArgumentError)

See Also:

  • #concat
  • #+


24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
 
# File 'lib/mug/array/extend.rb', line 24

def extend! size, *rest
	raise ArgumentError, "wrong number of arguments (#{rest.length+1} for 1..2)" if rest.length > 1

	# Same logic as array.c/rb_ary_initialize
	if rest.empty? && !size.is_a?(Fixnum)
		warn 'warning: given block not used' if block_given?
		concat size.to_ary
		return self
	end

	raise ArgumentError, 'negative size' if size < 0

	a = length
	b = a+size
	if block_given?
		warn 'warning: block supersedes default value argument' if !rest.empty?
		fill(a...b) {|i| yield i }
	else
		obj = rest[0]
		fill(a...b) { obj }
	end
end

#minus(ary, remainder: false) ⇒ Object

Subtract elements from this array.

This is similar to Array#- except that elements from this array are removed only once per instance in ary.

If remainder is given and true, returns a second array which is all elements in ary that were not present in this array.

@call-seq minus(ary) @call-seq minus(ary, remainder: true)



16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/mug/array/minus.rb', line 16

def minus ary, remainder: false

	result = dup
	rem = []

	ary.each do |x|
		i = result.index x
		if i
			result.delete_at i
		elsif remainder
			rem << x
		end
	end

	if remainder
		[result, rem]
	else
		result
	end
end

#to_b ⇒ Object

Converts ary to a boolean. Returns true if not empty.



66
67
68
 
# File 'lib/mug/bool.rb', line 66

def to_b
	!empty?
end

#top!(n = 1, &blk) ⇒ Object 



97
98
99
 
# File 'lib/mug/top.rb', line 97

def top! n=1, &blk
	replace(top n, &blk)
end

#top_by!(n = 1, &blk) ⇒ Object 



100
101
102
103
 
# File 'lib/mug/top.rb', line 100

def top_by! n=1, &blk
	return enum_for(:top_by!, n) unless block_given?
	replace(top_by n, &blk)
end