delimitedTextImportOptions

Cria um objeto de opções que descreve como importar um arquivo de texto delimitado.

Categoria: Data Import and Analysis > Data Import and Export

Sintaxe

opts = delimitedTextImportOptions

opts = delimitedTextImportOptions('NumVariables', n)

opts = delimitedTextImportOptions(..., Name, Value)

Descrição

As opções de importação dão controle total sobre uma leitura de texto: quais colunas existem, o tipo de cada uma e quais são selecionadas. O objeto pode ser inspecionado, alterado e reutilizado em vários arquivos de mesmo formato.

Para deixar a biblioteca adivinhar o formato, chame detectImportOptions em um arquivo de amostra e ajuste só o que ela errou.

Argumentos de entrada

'NumVariables'

Número de colunas do arquivo.

'VariableNames'

Cell array com os nomes das colunas da tabela resultante.

'VariableTypes'

Cell array de tipos: 'double', 'string', 'char', 'datetime' etc.

'Delimiter'

Caractere ou cell array de caracteres que separam os campos.

Argumentos de saída

opts

Objeto de opções de importação, passado como segundo argumento de readtable, readmatrix ou readcell.

Exemplo

Ler um arquivo sem cabeçalho com tipos escolhidos

fid = fopen('p.csv', 'w');
fprintf(fid, 'Ann,30\nBob,25\n');
fclose(fid);
opts = delimitedTextImportOptions('NumVariables', 2, ...
    'VariableNames', {'name', 'age'}, ...
    'VariableTypes', {'string', 'double'}, ...
    'Delimiter', ',');
T = readtable('p.csv', opts)

T = 2×2 table

    name     age
    _____    ___

    "Ann"    30 
    "Bob"    25

Observações

No MatLivre, DataLines passado ao construtor é ignorado, e atribuir VariableNames ao objeto depois (opts.VariableNames = ...) faz readtable falhar com erro de variável desconhecida. Passe nomes e tipos como argumentos do construtor, como no exemplo, e use dados sem cabeçalho.

Veja também

detectImportOptions readtable readmatrix readcell