Editing Ar Find

{{Function
 |origin = NVSE
 |summary = Added by NVSE V4. Returns the key of the first occurrence of a value in an array, or optionally within a sub range of the array. If the value searched for is not found, it returns the constant [[Ar_BadNumericIndex]] (-99999.0) for numeric indexed arrays, or the constant [[Ar_BadStringIndex]] (empty string) for those that are string indexed.
 |name = Ar_Find
 |returnType = int-OR-string
 |arguments = 
  {{FunctionArgument
   |Name = Value
   |Type = multi}}{{FunctionArgument
   |Name = ToSearch
   |Type = array}}{{FunctionArgument
   |Name = Subrange
   |Type = range}}}}
==Example==
A numeric indexed array ("array" or "map"):
<pre>
if eval (Ar_Find SomeValue, SomeArray) != Ar_BadNumericIndex
    ; then SomeValue is an element in SomeArray
endif
</pre>

A string indexed array ("stringmap"):
<pre>
if eval (Ar_Find SomeValue, MyStringMap) != Ar_BadStringIndex
    ; then SomeValue is an element in MyStringMap
endif
</pre>

Another numeric example, with extra context:
<pre>
array_var aBeatles

let aBeatles := Ar_List JohnREF, PaulREF, GeorgeREF, RingoREF ; * example context

if eval (Ar_Find RingoREF, aBeatles) != Ar_BadNumericIndex
    ; * Ringo is found somewhere in the array aBeatles

elseif eval (Ar_Find JohnREF, aBeatles) < (Ar_Find PaulREF, aBeatles)
    ; * John is found earlier in the array than Paul

elseif eval (Ar_Find GeorgeREF, aBeatles, 1:2) != Ar_BadNumericIndex
    ; * George is found within the subrange (second to third elements) of array

endif

</pre>

==See Also==
*[[Array Variables]]
*[[Let]]
*[[Eval]]
*[[Ar_List]]
*[[Ar_BadNumericIndex]]
*[[Ar_BadStringIndex]]
[[Category:Functions_(NVSE)]]
[[Category:Array Variables]]