الفرق بين المراجعتين لصفحة: «Arduino/stringobject/tofloat»

المراجعة الحالية بتاريخ 06:22، 7 نوفمبر 2018

يحوِّل التابع toFloat()‎ السلسلة النصية التي استدعيت معه إلى عددٍ عشري. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. إن لم تحوي السلسلة النصية على أي محرف رقمي، فستتوقف عملية التحويل. على سبيل المثال، ستحول السلاسل النصية "123.45"، و "123"، و "123fish" إلى 123.45، و 123.00، و 123.00 على التوالي. انتبه إلى أنَّ السلسلة النصية "123.456" ستحوَّل وتقرَّب إلى 123.46. انتبه أيضًا إلى أنَّ الأعداد العشرية تملك دقة محدودة تتراوح بين 6 و 7 منازل عشرية، لذا ستُقرَّب السلاسل النصية التي تحوي أعدادًا عشريةً ذات دقة أكبر من ذلك عند تحويلها.

البنية العامة

string.toFloat()

تمثِّل string السلسلة النصية المراد تحويلها إلى عددٍ عشري.

القيم المعادة

يعاد عددٌ عشري يمثِّل ناتج تحويل السلسلة النصية المعطاة. إن لم يكن بالإمكان إجراء عملية التحويل لأنَّ السلسلة النصية تلك لا تبدأ برقم صالح، فسيُعاد العدد 0 آنذاك.

أمثلة

مثال على استعمال التابع toFloat()‎:

String stringValue1 = "12wiki Hsoub";
String stringValue2 = "wiki12Hsoub";
void setup() {
  Serial.begin(9600);
}

void loop() {
  Serial.println(stringValue1.toFloat()); // 12.00
  Serial.println(stringValue2.toFloat()); // 0.00
}

انظر أيضًا

التابع c_str()‎: يحوِّل محتوى السلسلة النصية التي استدعيت معه إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف null).
التابع toCharArray()‎: يحول كامل السلسلة النصية التي استدعيت معه أو جزءًا منها إلى سلسلة نصية مكونة من مصفوفة من المحارف.
التابع toInt()‎: يحول السلسلة النصية التي استدعيت معه إلى عددٍ صحيحٍ.
التابع toLowerCase()‎: يحوِّل جميع حروف السلسلة النصية التي استدعيت معه إلى حروف صغيرة (lower-case).
التابع toUpperCase()‎: يحوِّل جميع حروف السلسلة النصية التي استدعيت معه إلى حروف كبيرة (upper-case).

مصادر

صفحة التابع toFloat()‎ في توثيق أردوينو الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:التابع <code>String.toFloat()‎</code> في أردوينو}}</noinclude>
-تحوِّل الدالة <code>toFloat()‎</code> [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها إلى [[Arduino/float|عددٍ عشري]]. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. إن لم تحوي السلسلة النصية على أي محرف رقمي، فستتوقف عملية التحويل. على سبيل المثال، ستحول السلاسل النصية "123.45"، و "123"، و "123fish" إلى 123.45، و 123.00، و 123.00 على التوالي. انتبه إلى أنَّ السلسلة النصية "123.456" ستحوَّل وتقرَّب إلى 123.46. انتبه أيضًا إلى أنَّ [[Arduino/float|الأعداد العشرية]] تملك دقة محدودة تتراوح بين 6 و 7 منازل عشرية، لذا ستُقرَّب السلاسل النصية التي تحوي أعدادًا عشريةً ذات دقة أكبر من ذلك عند تحويلها.
+يحوِّل التابع <code>toFloat()‎</code> [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/float|عددٍ عشري]]. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. إن لم تحوي السلسلة النصية على أي محرف رقمي، فستتوقف عملية التحويل. على سبيل المثال، ستحول السلاسل النصية "123.45"، و "123"، و "123fish" إلى 123.45، و 123.00، و 123.00 على التوالي. انتبه إلى أنَّ السلسلة النصية "123.456" ستحوَّل وتقرَّب إلى 123.46. انتبه أيضًا إلى أنَّ [[Arduino/float|الأعداد العشرية]] تملك دقة محدودة تتراوح بين 6 و 7 منازل عشرية، لذا ستُقرَّب السلاسل النصية التي تحوي أعدادًا عشريةً ذات دقة أكبر من ذلك عند تحويلها.
 ==البنية العامة==
 <syntaxhighlight lang="arduino">
@@ سطر 7: / سطر 6: @@
 </syntaxhighlight>تمثِّل <code>string</code> [[Arduino/stringobject|السلسلة النصية]] المراد تحويلها إلى [[Arduino/float|عددٍ عشري]].
 ==القيم المعادة==
 يعاد [[Arduino/float|عددٌ عشري]] يمثِّل ناتج تحويل [[Arduino/stringobject|السلسلة النصية]] المعطاة. إن لم يكن بالإمكان إجراء عملية التحويل لأنَّ [[Arduino/stringobject|السلسلة النصية]] تلك لا تبدأ برقم صالح، فسيُعاد العدد 0 آنذاك.
+==أمثلة==
+مثال على استعمال التابع <code>toFloat()‎</code>:<syntaxhighlight lang="arduino">
+String stringValue1 = "12wiki Hsoub";
+String stringValue2 = "wiki12Hsoub";
+void setup() {
+  Serial.begin(9600);
+}
+void loop() {
+  Serial.println(stringValue1.toFloat()); // 12.00
+  Serial.println(stringValue2.toFloat()); // 0.00
+}
+</syntaxhighlight>
 ==انظر أيضًا==
-* الدالة <code>[[Arduino/string/tochararray|toCharArray()‎]]</code>: تحول كامل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها أو جزءًا منها إلى [[Arduino/string|سلسلة نصية]] مكونة من مصفوفة من المحارف.
+*التابع <code>[[Arduino/stringobject/c str|c_str()‎]]</code>: يحوِّل محتوى السلسلة النصية التي استدعيت معه إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف <code>null</code>).
-* الدالة <code>[[Arduino/string/toint|toInt()‎]]</code>: تحول [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها إلى [[Arduino/int|عددٍ صحيحٍ]].
+*التابع <code>[[Arduino/stringobject/tochararray|toCharArray()‎]]</code>: يحول كامل [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه أو جزءًا منها إلى [[Arduino/string|سلسلة نصية]] مكونة من مصفوفة من المحارف.
-* الدالة <code>[[Arduino/string/tolowercase|toLowerCase()‎]]</code>: تحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها إلى حروف صغيرة (lower-case).
+*التابع <code>[[Arduino/stringobject/toint|toInt()‎]]</code>: يحول [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/int|عددٍ صحيحٍ]].
-* الدالة <code>[[Arduino/string/touppercase|toUpperCase()‎]]</code>: تحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معها إلى حروف كبيرة (upper-case).
+*التابع <code>[[Arduino/stringobject/tolowercase|toLowerCase()‎]]</code>: يحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى حروف صغيرة (lower-case).
+*التابع <code>[[Arduino/stringobject/touppercase|toUpperCase()‎]]</code>: يحوِّل جميع حروف [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى حروف كبيرة (upper-case).
 ==مصادر==
-*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/tofloat/ صفحة الدالة toFloat()‎ في توثيق أردوينو الرسمي.]
+*[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/tofloat/ صفحة التابع toFloat()‎ في توثيق أردوينو الرسمي.]
 [[تصنيف: Arduino]]
 [[تصنيف: Arduino Method]]
 [[تصنيف: Arduino String]]