diff options
Diffstat (limited to 'files/es/web/javascript/referencia/objetos_globales/parseint/index.html')
-rw-r--r-- | files/es/web/javascript/referencia/objetos_globales/parseint/index.html | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/files/es/web/javascript/referencia/objetos_globales/parseint/index.html b/files/es/web/javascript/referencia/objetos_globales/parseint/index.html new file mode 100644 index 0000000000..30e3874a34 --- /dev/null +++ b/files/es/web/javascript/referencia/objetos_globales/parseint/index.html @@ -0,0 +1,89 @@ +--- +title: parseInt() +slug: Web/JavaScript/Referencia/Objetos_globales/parseInt +translation_of: Web/JavaScript/Reference/Global_Objects/parseInt +--- +<div>{{jsSidebar("Objects")}}</div> + +<h2 id="Resumen" name="Resumen">Resumen</h2> + +<p>Convierte (parsea) un argumento de tipo cadena y devuelve un entero de la base especificada.</p> + +<h2 id="Sintaxis" name="Sintaxis">Sintaxis</h2> + +<pre class="syntaxbox">parseInt(<em>string</em>, <em>base</em>);</pre> + +<h3 id="Par.C3.A1metros" name="Par.C3.A1metros">Parámetros</h3> + +<dl> + <dt><code>cadena</code></dt> + <dd>Una cadena que representa el valor que se desea convertir.</dd> +</dl> + +<dl> + <dt><code>base</code></dt> + <dd>Un entero que representa la base de la mencionada cadena.</dd> +</dl> + +<h2 id="Descripci.C3.B3n" name="Descripci.C3.B3n">Descripción</h2> + +<p><code>parseInt</code> es una función de alto nivel y no está asociada a ningún objeto.</p> + +<p>La función <code>parseInt</code> comprueba el primer argumento, una cadena, e intenta devolver un entero de la base especificada. Por ejemplo, una base de 10 indica una conversión a 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.</p> + +<p>Si <code>parseInt</code> 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. <code>parseInt</code> trunca los números en valores enteros. Se permiten espacios anteriores y posteriores.</p> + +<p>Si no se especifica la base o se especifica como 0, JavaScript asume lo siguiente:</p> + +<ul> + <li>Si el parámetro <code>cadena</code> comienza por "0x", la base es 16 (hexadecimal).</li> + <li>Si el parámetro <code>cadena</code> comienza por "0", la base es de 8 (octal). Esta característica está desaconsejada.</li> + <li>Si el parámetro <code>cadena</code> comienza por cualquier otro valor, la base es 10 (decimal).</li> +</ul> + +<p>Si el primer carácter no se puede convertir en número, <code>parseInt</code> devuelve <code>NaN</code>.</p> + +<p>Para fines aritméticos, el valor <code>NaN</code> no es un número en ninguna base. Puede llamar a la función {{jsxref("Objetos_globales/isNaN", "isNaN")}} para determinar se el resultado de <code>parseInt</code> es <code>NaN</code>. Si se pasa <code>NaN</code> en operaciones aritméticas, la operación resultante también será <code>NaN</code>.</p> + +<p>Para convertir números a su literal cadena en una base en particular, utilice <code>intValue.toString(base)</code>.</p> + +<h2 id="Ejemplos" name="Ejemplos">Ejemplos</h2> + +<h3 id="Ejemplo:_Usando_parseInt" name="Ejemplo:_Usando_parseInt">Ejemplo: Usando <code>parseInt</code></h3> + +<p>Todos los siguientes ejemplos devuelven 15:</p> + +<pre class="brush: js">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); +</pre> + +<p>Todos los siguientes ejemplos devuelven <code>NaN</code>:</p> + +<pre class="brush: js">parseInt("Hello", 8); // No es un número en absoluto +parseInt("0x7", 10); // No es de base 10 +parseInt("546", 2); // Los dígitos no son válidos para representaciones binarias. +</pre> + +<p>Incluso aunque la base especificada es diferente, todos los siguientes ejemplos devuelven 17 ya que el argumento <code>cadena</code> comienza por "<code>0x</code>".</p> + +<pre class="brush: js">parseInt("0x11", 16); +parseInt("0x11", 0); +parseInt("0x11"); +</pre> + +<h3 id="Vea_Tambi.C3.A9n" name="Vea_Tambi.C3.A9n">Véase También</h3> + +<ul> + <li>{{jsxref("Objetos_globales/parseFloat", "parseFloat()")}}</li> + <li>{{jsxref("Number.parseFloat()")}}</li> + <li>{{jsxref("Number.parseInt()")}}</li> + <li>{{jsxref("Objetos_globales/isNaN", "isNaN()")}}</li> + <li>{{jsxref("Number.toString()")}}</li> + <li>{{jsxref("Object.valueOf")}}</li> +</ul> |