fpassthru

fpassthru -- Imprime todo os dados restantes de um ponteiro de arquivo

Descrição

int fpassthru ( int fp)

até o fim do arquivo ( EOF ) do ponteiro de arquivo dado e imprime os resultados para a buffer de saída .

Se um error ocorrer , a função fpassthru( ) retorna FALSE .

O ponteiro de arquivo tem que ser válido e apontar para um arquivo aberto com sucesso por fopen( ) , popen( ) ou fsockopen( ) . Você pode precisar chamar rewind( ) para reiniciar o ponteiro do arquivo para o início do arquivo caso você tenha escrito dados no arquivo . O arquivo é fechado quando fpassthru( ) acaba de ler (deixando fp sem utilidade ) .

Se você somente quiser jogar o conteúdo de um arquivo para o buffer de saída , sem primeiro modificar ou procurar por um detalhe qualquer , você pode querer usar a função readfile( ) , que vai economizar uma chamada a função fopen( ) .

Nota : Quando utilizando fpassthru( ) em um arquivo binário em sistemas Windows , você precisa verificar se abriu o arquivo em modo binário , acrescentando um b no modo informado na chamada de fopen( ) .

Você é encorajado a utilizar o modo b quando trabalhando com arquivos binários , mesmo que seu sistema não requira isso , de forma que seus scripts se tornem mais portáveis .

Veja também readfile( ) , fopen( ) , popen( ) e fsockopen( )