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
# File 'lib/arel_extensions/string_functions.rb', line 23

def &(other)
  ArelExtensions::Nodes::FindInSet.new [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].



59
60
61
62
63
64
65
66
67
68
69
70
71
72
# File 'lib/arel_extensions/string_functions.rb', line 59

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_collateObject



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

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

#ai_imatches(other) ⇒ Object

accent insensitive & case insensitive



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

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

#ai_matches(other) ⇒ Object

accent insensitive & case sensitive



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

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

#blankObject



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

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

#byte_lengthObject



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

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

#char_lengthObject



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

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

#ci_collateObject



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

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

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



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

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

#concat(other) ⇒ Object



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

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

#downcaseObject



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

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

#edit_distance(other) ⇒ Object



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

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



158
159
160
161
162
163
164
165
166
167
168
169
170
# File 'lib/arel_extensions/string_functions.rb', line 158

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



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

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

#idoes_not_match_all(others, escape = nil) ⇒ Object



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

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

#idoes_not_match_any(others, escape = nil) ⇒ Object



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

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

#imatches(others, escape = nil) ⇒ Object



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

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


100
101
102
# File 'lib/arel_extensions/string_functions.rb', line 100

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

#imatches_any(others, escape = nil) ⇒ Object



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

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

#lengthObject

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



28
29
30
# File 'lib/arel_extensions/string_functions.rb', line 28

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

#levenshtein_distance(other) ⇒ Object



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

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.



42
43
44
# File 'lib/arel_extensions/string_functions.rb', line 42

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

#ltrim(other = ' ') ⇒ Object



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

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

#md5Object



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

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

#not_blankObject Also known as: present



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

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

#regexp_replace(pattern, substitute) ⇒ Object



149
150
151
# File 'lib/arel_extensions/string_functions.rb', line 149

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

#repeat(other = 1) ⇒ Object



202
203
204
# File 'lib/arel_extensions/string_functions.rb', line 202

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.



141
142
143
144
145
146
147
# File 'lib/arel_extensions/string_functions.rb', line 141

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



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

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

#smatches(other) ⇒ Object

accent sensitive & case sensitive



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

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

#soundexObject

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



75
76
77
# File 'lib/arel_extensions/string_functions.rb', line 75

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

#substring(start, len = nil) ⇒ Object



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

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



173
174
175
# File 'lib/arel_extensions/string_functions.rb', line 173

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

#upcaseObject



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

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