parsefloat ()

تابع Parsefloat () یک آرگومان رشته را تجزیه می کند و یک شماره نقطه شناور را برمی گرداند.

امتحانش کن

نحو

گل سرخ(رشته) 

مولفه های

رشته

مقدار تجزیه ، اجبار به یک رشته. فضای برجسته در این استدلال نادیده گرفته می شود.

مقدار بازگشت

یک شماره نقطه شناور از رشته داده شده تجزیه می شود ، یا وقتی اولین شخصیت غیر Wheitespace نمی تواند به یک عدد تبدیل شود.

توجه: JavaScript تمایز "شماره های نقطه شناور" و "عدد صحیح" را در سطح زبان ندارد. پارسینت () و پارسفلوات () فقط در رفتار تجزیه آنها متفاوت است ، اما لزوماً ارزش بازگشت آنها نیست. به عنوان مثال ، پارسینت ("42") و پارسفلوات ("42") همان مقدار را برمی گردانند: شماره 42.

شرح

تابع Parsefloat اولین آرگومان خود را به یک رشته تبدیل می کند ، که به عنوان یک شماره اعشاری به عنوان یک شماره اعشاری رشته می کند ، سپس یک عدد یا نان را برمی گرداند. تعداد نحوی که می پذیرد می تواند خلاصه شود:

• شخصیت های پذیرفته شده توسط parsefloat () به علاوه علامت ( +) ، علامت منفی ( - u + 002d hyphe n-minus) ، ارقام اعشاری (0 - 9) ، نقطه اعشاری (.) ، نشانگر نمایه (E یا E) و"بی نهایت" تحت اللفظی.
• علائم + / - فقط در ابتدای رشته یا بلافاصله پس از شخصیت E / E می توانند کاملاً ظاهر شوند. نقطه اعشاری فقط می تواند یک بار و فقط قبل از شخصیت E / E ظاهر شود. شخصیت E / E فقط می تواند یک بار ظاهر شود ، و تنها در صورت وجود حداقل یک رقم قبل از آن.
• فضاهای پیشرو در استدلال بریده و نادیده گرفته می شوند.
• Parsefloat () همچنین اگر رشته با "بی نهایت" یا "-Infinity" قبل از هیچ یک یا بیشتر فضاهای سفید شروع شود ، می تواند بی نهایت یا خطی را بازگرداند و برگرداند.
• Parsefloat () طولانی ترین بستر را از ابتدا شروع می کند که یک لفظی معتبر ایجاد می کند. اگر با یک شخصیت نامعتبر روبرو شود ، شماره ای را که تا آن نقطه نشان داده شده است باز می گرداند ، و شخصیت نامعتبر و همه شخصیت های زیر آن را نادیده می گیرد.
• اگر شخصیت اول استدلال نتواند شماره قانونی را در هر نحوی فوق شروع کند ، ParseFloat NAN را برمی گرداند.

نحو عاقلانه ، parsefloat () زیر مجموعه ای از نحو را که عملکرد شماره () می پذیرد ، تجزیه می کند. یعنی Parsefloat () از خطاهای غیر دمایی با پیشوندهای 0x ، 0b یا 0o پشتیبانی نمی کند ، اما از همه چیز دیگر پشتیبانی می کند. با این حال ، parsefloat () نسبت به تعداد () ملایم تر است زیرا شخصیت های نامعتبر را نادیده می گیرد ، و این باعث می شود تعداد () NAN برگردد.

مشابه تعداد تحت اللفظی و تعداد () ، تعداد برگشتی از parsefloat () ممکن است دقیقاً برابر با تعداد نشان داده شده توسط رشته نباشد ، به دلیل محدوده نقطه شناور و عدم دقت. برای اعداد خارج ا ز-1. 79769348623158e+30 8-1. 7976931348623158e+308 محدوده (به شماره. max_value) ، -Infinity یا Infinity برگردانده می شود.

مثال ها

با استفاده از parsefloat ()

مثالهای زیر همه 3. 14 برمی گردد:

گل سرخ(3. 14); گل سرخ("3. 14"); گل سرخ("3. 14"); گل سرخ("314e-2"); گل سرخ("0. 0314e+2"); گل سرخ("3. 14 شخصیت های غیر رقمی"); گل سرخ( شیب دار()  برگشت "3. 14"; >, >); 

parsefloat () بازگشت نان

مثال زیر NAN را برمی گرداند:

گل سرخ("FF2"); 

به طور غیرقانونی ، زیرا خود NAN رشته نحوی نامعتبر است همانطور که توسط Parsefloat () پذیرفته شده است ، با عبور "نان" NAN را نیز برمی گرداند.

گل سرخ("نان"); // نان 

بازگشت بی نهایت

مقادیر Infinity هنگامی برگردانده می شوند که تعداد خارج از محدوده فرمت IEEE 754-2019 با دقت 64 بیتی:

گل سرخ("1. 7976931348623159E+308"); // بی نهایت گل سرخ("-1. 7976931348623159e+308"); // -بی نهایت 

بی نهایت هنگامی که رشته با "Infinity" یا "-Infinity" شروع می شود نیز برگردانده می شود:

گل سرخ("بی نهایت"); // بی نهایت گل سرخ("-بی نهایت"); // -بی نهایت 

تعامل با ارزش های bigint

parsefloat () مقادیر bigint را اداره نمی کند. در شخصیت N متوقف می شود و رشته قبلی را به عنوان یک عدد صحیح طبیعی ، با از دست دادن دقت احتمالی ، درمان می کند. اگر یک مقدار bigint به Parsefloat () منتقل شود ، به یک رشته تبدیل می شود و رشته به عنوان یک شماره نقطه شناور تجزیه می شود ، که ممکن است منجر به از بین رفتن دقت شود.

گل سرخ(900719925474099267N); // 900719925474099300 گل سرخ("900719925474099267N"); // 900719925474099300 

شما باید به جای آن ، رشته را به عملکرد BigInt () منتقل کنید ، بدون اینکه شخصیت Traking N باشد.

با ابله("900719925474099267"); // 900719925474099267N 

مشخصات فنی

سازگاری مرورگر

جداول BCD فقط در مرورگر بارگیری می شود

همچنین ببینید

• parseint ()
• number. parsefloat ()
• number. parseint ()
• number. prototype. tofixed ()

با این صفحه مشکل محتوا پیدا کرده اید؟

• صفحه را در GitHub ویرایش کنید.
• گزارش محتوا را گزارش دهید.
• منبع را در GitHub مشاهده کنید.

این صفحه آخرین بار در 21 فوریه 2023 توسط همکاران MDN اصلاح شد.

طرح شما برای اینترنت بهتر.

مگد

حمایت کردن

• کمک محصول
• گزارش یک موضوع

جوامع ما

توسعه دهنده

• فن آوری های وب
• توسعه وب را بیاموزید
• MDN به علاوه

• اطلاعیه حریم خصوصی وب سایت
• بیسکویت ها
• مجاز
• دستورالعمل مشارکت جامعه

به والدین غیر انتفاعی شرکت موزیلا ، بنیاد موزیلا مراجعه کنید. بخش هایی از این محتوا © 1998 - 2023 توسط مشارکت کنندگان mozilla. org است. محتوای موجود تحت مجوز Creative Commons.