`str2double`

Converte texto em números de precisão dupla, retornando NaN onde o texto não é um número.

Categoria: Language Fundamentals > Data Types

Sintaxe

X = str2double(str)

Converte um vetor de caracteres, uma string ou cada elemento de um array de strings ou cell array.

Descrição

Ao contrário de str2num, str2double nunca avalia código, portanto é seguro para entradas fornecidas por usuários. Aceita sinal opcional, ponto decimal, expoente (1e3), Inf e NaN, espaços nas pontas e separadores de milhar como 1,000.

Entradas que não são texto, como um valor numérico, retornam NaN. A falha é silenciosa: use isnan quando precisar detectar entradas inválidas.

Argumentos de entrada

str: Texto a converter: vetor de caracteres, array de strings ou cell array de vetores de caracteres.

Argumentos de saída

X: Array double com um valor por texto de entrada; NaN para texto que não pode ser lido como número.

Exemplo

Texto válido e inválido

str2double('3.14')
str2double({'1e3','abc','-2'})
str2double("1,000")

Saída

ans = 3.1400
ans = 1×3

        1000         NaN          -2
ans = 1000

Veja também

str2num num2str string sscanf isnan