fgets
(PHP 4, PHP 5, PHP 7, PHP 8)
fgets — Читає рядок із файлу
Опис
fgets(resource $stream, ?int $length = null): string|false
Читає рядок із файлового покажчика.
Список параметрів
stream
Вказівник на файл повинен бути коректним і вказувати на файл, успішно відкритий функціями fopen() або fsockopen() (і все ще не закритий функцією fclose()
length
Читання закінчується при досягненні length - 1 байт, або якщо зустрівся новий рядок (який включається в результат, що повертається) або кінець файлу (залежно від того, що настане раніше). Якщо довжина не вказана, читання з потоку триватиме доти, доки досягне кінця рядка.
Значення, що повертаються
Повертає рядок розміром у length - 1 байт, прочитаний з дескриптора файлу, на який вказує параметр stream. Якщо даних для читання більше немає, то повертає false
У разі виникнення помилки повертає false
Приклади
Приклад #1 Порядкове читання файлу
Примітки
Зауваження: Якщо виникають проблеми з розпізнаванням PHP кінців рядків під час читання або створення файлів на Macintosh-сумісному комп'ютері, увімкнення опції auto_detect_line_endingsможет помочь решить проблему.
Зауваження :
Програмісти, що звикли до семантики 'C' функції fgets(), повинні брати до уваги різницю в тому, як повертається ознака досягнення кінця файлу (
EOF
Дивіться також
- fgetss() - Читає рядок з файлу та видаляє HTML-теги
- fread() - Бінарно-безпечне читання файлу
- fgetc() - Зчитує символ із файлу
- stream_get_line() - Отримує рядок із потокового ресурсу до вказаного роздільника
- fopen() - Відкриває файл або URL
- popen() - Відкриває файловий покажчик процесу
- fsockopen() - Відкриває з'єднання з інтернет-сокетом або доменним сокетом Unix
- stream_set_timeout() - Встановити значення часу очікування потоку