This translation is incomplete. Please help translate this article from English.

פונקציית ()parseInt מנתחת מחרוזת ומחזירה במקומה מספר שלם. (המספר יעוגל כלפי מטה).
 

תחביר

parseInt(string, radix);

פרמטרים

string
במידה והערך שהוזן אינו מחרוזת הוא מומר למחרוזת באמצעות הפעולה ToString.
radix
במערכות מספרים מתמטיות, הרדיקס הוא מספר הספרות הייחודיות (כולל אפס) המשמשות לייצוג מספרים במערכת ספרה נקודתית. כאשר הרדיקס אינו מצויין, ברירת המחדל תהיה 10.

ערך מוחזר

במידה ולא ניתן להמיר את המחרוזת למספר יוחזר למשתמש NaN.

תיאור

The parseInt function converts its first argument to a string, parses it, and returns an integer or NaN. If not NaN, the returned value will be the integer that is the first argument taken as a number in the specified radix (base). For example, a radix of 10 indicates to convert from a decimal number, 8 octal, 16 hexadecimal, and so on. For radices above 10, the letters of the alphabet indicate numerals greater than 9. For example, for hexadecimal numbers (base 16), A through F are used.

If parseInt encounters a character that is not a numeral in the specified radix, it ignores it and all succeeding characters and returns the integer value parsed up to that point. parseInt truncates numbers to integer values. Leading and trailing spaces are allowed.

Because some numbers include the e character in their string representation (e.g. 6.022e23), using parseInt to truncate numeric values will produce unexpected results when used on very large or very small numbers. parseInt should not be used as a substitute for Math.floor().

If radix is undefined or 0 (or absent), JavaScript assumes the following:

  • If the input string begins with "0x" or "0X", radix is 16 (hexadecimal) and the remainder of the string is parsed.
  • If the input string begins with "0", radix is eight (octal) or 10 (decimal).  Exactly which radix is chosen is implementation-dependent.  ECMAScript 5 specifies that 10 (decimal) is used, but not all browsers support this yet.  For this reason always specify a radix when using parseInt.
  • If the input string begins with any other value, the radix is 10 (decimal).

If the first character cannot be converted to a number, parseInt returns NaN.

For arithmetic purposes, the NaN value is not a number in any radix. You can call the isNaN function to determine if the result of parseInt is NaN. If NaN is passed on to arithmetic operations, the operation results will also be NaN.

To convert number to its string literal in a particular radix use intValue.toString(radix).

דוגמאות

שימוש ב-parseInt

התוצאה של כל אחת מהדוגמאות שלהלן תהיה 15 :

parseInt(' 0xF', 16);
parseInt(' F', 16);
parseInt('17', 8);
parseInt(021, 8);
parseInt('015', 10);   // parseInt(015, 10); will return 15
parseInt(15.99, 10);
parseInt('15,123', 10);
parseInt('FXX123', 16);
parseInt('1111', 2);
parseInt('15 * 3', 10);
parseInt('15e2', 10);
parseInt('15px', 10);
parseInt('12', 13);

התוצאה של כל אחת מהדוגמאות שלהלן תהיה NaN :

parseInt('Hello', 8); // Not a number at all
parseInt('546', 2);   // Digits are not valid for binary representations

התוצאה של כל אחת מהדוגמאות שלהלן תהיה 15- :

parseInt('-F', 16);
parseInt('-0F', 16);
parseInt('-0XF', 16);
parseInt(-15.1, 10)
parseInt(' -17', 8);
parseInt(' -15', 10);
parseInt('-1111', 2);
parseInt('-15e1', 10);
parseInt('-12', 13);

התוצאה של כל אחת מהדוגמאות שלהלן תהיה 4 :

parseInt(4.7, 10);
parseInt(4.7 * 1e22, 10); // Very large number becomes 4
parseInt(0.00000000000434, 10); // Very small number becomes 4

התוצאה של הדוגמה שלהלן תהיה 224 :

parseInt('0e0', 16);

לעיתים, ביטויים רגולרים עשויים להיות דרך שימושית לניתוח ערכים:

var filterInt = function(value) {
  if (/^(\-|\+)?([0-9]+|Infinity)$/.test(value))
    return Number(value);
  return NaN;
}

console.log(filterInt('421'));               // 421
console.log(filterInt('-421'));              // -421
console.log(filterInt('+421'));              // 421
console.log(filterInt('Infinity'));          // Infinity
console.log(filterInt('421e+0'));            // NaN
console.log(filterInt('421hop'));            // NaN
console.log(filterInt('hop1.61803398875'));  // NaN
console.log(filterInt('1.61803398875'));     // NaN

ראו גם

  • parseFloat()
  • Number.parseFloat()
  • Number.parseInt()
  • Number.toString

Document Tags and Contributors

Contributors to this page: fabio.rahamim
Last updated by: fabio.rahamim,