rowfun

Aplica uma função a cada linha de uma tabela.

Categoria: Language Fundamentals > Data Types

Sintaxe

B = rowfun(func, A)

Chama func uma vez por linha, passando as variáveis da linha como argumentos separados.

B = rowfun(___, 'InputVariables', vars)

Usa apenas as variáveis listadas como entradas.

B = rowfun(___, 'OutputVariableNames', names)

Dá nome às variáveis de saída.

Descrição

É o equivalente de arrayfun para tabelas. Com @(a, b) a + b e uma tabela de duas variáveis, a função recebe os valores A e B de cada linha e os resultados formam a coluna de saída. Por padrão as variáveis de saída têm nomes como Var1, Var2, ...; passe 'OutputVariableNames' para escolhê-los.

Argumentos de entrada

func
Function handle. Recebe um valor de cada variável de entrada e retorna um escalar ou uma linha.
A
Tabela ou timetable.
'InputVariables'
Nomes ou índices das variáveis passadas a func.

Argumentos de saída

B
Tabela com uma linha por linha de A e os resultados como variáveis.

Exemplo

T = table([1;2;3], [4;5;6], 'VariableNames', {'A','B'});
rowfun(@(a, b) a + b, T, 'OutputVariableNames', 'S')
Saída
ans = 3×1 table

    S
    _

    5
    7
    9

Observações

A opção 'SeparateInputs' não é aplicada no MatLivre: func sempre recebe os valores de uma linha como argumentos separados.

Veja também

varfun arrayfun cellfun splitapply groupsummary