Module: CommonLib::Array

Defined in:
lib/common_lib/ruby/array.rb

Overview

:nodoc:

Instance Method Summary collapse

Instance Method Details

#arrange(new_array_index = []) ⇒ Object

‘a’,‘b’,‘c’].arrange() => [’c’,‘a’,‘b’


4
5
6
7
8
9
10
 
# File 'lib/common_lib/ruby/array.rb', line 4

def arrange(new_array_index=[])
  new_array = self.dup
  new_array_index.each_with_index do |index,new_index|
    new_array[new_index] = self[index]
  end
  new_array
end

#average ⇒ Object

Return the average digitized value of the array



36
37
38
39
40
41
42
43
 
# File 'lib/common_lib/ruby/array.rb', line 36

def average
  if self.length > 0
    # sum defined in activesupport/lib/active_support/core_ext/enumerable.rb
    self.digitize.sum.to_f / self.length
  else
    nil
  end
end

#capitalize ⇒ Object

Return capitlized versions of each item in the array



18
19
20
 
# File 'lib/common_lib/ruby/array.rb', line 18

def capitalize
  collect(&:capitalize)
end

#capitalize! ⇒ Object

Capitalize each item in the array and return it



23
24
25
26
27
28
 
# File 'lib/common_lib/ruby/array.rb', line 23

def capitalize!
  each_with_index do |element,index|
    self[index] = element.capitalize
  end
  self
end

#downcase ⇒ Object

Return downcased versions of each item in the array



31
32
33
 
# File 'lib/common_lib/ruby/array.rb', line 31

def downcase
  collect(&:downcase)
end

#drop_blanks! ⇒ Object

Remove all “blank?” items for the array



13
14
15
 
# File 'lib/common_lib/ruby/array.rb', line 13

def drop_blanks!
  delete_if{|a|a.blank?}
end

#false? ⇒ Boolean

Returns:

  • (Boolean) 


111
112
113
 
# File 'lib/common_lib/ruby/array.rb', line 111

def false?
  !empty? && any?{|v| v.false? }
end

#first_index(value = nil, &block) ⇒ Object

return the first index of the array with a value matching that given



85
86
87
88
89
90
91
 
# File 'lib/common_lib/ruby/array.rb', line 85

def first_index(value = nil, &block)
  using_block = block_given?
  each_with_index do |element,index|
    return index if (using_block && yield(element)) || (value == element)
  end
  return nil
end

#median ⇒ Object

Return the median digitized value of the array



46
47
48
49
50
51
52
53
54
55
56
57
58
 
# File 'lib/common_lib/ruby/array.rb', line 46

def median
  if self.length > 0
    sorted_values = self.digitize.sort
    length = sorted_values.length
    if length.odd?
      sorted_values[length/2]
    else
      ( sorted_values[length/2] + sorted_values[-1+length/2] ).to_f / 2
    end
  else
    nil
  end
end

#numericize ⇒ Object Also known as: digitize

Convert all items in the array to_f



76
77
78
 
# File 'lib/common_lib/ruby/array.rb', line 76

def numericize
  collect(&:to_f)
end

#swap_indexes(i, j) ⇒ Object

Return a copy of the array with values at the given indexes swapped.



62
63
64
65
66
 
# File 'lib/common_lib/ruby/array.rb', line 62

def swap_indexes(i,j)
  new_array = self.dup
  new_array[i],new_array[j] = self[j],self[i]
  new_array
end

#swap_indexes!(i, j) ⇒ Object

Swap the values of an array at the given indexes and return it



70
71
72
73
 
# File 'lib/common_lib/ruby/array.rb', line 70

def swap_indexes!(i,j)
  self[i],self[j] = self[j],self[i]
  self
end

#to_boolean ⇒ Object Also known as: to_b 



93
94
95
 
# File 'lib/common_lib/ruby/array.rb', line 93

def to_boolean
  !empty? && all?{|v| v.to_boolean }
end

#true? ⇒ Boolean

[].true?

> false

[true].true?

> true

[true,false].true?

> true

[false].true?

> false

Returns:

  • (Boolean) 


107
108
109
 
# File 'lib/common_lib/ruby/array.rb', line 107

def true?
  !empty? && any?{|v| v.true? }
end

#true_xor_false? ⇒ Boolean

I need to work on this one …

Returns:

  • (Boolean) 


116
117
118
119
120
121
122
123
124
125
 
# File 'lib/common_lib/ruby/array.rb', line 116

def true_xor_false?
#   self.include?('true') ^ self.include?('false') ^
#     self.include?(true) ^ self.include?(false)
  contains_true = contains_false = false
  each {|v|
#     ( v.to_boolean ) ? contains_true = true : contains_false = true
    eval("contains_#{v.to_boolean}=true")
  }
  contains_true ^ contains_false
end