`str2num`

Avalia um texto como expressão do MATLAB e retorna seu valor numérico.

Categoria: Language Fundamentals > Data Types

Sintaxe

X = str2num(str)

Avalia str e retorna o resultado.

[X, tf] = str2num(str)

Também retorna se a conversão teve sucesso.

Descrição

str2num envolve o texto em colchetes e o executa com eval, então entende matrizes, aritmética e chamadas de função, não apenas números literais. Por isso pode executar código arbitrário e é lenta para grandes volumes de texto.

Quando o texto é apenas um número, prefira str2double, que é mais rápida, segura e retorna NaN em vez de uma matriz vazia em caso de falha.

Argumentos de entrada

str: Vetor de caracteres ou string com uma expressão numérica, como '[1 2; 3 4]' ou '2*pi'.

Argumentos de saída

X: O valor da expressão, ou [] se não foi possível avaliá-la.
tf: true se a conversão funcionou, false caso contrário.

Exemplo

Matriz, expressão e falha

A = str2num('[1 2; 3 4]')
[v, ok] = str2num('2*pi')
[w, ok2] = str2num('hello world(')

Saída

A = 2×2

     1     2
     3     4
v = 6.2832
ok = logical
   1
w = []
ok2 = logical
   0

Veja também

str2double eval num2str sscanf