getBestIndividualInfo

Syntax: const cIndividualInfo * getBestIndividualInfo(
unsigned long lNumber=1, short iLive=1 ) const

Diese Methode gibt eine Referenz auf die Individueninformationen cIndividualInfo des lNumber'ten besten Individuums zurück. (die Zählung beginnt bei 1) Wenn kein solches Individuum existiert, wird der Nullpointer NULL zurückgegeben.

Wenn also alle Individuen nach ihrer Fitness absteigend geordnet werden, so dass das beste Individuum bei $1$ vorn steht, werden die Individueninformationen des lNumber'ten Individuums zurückgegeben.

Der Parameter iLive gibt an, welcher Art die Individuen sein sollen, welche betrachtet werden. Betrachtet werden standardmaßig nur alle lebenden Individuen.

Eingabeparameter:

• lNumber: Die Nummer die angibt, von welchen lNumber'te besten Individuum die Individueninformationen cIndividualInfo zurückgegeben werden sollen. Standardmäßig ist der Wert $1$ und es werden die Individueninformationen des besten Individuums zurückgegeben.
• iLive: Der Wert von iLive gibt an, ob die Individueninformationen von lebende, tote oder allen betrachtet werden sollen. Zu toten Individuen existiert kein Individuenobjekt mehr, sondern nur noch die Individueninformationen. Folgende Werte von iLive sind zulässig:

  0

  : Wenn iLive gleich 0 ist, werden die Individueninformationen aller Individuen betrachtet, egal ob sie leben oder tot sind.

  1

  : Wenn iLive gleich 1 ist, werden die Individueninformationen aller noch lebenden Individuen betrachtet.

  -1

  : Wenn iLive gleich -1 ist, werden die Individueninformationen aller nicht mehr lebenden bzw. toten Individuen betrachtet.

   ${}$

  In allen andern Fällen wird der Nullpointer NULL zurückgebenen. Dies sollte nicht benutzt werden, da diese Bereich für spätere Erweiterungen vorgesehen sind.

Rückgabe: Eine Referenz auf die Individueninformationen cIndividualInfo des lNumber'ten besten Individuums oder der Nullpointer NULL, wenn kein solches Individuum existiert.