Objekt TextStream zprostředkovává přístup k obsahu textových souborů uložených na disku.
Používá se pro čtení z textových souborů nebo pro zápis do textových souborů.
Instanci objektu TextStream můžeme získat několika způsoby:
Metoda Close slouží k uzavření otevřeného souboru. Při volání této metody je objekt zrušen a již nelze dále přistupovat k jeho atributům a metodám.
Metoda Read přečte ze souboru zadaný počet znaků a vrátí je jako řetězec. Soubor před tím musí být samozřejmě otevřen v režimu čtení. Pokud bude soubor otevřen v jiném režimu, dojde k chybě.
Metoda ReadAll přečte celý obsah souboru a vrátí ho jako řetězec. Soubor před tím musí být samozřejmě otevřen v režimu čtení. Pokud bude soubor otevřen v jiném režimu, dojde k chybě.
Metoda ReadLine přečte ze souboru jednu řádku a vrátí ji jako řetězec. Soubor před tím musí být samozřejmě otevřen v režimu čtení. Pokud bude soubor otevřen v jiném režimu, dojde k chybě.
Metoda Skip přeskočí zadaný počet znaků v souboru. Zadaný počet znaků může být kladný nebo záporný, v tom případě se ukazatel pozice v souboru vrátí o patřičný počet znaků zpět.
Metodu Skip lze použít pouze pro soubory otevřené v režimu čtení.
Metoda SkipLine přesune ukazatel pozice v souboru na začátek další řádky.
Tato metoda může být použita pouze u souborů otevřených v režimu čtení. Pro zapsání prázdných řádek do souboru složí metoda WriteBlankLines.
Metoda Write zapíše zadaný řetězec do souboru. Pokud byl soubor otevřen v režimu ForWriting, zapisují se řetězce postupně od začátku souboru. Byl-li soubor otevřen v režimu ForAppending, přidávají se zapisované řetězce na konec původního souboru.
Tato metoda zapíše do souboru zadaný řetězec (pokud je nějaký zadán) a poté do souboru vloží znak konce řádky.
Metoda WriteBlankLines zapíše do souboru zadaný počet znaků konce řádky.
Atribut AtEndOfLine vrací hodnotu true, pokud je ukazatel pozice v souboru nastaven hned před znakem konce řádky. Tento atribut lze použít pouze u souborů otevřených v režimu čtení, při použití v jiných režimech nastane chyba.
Atribut AtEndOfStream vrací hodnotu true, pokud ukazatel pozice v souboru ukazuje na konec souboru. Tento atribut lze použít pouze pro soubory otevřené v režimu čtení. Při použití v ostatních režimech dojde k chybě.
Hodnota atributu Column odpovídá číslu znaku v řádce, který bude první přečten při následujícím čtení. Znaky v řádce jsou číslovány od jedničky.
Hodnota atributu Line odpovídá číslu řádky, z níž se bude číst první znak při následujícím čtení. Řádky jsou číslovány od jedničky.