Referencia de JavaScript 1.5:Funciones globales:parseInt

De MDC

Tabla de contenidos 1 Resumen 2 Sintaxis 3 Parámetros 4 Descripción 5 Ejemplos 5.1 Ejemplo: Usando parseInt 6 Vea También

[editar] Resumen

Función Del Núcleo

Convierte (parsea) un argumento de tipo cadena y devuelve un entero de la base especificada.

[editar] Sintaxis

var valorEntero = parseInt(cadena[, base]);

[editar] Parámetros

cadena 

Una cadena que representa el valor que se desea convertir.

base 

Un entero que representa la base de la mencionada cadena.

[editar] Descripción

parseInt es una función de alto nivel y no está asociada a ningún objeto.

La función parseInt comprueba el primer argumento, una cadena, e intenta devolver un entero de la base especificada. Por ejemplo, una base de 10 indica una conversióna número decimal, 8 octal, 16 hexadecimal, y así sucesivamente. Para bases superiores a 10, las letras del alfabeto indican numerales mayores que 9. Por ejemplo, para números hexadecimales (base 16), se utiliza de la A hasta la F.

Si parseInt encuentra un carácter que no es un numeral de la base especificada, lo ignora a él y a todos los caracteres correctos siguientes, devolviendo el valor entero obtenido hasta ese punto. parseInt trunca los números en valores enteros. Se permiten espacios anteriores y posteriores.

Si no se especifica la base o se especifica como 0, JavaScript asume lo siguiente:

• Si el parámetro cadena comienza por "0x", la base es 16 (hexadecimal).
• Si el parámetro cadena comienza por "0", la base es de 8 (octal). Esta característica está desaconsejada.
• Si el parámetro cadena comienza por cualquier otro valor, la base es 10 (decimal).

Si el primer carácter no se puede convertir en número, parseInt devuelve NaN.

Para fines aritméticos, el valor NaN no es un número en ninguna base. Puede llamar a la función isNaN para determinar se el resultado de parseInt es NaN. Si se pasa NaN en operaciones aritméticas, la operación resultante también será NaN.

Para convertir números a su literal cadena en una base en particular, utilice intValue.toString(base).

[editar] Ejemplos

[editar] Ejemplo: Usando parseInt

Todos los siguientes ejemplos devuelven 15:

parseInt("F", 16);
parseInt("17", 8);
parseInt("15", 10);
parseInt(15.99, 10);
parseInt("FXX123", 16);
parseInt("1111", 2);
parseInt("15*3", 10);
parseInt("12", 13);

Todos los siguientes ejemplos devuelven NaN:

parseInt("Hello", 8); // Not a number at all
parseInt("0x7", 10);  // Not in base 10 format
parseInt("546", 2);   // Digits are not valid for binary representations

Incluso aunque la base especificada es diferente, todos los siguientes ejemplos devuelven 17 ya que el argumento cadena comienza por "0x".

parseInt("0x11", 16);
parseInt("0x11", 0);
parseInt("0x11");

[editar] Vea También

isNaN, parseFloat, Object.valueOf, Number.toString