`readtable`

Lê um arquivo de texto delimitado ou planilha em uma tabela.

Categoria: Language Fundamentals > Data Types

Sintaxe

T = readtable(filename)

Lê o arquivo, tomando os nomes das variáveis da primeira linha e detectando o tipo de cada coluna.

T = readtable(filename, opts)

Lê usando um objeto de opções de importação.

T = readtable(___, Name, Value)

Ajusta a leitura com opções como 'Range' ou 'VariableNamingRule'.

Descrição

readtable é o modo usual de trazer dados tabulares para o workspace. Os nomes das colunas vêm da linha de cabeçalho; caracteres que não são válidos em nome de variável são substituídos (um nome como a;b vira a_b), a menos que a regra de nomes seja 'preserve'.

Para controlar tipos, marcadores de valores ausentes ou quais colunas ler, crie um objeto de opções com detectImportOptions, altere-o com setvartype e setvaropts e passe-o como segundo argumento.

Argumentos de entrada

filename: Nome de um arquivo .csv, .txt, .dat ou de planilha.
opts: Opções de importação, por exemplo de detectImportOptions.
'Range': Faixa de células a ler, como 'A2:B3'.

Argumentos de saída

T: Tabela com uma variável por coluna. Colunas numéricas viram double, colunas de texto viram cell arrays de vetores de caracteres.

Exemplo

fid = fopen('data.csv', 'w');
fprintf(fid, 'x,y\n1,a\n2,b\n');
fclose(fid);
T = readtable('data.csv')

Saída

T = 2×2 table

    x      y  
    _    _____

    1    {'a'}
    2    {'b'}

O exemplo primeiro grava um pequeno arquivo na pasta atual.

Observações

No MatLivre textos que parecem datas continuam como texto em vez de virar datetime; converta-os depois com datetime.

Somente texto separado por vírgulas é dividido em colunas. Um arquivo separado por ponto e vírgula, tabulação ou espaços é lido como uma única coluna, e a opção 'Delimiter' não tem efeito; converta antes esses arquivos para vírgulas.

Veja também

writetable detectImportOptions readtimetable readmatrix table