Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

5.1 Aufbau der Testumgebung 247
39
40 * ptr ++ = c; /* Zeichen im Puffer hinterlegen */
41
42 /* Bei EOF oder Zeilenumbruch: Schleife verlassen */
43 if( ( br == 0 ) || ( c == ’\n’ ) )
44 break;
45 }
46
47 /* Noch gar nichts gelesen und schon EOF? */
48 if( ( br == 0 ) && ( n == 1 ) )
49 return( 0 ); /* EOF zurückgeben */
50
51 *ptr = 0; /* Ergebnis mit Nullbyte terminieren ... */
52 return( n ); /* ... und Anzahl der Zeichen zurückgeben */
53 }
17–18
23–33
Die readline()-Funktion erwartet insgesamt vier Parameter, die ersten drei
Parameter sind mit den Parametern der read()-Funktion identisch. Die Funktion
liest eine Zeichenkette von maximal nbyte-1 Zeichen vom Dateideskriptor
fildes in den Puffer buf ein und terminiert diese Zeichenkette in jedem
Fall mit einem Nullbyte. Der Zeilentrenner wird ebenfalls mit in der Zeichenkette
abgelegt. readline() liest weniger als nbyte-1 Zeichen, sofern zuvor
ein Zeilentrenner erkannt wird. Taucht innerhalb der nbyte-1 Zeichen kein
Zeilentrenner auf, so werden die bislang gelesenen nbyte-1 Zeichen als nullterminierte
Zeichenkette zurückgeliefert.
Der vierte Parameter help, über welchen die readline()-Funktion threadsicher
gemacht wird, verlangt die Adresse eines void-Zeigers. Wird readline()
für einen Dateideskriptor zum ersten Mal aufgerufen, so wird der Funktion
die Adresse eines mit NULL initialisierten void-Zeigers übergeben. Die
readline()-Funktion weist dem Zeiger dann die Adresse einer Datenstruktur
vom Typ readline_t zu, welche bei nachfolgenden Aufrufen der readline()-
Funktion für diesen Dateideskriptor wieder verwendet wird. Die Aufsicht über
den Zwischenspeicher und folglich auch der Schutz vor konkurrierendem Zugriff
aus verschiedenen Threads wird damit an die aufrufende Umgebung delegiert.
Sobald die Eingabe über den Dateideskriptor abgeschlossen ist, muß die
Anwendung den von readline() implizit angelegten Zwischenpuffer mittels
free() wieder freigeben.
Als erstes wird dem Hilfszeiger rl die Adresse der eventuell bereits in einem
vorhergehenden Aufruf angelgten Hilfsstruktur zugewiesen. Wird readline()
für den angegebenen Dateideskriptor zum ersten Mal aufgerufen, so hat rl
nun den Wert NULL. In diesem Fall fordert die readline()-Funktion vom
System Speicher für eine neue readline_t-Datenstruktur an und initialisiert
dieneueStruktur.