Dokument
libidxf · Geometrieelemente · Lesen
Synopsis
» geometry* reader.next ()
geometry* reader.next (geometry)
Beschreibung
Die Methode next() liest das nächste Geometrieelement aus der beim Instanzieren der reader-Klasse übergebenen Datei. Ist der Rückgabewert NULL, so sind keine weiteren Geometrieelemente vorhanden.
Mit der Methode setlayerfilter() kann das Lesen von Geometrieelementen auf bestimmte Lagen beschränkt werden. next() liefert dann nicht das nächste Element der Datei, sondern das nächste Element der Datei aus einer der freigegebenen Lagen. Bis dahin in der Datei enthaltene Geometrieelemente anderer Lagen werden überlesen.
· Aufruf ohne Parameter
Die Instanz für das gelesene Geometrieelement, sofern eines vorhanden ist, wird innerhalb der Methode angelegt. Die zurückgegebene Referenz verweist auf das neu angelegte Element; die Freigabe des Elementes mit delete obliegt dem Aufrufer.
· Aufruf mit Parameter
Die Daten des gelesenen Geometrieelementes werden in das übergebene Element geschrieben. Eine neue Instanz wird nicht angelegt. Die zurückgegebene Referenz verweist auf die Instanz des übergebenen Elements oder ist NULL, wenn kein Element gelesen werden konnte (in diesem Fall wird das übergebene Element außerdem als ungültig markiert).
Beispiele
FILE*  fd = fopen(...);
reader rdr(fd);

geometry* geom;
while ((geom=rdr.next()) != NULL) {
  printf("%s\n", toa(geom));
}
Siehe auch
Alle Methoden und Operatoren; Lagen filtern