Exception: LookupError

Inherits:
StandardError
  • Object
show all
Defined in:
lib/lookup.rb

Overview

lookup.rb – simple keyword lookup routine

Alan K. Stebbens <[email protected]>

require 'lookup'

lookup - lookup a keyword in a list, in a case-insensitive, disambiguous way

:call-seq:

result = lookup list, key, err_notfound="%s not found", err_ambig="% is ambiguous"
result = list.lookup( key, err_notfound, err_ambig )
result = list.lookup( key, err_notfound )
result = list.lookup( key )

Lookup key in list, which can be an array or a hash. Return the one that matches exactly, or matches using case-insensitive, unambiguous matches, or raise a LookupError with a message.

LookupError is a subclass of StandardError.

LookupNotFoundError, a subclass of LookupError, is raised when a keyword is not found, and only if ‘err_notfound` is not nil.

LookupAmbigError, a subsclass of LookupError, is raised when a keyword search matches multiple entries from the list, and only if ‘err_ambig` is not nil.

If err_notfound is nil, do not raise a LookupNotFoundError error, and return nil.

If err_ambigmsg is nil, do not raise a LookupAmbigError, and return the list of possible results.

Direct Known Subclasses

LookupAmbigError, LookupNotFoundError