# Num# – função de script e gráfico

Num#() interpreta uma string de texto como um valor numérico, ou seja, converte a string de entrada em um número usando o formato especificado no segundo parâmetro. Se o segundo parâmetro for omitido, ele usará os separadores decimal e milhar definidos no script de carga de dados. Símbolos de separador decimal e de milhar personalizados são parâmetros opcionais.

Num#(text[, format[, dec\_sep [, thou\_sep ] ] ])

Tipo de dados de retorno: dual

A função Num#() retorna um valor duplo como a string e o valor numérico. A função usa a representação textual da expressão de entrada e gera um número. Ela não altera o formato do número: a saída é formatada da mesma forma que a entrada.

Argumentos de Num#

| Argumento | Descrição |
| --- | --- |
| text | A string de texto a ser avaliada. |
| format | String que especifica o formato de número usado no primeiro parâmetro. Se omitida, os separadores decimais e de milhar definidos no script de carregamento de dados serão usados. |
| dec\_sep | String especificando o separador de número decimal. Se omitida, o valor da variável DecimalSep definido no script de carregamento de dados será usado. |
| thou\_sep | String especificando o separador de número milhar. Se omitida, o valor da variável ThousandSep definido no script de carregamento de dados será usado. |

A tabela a seguir mostra o resultado de Num#( A, '#', '.' , ',') para diferentes valores de A.

Resultados

| A | Representação de string | Valor numérico (aqui exibido com casa decimal) |
| --- | --- | --- |
| 35,648.31 | 35,648.31 | 35648.31 |
| 35 648.312 | 35 648.312 | 35648.312 |
| 35.648,3123 | 35.648,3123 | - |
| 35 648,31234 | 35 648,31234 | - |