`table`

Cria uma tabela: dados orientados a colunas com variáveis nomeadas, como uma planilha.

Categoria: Language Fundamentals > Data Types

Sintaxe

T = table(var1, var2, ...)

Cria uma tabela a partir de variáveis com a mesma altura.

T = table(___, 'VariableNames', names)

Dá nomes às variáveis.

Descrição

Uma tabela guarda colunas de tipos diferentes lado a lado: números, texto, datas, categorias. Cada coluna é uma variável nomeada, então você trabalha com ela pelo nome e não pela posição. T.num retorna uma coluna, T(2, :) retorna uma linha como tabela, T{2, 'num'} retorna seu conteúdo e size(T) dá linhas por variáveis.

Sem 'VariableNames', as variáveis se chamam Var1, Var2 e assim por diante, ou assumem os nomes das variáveis de entrada quando são nomes simples. Tabelas podem ser ordenadas com sortrows, agrupadas com groupsummary e combinadas com join.

Argumentos de entrada

var1, var2, ...: Arrays com o mesmo número de linhas. Cada um é uma coluna (uma variável matricial mantém várias colunas).
'VariableNames': Cell array de nomes, um por variável. Os nomes devem ser únicos e válidos.

Argumentos de saída

T: Tabela com uma linha por linha das entradas.

Exemplo

Criar, indexar e fatiar

T = table([1;2;3], {'a';'b';'c'}, 'VariableNames', {'num','txt'})
T.num
size(T)
T(2,:)

Saída

T = 3×2 table

    num     txt 
    ___    _____

     1     {'a'}
     2     {'b'}
     3     {'c'}
ans = 3×1

     1
     2
     3
ans = 1×2

     3     2
ans = 1×2 table

    num     txt 
    ___    _____

     2     {'b'}

Observações

A forma table('Size', ..., 'VariableTypes', ...) para pré-alocar uma tabela vazia não é suportada pelo MatLivre.

Veja também

array2table cell2table readtable sortrows timetable struct2table