Module: Carmen::Querying

Included in:
Country, RegionCollection
Defined in:
lib/carmen/querying.rb

Instance Method Summary collapse

Instance Method Details

#coded(code) ⇒ Object

Find a region by code.

code - The String code to search for

Returns a region with the supplied code, or nil if none is found.



10
11
12
13
14
15
16
17
18
19
20
 
# File 'lib/carmen/querying.rb', line 10

def coded(code)
  return nil if code.nil?
  attribute = attribute_to_search_for_code(code)
  if attribute.nil?
    fail "could not find an attribute to search for code '#{code}'"
  end
  code = code.downcase # Codes are all ASCII
  query_collection.find do |region|
    region.send(attribute).downcase == code
  end
end

#named(name, options = {}) ⇒ Object

Find a region by name.

name - The String name to search for. options - The Hash options used to modify the search (default:{}):

:fuzzy - Whether to use fuzzy matching when finding a
         matching name (optional, default: false)
:case  - Whether or not the match is case-sensitive
         (optional, default: false)

Returns a region with the supplied name, or nil if none if found.



32
33
34
35
36
37
38
39
40
41
42
43
 
# File 'lib/carmen/querying.rb', line 32

def named(name, options={})
  case_fold = !options[:case] && name.respond_to?(:each_codepoint)
  # These only need to be built once
  name = case_fold ? normalise_name(name) : name
  # For now, "fuzzy" just means substring, optionally case-insensitive (the second argument looks for nil, not falseness)
  regexp = options[:fuzzy] ? Regexp.new(name.split(/[-'\s]/).join("[-'\s]"), options[:case] ? nil : true) : nil

  query_collection.find do |region|
    found_literal = name === (case_fold && region.name ? normalise_name(region.name) : region.name)
    found_literal || options[:fuzzy] && regexp === region.name
  end
end