.ReadLine()
La sintassi del metodo .ReadLine() di una variabile di tipo File o di tipo Stream è:
variabile_File.ReadLine([Escape]) As String
Se il parametro Escape non è specificato, allora il metodo .ReadLine() legge una sola intera riga dal flusso similmente all'istruzione Line Input, ossia fino al carattere escape di "fine riga e a capo" (rappresentato in esadecimale dal valore 0A).
Se, invece, il parametro viene specificato, ed è presente esso nel flusso di dati almeno due volte, allora il metodo .ReadLine() legge tante righe dal flusso fino al valore di "fine riga e a capo" della seconda riga contenente il carattere escape specificato nel parametro del metodo.
Mostriamo un esempio pratico.
Poniamo che il file abbia il seguente testo:
Lo scopo di questa Wiki è quello di condividere, scambiare, immagazzinare la conoscenza in modo collaborativo grazie alle potenzialità offerte dalla Wiki stessa, una collezione di documenti ipertestuali.
Il suddetto file avrà 5 caratteri escape di "fine riga a capo", e più precisamente immediatamente dopo le parole: testo, condividere, collaborativo, stessa ed ipertestuali.
Se il parametro escape del metodo .ReadLine() non fosse specificato, tale metodo leggerebbe soltanto l'intera prima riga. Poniamo, però, per esempio questo codice:
Public Sub Main() Dim fl As File fl = Open "/percorso/del/file/di/testo" ' Con il metodo "ReadLine()" non è necessario: "For Read" ' Poniamo come argomento "escape" il carattere "W": Print fl.ReadLine("W") fl.Close End
Il carattere "W", oltre che nella prima riga, è presente anche nella terza riga del file di testo. Pertanto, il metodo .ReadLine() leggerà i dati testuali dal primo carattere della prima riga sino al carattere escape di "fine riga a capo" della terza riga, ignorando così i valori di "fine riga a capo" presenti al termine della prima e della seconda riga.
Successivamente il metodo .ReadLine() per i restanti dati continuerà a comportarsi come di norma, cioè arrestandosi al carattere di "fine riga a capo" presente al termine della terza riga (ossia immediatmente dopo la parola: stessa).