array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'splfileobject.construct.php', 1 => 'SplFileObject::__construct', 2 => 'Constrói um novo objeto de arquivo', ), 'up' => array ( 0 => 'class.splfileobject.php', 1 => 'SplFileObject', ), 'prev' => array ( 0 => 'class.splfileobject.php', 1 => 'SplFileObject', ), 'next' => array ( 0 => 'splfileobject.current.php', 1 => 'SplFileObject::current', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/spl/splfileobject/construct.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SplFileObject::__construct

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

SplFileObject::__construct — Constrói um novo objeto de arquivo

Descrição

public SplFileObject::__construct(
    string $filename,
    string $mode = "r",
    bool $useIncludePath = false,
    ?resource $context = null
)

Constrói um novo objeto de arquivo.

Parâmetros

filename

O arquivo para ler.

Dica

Uma URL pode ser usada como um nome de arquivo com esta função se os empacotadores fopen estiverem habilitados. Consulte a função fopen() para mais detalhes sobre como especificar o nome do arquivo. Consulte os Protocolos e empacotadores suportados para obter links para informações sobre as capacidades de cada empacotador, notas de uso e informações sobre quaisquer variáveis predefinidas que eles possam fornecer.

mode

O modo no qual abrir o arquivo. Consulte fopen() para obter uma lista de modos permitidos.

useIncludePath

Se deve procurar no include_path pelo filename.

context

Um recurso de contexto válido criado com stream_context_create().

Erros/Exceções

Lança uma RuntimeException se o filename não puder ser aberto.

Lança uma LogicException se o filename for um diretório.

Exemplos

Exemplo #1 Exemplo de SplFileObject::__construct()

Este exemplo abre o arquivo atual e itera sobre seu conteúdo linha por linha.

<?php
$file = new SplFileObject(__FILE__);
foreach ($file as $line_num => $line) {
echo "Linha $line_num é $line";
}
?>

O exemplo acima produzirá algo semelhante a:

Linha 0 é <?php
Linha 1 é $file = new SplFileObject(__FILE__);
Linha 2 é foreach ($file as $line_num => $line) {
Linha 3 é     echo "Linha $line_num é $line";
Linha 4 é }
Linha 5 é ?>

Veja Também