fpassthru

Popis

Načíta dáta od aktuálnej pozície ukazovateľa súboru do konca súboru (EOF) a zapíše výsledky do výstupného buffera.

Ak nastala chyba, fpassthru() vráti FALSE. V opačnom prípade vráti fpassthru() počet načítaných a na výstup zaslaných znakov zo súboru, ktorý je špecifikovaný v parametri deskriptor

Deskriptor súboru musí byť platný a musí odkazovať na súbor, ktorý bol úspešne otvorený pomocou funkcie fopen(), popen() alebo fsockopen(). Niekedy je vhodné presunúť interný ukazovateľ súboru na jeho začiatok - pomocou funkcie rewind(). To môže nastať v prípadoch, ak ste už do súboru zadaného deskriptorom zapisovali. Súbor je po načítaní funkciou fpassthru() uzatvorený, čím sa stane deskriptor neplatným.

Ak chcete iba vypísať obsah súboru do výstupného buffera a neplánujete tento súbor modifikovať, či sa v ňom posúvať na rôzne miesta, môžete použiť funkciu readfile(). Ušetríte tým jedno volanie funkcie fopen().

Note: Pri používaní fpassthru() na binárnom súbore v systémoch Windows je potrebné sa uistiť, že súbor bol otvorený v binárnom móde. To je možné vykonať použitím príznaku b v parametri mód volania funkcie fopen().
Pri práci s binárnymi súbormi, odporúča sa používať príznak b, aj keď to systém nevyžaduje. Zaistí sa tým väčšia prenositeľnosť skriptov.

Pozri tiež readfile(), fopen(), popen() a fsockopen()