Str (Función)

Artículo
10/07/2008

Actualización: noviembre 2007

Devuelve la representación String de un número.

Public Shared Function Str(ByVal Number As Object) As String

Parámetros

Number
Obligatorio. Object que contiene cualquier expresión numérica válida.

Excepciones

Tipo de excepción	Número de error	Condición
ArgumentNullException	5	Number no se especifica.
InvalidCastException	5	Number no es un tipo numérico.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

Cuando los números se conviertan a cadenas, siempre se reservará un espacio inicial para el signo de Number. Si Number es positivo, la cadena devuelta contiene un espacio inicial y el signo más se da por supuesto. Un número negativo incluirá el signo menos (-) y ningún espacio inicial.

Use la función Format para convertir valores numéricos a los que desee aplicar formato de fecha, hora o moneda, u otros formatos definidos por el usuario. Al contrario de lo que ocurre con la función Str, la función Format no incluye ningún espacio inicial para el signo de Number.

Nota:
La función Str sólo reconoce el punto (.) como separador decimal válido. Si se utilizan separadores decimales diferentes, como sucede en aplicaciones internacionales, debe utilizar las funciones CStr o Format para convertir un número en una cadena. Para obtener la representación de cadena de un número en una referencia cultural determinada, utilice el método ToString(IFormatProvider) del número. Por ejemplo, utilice ToString al convertir un valor de tipo Double en una cadena.

La función Str sólo reconoce el punto (.) como separador decimal válido. Si se utilizan separadores decimales diferentes, como sucede en aplicaciones internacionales, debe utilizar las funciones CStr o Format para convertir un número en una cadena. Para obtener la representación de cadena de un número en una referencia cultural determinada, utilice el método ToString(IFormatProvider) del número. Por ejemplo, utilice ToString al convertir un valor de tipo Double en una cadena.

Ejemplo

En este ejemplo se utiliza la función Str para devolver una representación String de un número. Cuando los números positivos se conviertan a cadenas, siempre se reservará un espacio inicial para su signo.

Dim TestString As String
' Returns " 459".
TestString = Str(459)
' Returns "-459.65".
TestString = Str(-459.65)
' Returns " 459.001".
TestString = Str(459.001)