CxiError cxiFindNext (CxiFindBuffer *fb)

Suche nach Variablen

fb:
Handle für Suchschleife (von cxiFindOpen geliefert)

return:
0 ok, sonst Fehler

Diese Funktion führt die Suche nach Variablen aus. Wird eine Variable gefunden, die der Namens- und Typmaske entspricht, liefert cxiFindNext 0 (cxiNoError) zurück und füllt fb mit den Informationen der Variablen. Wird keine weitere Übereinstimmung gefunden, ist der Rückgabewert cxiErrorNoMoreVars. In Fehlersituationen können auch andere CxiError-Werte zurückgegeben werden.

Zwischen den Aufrufen von cxiFindNext darf nur dann ein Wechsel des Sichtfensters vorgenommen werden, wenn vor dem nächsten Aufruf in das ursprüngliche Fenster zurückgewechselt wird.

Beispiel 1:

#include <stdio.h>
#include "cxib.h" 
int main ()
{
  CxiNode n = "V1=1;VZwei=2;Drei=3;V4=4;#5=5;"; 
  CxiFindBuffer *fb = cxiFindOpen (n, "V*", 0);
  // Schleife über alle Variablen, deren Name mit 'V' beginnt
  while (cxiFindNext (fb) == cxiNoError)
    printf ("%s\n", fb->name);
  cxiFindClose (fb); 
  return 0;
}

Beispiel 2:

#include <stdio.h>
#include "cxib.h" 
int main ()
{
  int i;
  CxiError rc; 
  CxiNode n = "V1=1;VZwei='2';Drei=3;V4=Vier;#5=5;";
  printf ("\n"); 
  CxiFindBuffer *fb = cxiFindOpen (n, "*", "n");
  cxiFindSetTypeMask (fb, cxiTypeNum, 1);
  // Schleife über alle numerischen Variablen
  while (cxiFindNext (fb) == cxiNoError)
    printf ("%s\n", fb->name);
  cxiFindClose (fb); 
  return 0;
}

Portabilität:
Diese Funktion ist ab Version 2.05 definiert und in allen unterstützten Systemen verfügbar.

Siehe auch:
FindOpen - Beginn der Suchschleife
FindSetTypeMask - Datentypmaske
FindClose - Beenden der Suchschleife