###User Defined Function###
_ArrayBinarySearch

###Description###
Nutzt einen binären Such-Algorithmus um ein eindimensionales Datenfeld (array) zu durchsuchen.

###Syntax###
#include <Array.au3>
_ArrayBinarySearch ( $avArray, $iKey [, $i_Base=0] )


###Parameters###
@@ParamTable@@
$avArray
	Das eindimensional sortierte Datenfeld (array) zum Durchsuchen.
$iKey
	Zeichenfolge (String) oder Zahl, nach der im Datenfeld gesucht werden soll.
$i_Base
	Optional: Startet Datenfeld Index zur Sortierung, normal auf 0 oder 1 gesetzt.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:        Gibt den Index Wert zurück, wo sich das Element im Datenfeld befindet.
Misserfolg:    Gibt eine leere Zeichenfolge zurück.
@Error:       0 = Kein Fehler.
               1 = <i>$avArray</i> ist kein Datenfeld.
               2 = <i>$iKey</i> liegt außerhalb der Grenzen.
               3 = Element wurde nicht gefunden.
@@End@@


###Remarks###
Vor einer binären Suche nach einem Element in einem Datenfeld <b>MUSS</b> das Datenfeld sortiert sein, ansonsten sind die ReturnValuee nicht zuverlässig.

Das Datenfeld wird durch Referenzierung an die Funktion übergeben, sodass keine weiteren Resourcen genutzt werden außer ein paar interner Variablen.


###Related###
Keine.


###Example###
@@IncludeExample@@