php 한글 메뉴얼 도움말 검색 사이트 Gets line from file pointer [function.fgets]

설명

string fgets ( resource $handle [, int $length ] )

Gets a line from file pointer.

인수

handle: 파일 포인터는 fopen(), fsockopen()을 통하여 성공적으로 열려, fclose()로 닫지 않은 유효한 파일이여야 합니다.
length: Reading ends when length - 1 bytes have been read, or a newline (which is included in the return value), or an EOF (whichever comes first). If no length is specified, it will keep reading from the stream until it reaches the end of the line.

Note:
Until PHP 4.3.0, omitting it would assume 1024 as the line length. If the majority of the lines in the file are all larger than 8KB, it is more resource efficient for your script to specify the maximum line length.

반환값

Returns a string of up to length - 1 bytes read from the file pointed to by handle. If there is no more data to read in the file pointer, then FALSE is returned.

If an error occurs, FALSE is returned.

변경점

버전	설명
4.3.0	fgets() is now binary safe

예제

Example #1 Reading a file line by line


<?php
$handle = @fopen("/tmp/inputfile.txt", "r");
if ($handle) {
    while (($buffer = fgets($handle, 4096)) !== false) {
        echo $buffer;
    }
    if (!feof($handle)) {
        echo "Error: unexpected fgets() fail\n";
    }
    fclose($handle);
}
?>

주의

Note: PHP가 매킨토시 컴퓨터에서 파일을 읽거나 작성할 때 행의 끝을 판단하지 못하면, auto_detect_line_endings 실행 옵션을 활성화 함으로써 문제가 해결될 수 있습니다.

Note:
People used to the 'C' semantics of fgets() should note the difference in how EOF is returned.

참고

fgetss() - Gets line from file pointer and strip HTML tags
fread() - Binary-safe file read
fgetc() - Gets character from file pointer
stream_get_line() - Gets line from stream resource up to a given delimiter
fopen() - Opens file or URL
popen() - Opens process file pointer
fsockopen() - Open Internet or Unix domain socket connection
stream_set_timeout() - Set timeout period on a stream