Retorna uma String com comprimento indicado pelo parâmetro @length e que representa o valor indicado no parâmetro @value com o número de casas decimais igual ao valor indicado no parâmetro @decimals. Caso o número de caracteres utilizados para representar o parâmetro @value seja menor que o parâmetro @length, a String retornada é preenchida com espaços à esquerda. Caso o número de caracteres necessários para representar o parâmetro @value seja maior que o parâmetro @length, a String retornada é composta por uma sequência de caracteres de asterisco (*) com comprimento igual ao parâmetro @length.

Sintaxe

STR(@value[, @length[, @decimals]])

Parâmetros

•@value: Valor a ser convertido para uma String. Este parâmetro é obrigatório

•@length: Parâmetro opcional que define o comprimento da String de retorno. O valor padrão deste parâmetro é 10

•@decimals: Número de casas decimais que devem ser representadas na String de retorno. Caso o parâmetro @length seja menor do que a quantidade de casas decimais necessária para representar o parâmetro @value de forma exata, o valor representado é arredondado. O valor padrão deste parâmetro é 0 (zero) e o valor máximo é 16. Valores maiores são substituídos por 16