Module: ArelExtensions::StringFunctions

Included in:
Arel::Nodes::Equality, Arel::Nodes::Function, Arel::Nodes::Grouping, Attributes, Nodes::Case
Defined in:
lib/arel_extensions/string_functions.rb

Instance Method Summary collapse

Instance Method Details

#&(other) ⇒ Object

*FindInSet function .……



23
24
25
26
27
28
 
# File 'lib/arel_extensions/string_functions.rb', line 23

def &(other)
  ArelExtensions::Nodes::FindInSet.new [
    Arel.quoted(other.is_a?(Integer) ? other.to_s : other),
    self,
  ]
end

#[](start, end_ = nil) ⇒ Object

Note:

‘ind` should be an [Integer|NilClass] if `start` is an [Integer]. It’s ignored in all other cases.

Return a [ArelExtensions::Nodes::Substring] if ‘start` is a [Range] or an [Integer].

Return the result to ‘self.send(start)` if it’s a [String|Symbol]. The assumption is that you’re trying to reach an [Arel::Table]‘s [Arel::Attribute].



62
63
64
65
66
67
68
69
70
71
72
73
74
75
 
# File 'lib/arel_extensions/string_functions.rb', line 62

def [](start, end_ = nil)
  if start.is_a?(String) || start.is_a?(Symbol)
    self.send(start)
  elsif start.is_a?(Range)
    ArelExtensions::Nodes::Substring.new [self, start.begin + 1, start.end - start.begin + 1]
  elsif start.is_a?(Integer) && !end_
    ArelExtensions::Nodes::Substring.new [self, start + 1, 1]
  elsif start.is_a?(Integer)
    start += 1
    ArelExtensions::Nodes::Substring.new [self, start, end_ - start + 1]
  else
    raise ArgumentError, 'unrecognized argument types; can accept integers, ranges, or strings.'
  end
end

#ai_collate ⇒ Object 



131
132
133
 
# File 'lib/arel_extensions/string_functions.rb', line 131

def ai_collate
  ArelExtensions::Nodes::Collate.new(self, nil, true, false)
end

#ai_imatches(other) ⇒ Object

accent insensitive & case insensitive



123
124
125
 
# File 'lib/arel_extensions/string_functions.rb', line 123

def ai_imatches other # accent insensitive & case insensitive
  ArelExtensions::Nodes::AiIMatches.new(self, other)
end

#ai_matches(other) ⇒ Object

accent insensitive & case sensitive



119
120
121
 
# File 'lib/arel_extensions/string_functions.rb', line 119

def ai_matches other # accent insensitive & case sensitive
  ArelExtensions::Nodes::AiMatches.new(self, other)
end

#blank ⇒ Object 



196
197
198
 
# File 'lib/arel_extensions/string_functions.rb', line 196

def blank
  ArelExtensions::Nodes::Blank.new [self]
end

#byte_length ⇒ Object 



35
36
37
 
# File 'lib/arel_extensions/string_functions.rb', line 35

def byte_length
  ArelExtensions::Nodes::Length.new self, true
end

#char_length ⇒ Object 



39
40
41
 
# File 'lib/arel_extensions/string_functions.rb', line 39

def char_length
  ArelExtensions::Nodes::Length.new self, false
end

#ci_collate ⇒ Object 



135
136
137
 
# File 'lib/arel_extensions/string_functions.rb', line 135

def ci_collate
  ArelExtensions::Nodes::Collate.new(self, nil, false, true)
end

#collate(ai = false, ci = false, option = nil) ⇒ Object 



139
140
141
 
# File 'lib/arel_extensions/string_functions.rb', line 139

def collate ai = false, ci = false, option = nil
  ArelExtensions::Nodes::Collate.new(self, option, ai, ci)
end

#concat(other) ⇒ Object 



156
157
158
 
# File 'lib/arel_extensions/string_functions.rb', line 156

def concat other
  ArelExtensions::Nodes::Concat.new [self, other]
end

#downcase ⇒ Object 



188
189
190
 
# File 'lib/arel_extensions/string_functions.rb', line 188

def downcase
  ArelExtensions::Nodes::Downcase.new [self]
end

#edit_distance(other) ⇒ Object 



213
214
215
 
# File 'lib/arel_extensions/string_functions.rb', line 213

def edit_distance other
  ArelExtensions::Nodes::LevenshteinDistance.new [self, other]
end

#group_concat(sep = nil, *orders, group: nil, order: nil) ⇒ Object

concat elements of a group, separated by sep and ordered by a list of Ascending or Descending



161
162
163
164
165
166
167
168
169
170
171
172
173
 
# File 'lib/arel_extensions/string_functions.rb', line 161

def group_concat(sep = nil, *orders, group: nil, order: nil)
  if orders.present?
    deprecated 'Use the kwarg `order` instead.', what: 'orders'
  end
  order_tabs = [orders].flatten.map{ |o|
    if o.is_a?(Arel::Nodes::Ascending) || o.is_a?(Arel::Nodes::Descending)
      o
    elsif o.respond_to?(:asc)
      o.asc
    end
  }.compact
  ArelExtensions::Nodes::GroupConcat.new(self, sep, group: group, order: (order || order_tabs))
end

#idoes_not_match(others, escape = nil) ⇒ Object 



107
108
109
 
# File 'lib/arel_extensions/string_functions.rb', line 107

def idoes_not_match others, escape = nil
  ArelExtensions::Nodes::IDoesNotMatch.new self, others, escape
end

#idoes_not_match_all(others, escape = nil) ⇒ Object 



115
116
117
 
# File 'lib/arel_extensions/string_functions.rb', line 115

def idoes_not_match_all others, escape = nil
  grouping_all :idoes_not_match, others, escape
end

#idoes_not_match_any(others, escape = nil) ⇒ Object 



111
112
113
 
# File 'lib/arel_extensions/string_functions.rb', line 111

def idoes_not_match_any others, escape = nil
  grouping_any :idoes_not_match, others, escape
end

#imatches(others, escape = nil) ⇒ Object 



82
83
84
 
# File 'lib/arel_extensions/string_functions.rb', line 82

def imatches others, escape = nil
  ArelExtensions::Nodes::IMatches.new self, others, escape
end

#imatches_all(others, escape = nil) ⇒ Object

def grouping_any method, others, *extra

  puts "*******************"
  puts method
  puts others.inspect
  puts extra.inspect
  puts "-------------------"
  res = super(method,others,*extra)
  puts res.to_sql
  puts res.inspect
  puts "*******************"
  res
end



103
104
105
 
# File 'lib/arel_extensions/string_functions.rb', line 103

def imatches_all others, escape = nil
  grouping_all :imatches, others, escape, escape
end

#imatches_any(others, escape = nil) ⇒ Object 



86
87
88
 
# File 'lib/arel_extensions/string_functions.rb', line 86

def imatches_any others, escape = nil
  grouping_any :imatches, others, escape
end

#length ⇒ Object

LENGTH function returns the length (bytewise) of the value in a text field.



31
32
33
 
# File 'lib/arel_extensions/string_functions.rb', line 31

def length
  ArelExtensions::Nodes::Length.new self, true
end

#levenshtein_distance(other) ⇒ Object 



209
210
211
 
# File 'lib/arel_extensions/string_functions.rb', line 209

def levenshtein_distance other
  ArelExtensions::Nodes::LevenshteinDistance.new [self, other]
end

#locate(val) ⇒ Object

LOCATE function returns the first starting position of a string in another string. If string1 or string2 is NULL then it returns NULL. If string1 not found in string2 then it returns 0.



45
46
47
 
# File 'lib/arel_extensions/string_functions.rb', line 45

def locate val
  ArelExtensions::Nodes::Locate.new [self, val]
end

#ltrim(other = ' ') ⇒ Object 



180
181
182
 
# File 'lib/arel_extensions/string_functions.rb', line 180

def ltrim other = ' '
  ArelExtensions::Nodes::Ltrim.new [self, other]
end

#md5 ⇒ Object 



217
218
219
 
# File 'lib/arel_extensions/string_functions.rb', line 217

def md5
  ArelExtensions::Nodes::MD5.new [self]
end

#not_blank ⇒ Object Also known as: present 



200
201
202
 
# File 'lib/arel_extensions/string_functions.rb', line 200

def not_blank
  ArelExtensions::Nodes::NotBlank.new [self]
end

#regexp_replace(pattern, substitute) ⇒ Object 



152
153
154
 
# File 'lib/arel_extensions/string_functions.rb', line 152

def regexp_replace pattern, substitute
  ArelExtensions::Nodes::RegexpReplace.new self, pattern, substitute
end

#repeat(other = 1) ⇒ Object 



205
206
207
 
# File 'lib/arel_extensions/string_functions.rb', line 205

def repeat other = 1
  ArelExtensions::Nodes::Repeat.new [self, other]
end

#replace(pattern, substitute) ⇒ Object

REPLACE function replaces a sequence of characters in a string with another set of characters, not case-sensitive.



144
145
146
147
148
149
150
 
# File 'lib/arel_extensions/string_functions.rb', line 144

def replace pattern, substitute
  if pattern.is_a? Regexp
    ArelExtensions::Nodes::RegexpReplace.new self, pattern, substitute
  else
    ArelExtensions::Nodes::Replace.new self, pattern, substitute
  end
end

#rtrim(other = ' ') ⇒ Object 



184
185
186
 
# File 'lib/arel_extensions/string_functions.rb', line 184

def rtrim other = ' '
  ArelExtensions::Nodes::Rtrim.new [self, other]
end

#smatches(other) ⇒ Object

accent sensitive & case sensitive



127
128
129
 
# File 'lib/arel_extensions/string_functions.rb', line 127

def smatches other # accent sensitive & case sensitive
  ArelExtensions::Nodes::SMatches.new(self, other)
end

#soundex ⇒ Object

SOUNDEX function returns a character string containing the phonetic representation of char.



78
79
80
 
# File 'lib/arel_extensions/string_functions.rb', line 78

def soundex
  ArelExtensions::Nodes::Soundex.new [self]
end

#substring(start, len = nil) ⇒ Object 



49
50
51
 
# File 'lib/arel_extensions/string_functions.rb', line 49

def substring start, len = nil
  ArelExtensions::Nodes::Substring.new [self, start, len]
end

#trim(other = ' ') ⇒ Object

Function returns a string after removing left, right or the both prefixes or suffixes int argument



176
177
178
 
# File 'lib/arel_extensions/string_functions.rb', line 176

def trim other = ' '
  ArelExtensions::Nodes::Trim.new [self, other]
end

#upcase ⇒ Object 



192
193
194
 
# File 'lib/arel_extensions/string_functions.rb', line 192

def upcase
  ArelExtensions::Nodes::Upcase.new [self]
end