Difference between revisions of "Manuals/calci/LOOKUP"

From ZCubes Wiki
Jump to navigation Jump to search
Line 86: Line 86:
 
*[http://en.wikipedia.org/wiki/String_(computer_science) String]
 
*[http://en.wikipedia.org/wiki/String_(computer_science) String]
 
*[http://en.wikipedia.org/wiki/Comparison_of_programming_languages_(string_functions)#Find Find String]
 
*[http://en.wikipedia.org/wiki/Comparison_of_programming_languages_(string_functions)#Find Find String]
 +
 +
 +
 +
*[[Z_API_Functions | List of Main Z Functions]]
 +
 +
*[[ Z3 |  Z3 home ]]

Revision as of 05:29, 14 March 2017

LOOKUP(lkup_val, lkup_vector, rslt_vector)

where,

  • lkup_val is the value to be matched from an array or range of values,
  • lkup_vector is the array of values or reference to one-row or one-column containing values, and
  • rslt_vector is a range that contains only one-row or one-column and is same size as lkup_vector.

LOOKUP() looks up for a specified value in one-row range or one-column range or an array, and displays a value from same position in second one-row range or one-column range or an array.

Description

LOOKUP(lkup_val, lkup_vector, rslt_vector)

  • LOOKUP() function can be used in two forms - Vector Form and Array Form.
  • In Vector Form, Calci looks for the specified value in one-row or one-column range and returns the value from same position in second one-row or one-column range.
  • In Array Form, Calci looks for the specified value in first row or column of an array, and returns the value from same position in last row or column of the array.
  • lkup_val can be a number, text or logical value, or reference to cell containing number, text or logical value.
  • lkup_vector can be one row or one column containing set of values or a reference to cells containing values.
  • Values in lkup_vector should be arranged in ascending order to obtain correct results.
  • Arguments containing text values entered as a part of command, should be enclosed in quotes (e.g. "JOHN").
  • Size of lkup_vector should be same as rslt_vector, else Calci displays #NULL error message.
  • If no match is found for lkup_val in the specified range, Calci displays the largest value which is <= lkup_val.
  • LOOKUP function is not case-sensitive.
  • If lkup_val is less than 'smallest value in lkup_vector', Calci displays #NULL error message.
  • For invalid arguments, Calci displays #NULL error message.

Examples

Following table shows the use of LOOKUP function in Vector Form -

Quantity Item
10 Pen
12 Pencil
15 Eraser
25 Notebooks
35 Markers
=LOOKUP(12,A2:A6,B2:B6) : Looks up for '12' in range A2 to A6 and returns value 
from range B2 to B6 in same row. Returns Pencil as a result. =LOOKUP(A2,A2:A6,B2:B6) : Looks up for '10' in range A2 to A6 and returns value
from range B2 to B6 in same row. Returns Pen as a result. =LOOKUP(17,A2:A6,B2:B6) : As there is no exact match for '17',
matches the nearest value '15' and returns value from range B2 to B6 in same row.
Returns Eraser as a result.

Following examples show the use of LOOKUP function in Array Form -

=LOOKUP("B",["A","B","C"],[100,200,300]) : Looks up for 'B' in an array and 
returns value in last row of array in same column. Returns 200 as a result. =LOOKUP("cat",["A","B","C"],[100,200,300]) : As there is no exact match,
Calci finds the largest value <= 'cat' ('C') in array and
returns value in last row of array in same column. Returns 300 as a result.

Related Videos

LOOKUP

See Also

References