.^

Operador de potência elemento a elemento.

Categoria: Language Fundamentals > Operators and Elementary Operations

Sintaxe

C = A .^ B

Descrição

Uma base negativa com expoente não inteiro dá um resultado complexo em vez de NaN: (-8).^(1/3) é complexo, e a raiz cúbica real se obtém com nthroot. 0.^0 vale 1.

Ao contrário de ^, que eleva uma matriz quadrada a uma potência no sentido da álgebra linear, .^ sempre atua elemento a elemento, então A.^2 eleva ao quadrado cada entrada.

Argumentos de entrada

A

Base: array numérico ou lógico.

B

Expoente, com tamanho compatível com A.

Argumentos de saída

C

Array de potências, com o tamanho dado pela expansão implícita.

Exemplo

[1 2 3] .^ 2
2 .^ [1 2 3 4]
[1 2; 3 4] .^ 2
(-8) .^ (1/3)

ans = 1×3

     1     4     9
ans = 1×4

     2     4     8    16
ans = 2×2

     1     4
     9    16
ans = 1.0000 + 1.7321i

Veja também

power ^ sqrt nthroot exp