دالات تحويل أنواع البيانات

هام: تمت ترجمة هذه المقالة ترجمة آلية، راجع إقرار إخلاء المسؤولية. يرجى الاطلاع على النسخة الإنجليزية من هذه المقالة. هنا للرجوع إليها.

تفرض كل دالة تعبير على نوع البيانات محدد.

بناء الجملة

CBool( expression )‎

CByte( expression )‎

CCur( expression )‎

CDate( expression )‎

CDbl( expression )‎

CDec( expression )‎

CInt( expression )‎

CLng( expression )‎

CSng( expression )‎

CStr( expression )‎

CVar( expression )‎

إن وسيطة expressionوسيطة هي أي تعبير السلسلة أو تعبير رقمي.

أنواع الإرجاع

يحدد اسم الدالة نوع الإرجاع كما هو موضح في ما يلي:

الوظيفة

نوع الإرجاع

نطاق لوسيطة expression

CBool

منطقي

أي تعبير سلسلة أحرف أو تعبير رقمي صحيح.

CByte

بايت

من 0 إلى 255.

CCur

عملة

من -922،337،203،685،477.5808 إلى 922،337،203،685،477.5807.

CDate

تاريخ

أي تعبير تاريخ صحيح.

CDbl

مزدوج

من -1.79769313486231E308 إلى
-4.94065645841247E-324 للقيم السالبة؛ من 4.94065645841247E-324 إلى 1.79769313486232E308 للقيم الموجبة.

CDec

عدد عشري

+/-79,228,162,514,264,337,593,543,950,335 للأرقام ذات المقياس صفر؛ بمعنى، الأرقام التي لا توجد بها منازل عشرية. وبالنسبة للأرقام التي تتضمن 28 منزلة عشرية، يكون النطاق
+/-7.9228162514264337593543950335. ويكون أقل رقم غير صفري ممكن هو 0.0000000000000000000000000001.

CInt

عدد صحيح

يتم تقريب الكسور من -32,768 إلى 32,767.

CLng

طويلة

يتم تقريب الكسور من -2,147,483,648 إلى 2,147,483,647.

CSng

مفرد

من -3.402823E38 إلى -1.401298E-45 للقيم السالبة؛ ومن 1.401298E-45 إلى 3.402823E38 للقيم الموجبة.

CStr

سلسلة أحرف

يُرجع CStr المستند إلى الوسيطة expression.

CVar

متغير

نفس النطاق مثل نوع بيانات مزدوج للقيم الرقمية. ونفس النطاق مثل سلسلة الأحرف للقيم غير الرقمية.


ملاحظات

إذا كانت expression التي تم تمريرها إلى الدالة، موجودة خارج نطاق نوع البيانات الذي يتم التحويل إليه، يحدث خطأ.

يمكنك بشكل عام توثيق التعليمات البرمجية باستخدام دالات تحويل البيانات لتوضيح ضرورة التعبير عن ناتج بعض العمليات كنوع بيانات محدد بدلاً من نوع بيانات افتراضي. على سبيل المثال، استخدم CCur لفرض حساب العملة في الحالات التي يتم فيها استخدام الدقة المفردة أو الدقة المزدوجة أو حساب الأعداد الصحيحة بشكل طبيعي.

يجب أن تستخدم دالات تحويل أنواع البيانات بدلاً من Val لتوفير عمليات التحويل المتعارف عليها دولياً من أحد أنواع البيانات إلى الآخر. على سبيل المثال، عند استخدام CCur، يتم التعرف على فواصل عشرية مختلفة وفواصل آلاف مختلفة وخيارات عملة متنوعة استناداً إلى الإعدادات المحلية لجهاز الكمبيوتر الخاص بك.

عندما يكون الجزء الكسري يساوي 0.5 بالضبط، فتقوم دومًا الدالة CInt وCLng بتقريبه إلى أقرب رقم زوجي. على سبيل المثال، يتم تقريب 0.5 إلى 0 وتقريب 1.5 إلى 2. وتختلف الدالة CInt وCLng عن Fix وInt التي تقوم باقتطاع جزء من الدالة بدلاً من تقريبها إلى الجزء الكسري للرقم. وتقوم أيضًا الدالة Fix وInt بإرجاع قيمة من نفس النوع عند تمريره.

استخدم الدالة IsDate لتحديد إذا ما كان من الممكن تحويل date إلى تاريخ أو وقت. تتعرف الدالة CDate على أحرف التواريخ وأحرف الأوقات بالإضافة إلى بعض الأرقام التي تقع داخل نطاق التواريخ المقبولة. عند تحويل رقم إلى تاريخ، يتم تحويل جزء الرقم بالكامل إلى تاريخ. ويتم تحويل أي جزء كسري من الرقم إلى وقت من يوم، بدءًا من منتصف الليل.

تتعرف CDate على تنسيقات التاريخ وفقًا لـ الإعدادات المحلية للنظام. قد لا يتم تحديد الترتيب الصحيح لليوم والشهر والسنة إذا تم توفيره بتنسيق مختلف عن إعدادات التاريخ المعروفة. بالإضافة إلى ذلك، لا يتم التعرف على تنسيق التاريخ الطويل إذا كان يتضمن أيضًا سلسلة يوم من الأسبوع.

يتم أيضًا توفير الدالة CVDate للتوافق مع الإصدارات السابقة من Visual Basic. ويكون بناء الدالة CVDate مماثل لبناء جملة دالة CDate، ولكن تقوم CVDate بإرجاع Variant (متغير) يكون نوعه الفرعي هو Date (تاريخ) بدلاً من النوع الفعلي Date (تاريخ). وحيث إنه يوجد الآن نوع Date (تاريخ) مضمن، فلا تحتاج إلى CVDate بعد ذلك. يمكن الحصول على نفس التأثير بواسطة تحويل تعبير إلى Date (تاريخ)، ثم تعيينه إلى Variant (متغير). يكون هذا الأسلوب ثابتًا مع تحويل كافة الأنواع المضمنة الأخرى إلى الأنواع الفرعية المكافئة لها في Variant (متغير).

ملاحظة: لا تقوم الدالة CDec بإرجاع نوع بيانات منفصل، ولكن بدلاً من ذلك، تقوم دومًا بإرجاع متغير تم تحويل قيمته إلى النوع الفرعي عشري.

أمثلة

ملاحظة: توضح الأمثلة التالية استخدام هذه الدالة في وحدة نمطية لـ Visual Basic for Applications (VBA). لمزيد من المعلومات حول استخدام VBA، حدد مرجع المطور في القائمة المنسدلة بجوار بحث وأدخل مصطلح أو أكثر في مربع البحث.

الدالة CBool

تلميح: يساعد "منشئ التعبير" ب# استخدام IntelliSense التي تبدا في Access 2010 في الحصول علي تعبيرات المناسبه.

يستخدم هذا المثال الدالة CBool لتحويل تعبير إلى قيمة منطقية. إذا كان التعبير ذو قيمة غير صفرية، تقوم CBool بإرجاع True، وإلا تقوم بإرجاع False.

Dim A, B, Check
A = 5: B = 5 ' Initialize variables.
Check = CBool(A = B) ' Check contains True.
A = 0 ' Define variable.
Check = CBool(A) ' Check contains False.

الدالة CByte

يستخدم هذا المثال الدالة CByte لتحويل تعبير إلى نوع بيانات بايت.

Dim MyDouble, MyByte
MyDouble = 125.5678 ' MyDouble is a Double.
MyByte = CByte(MyDouble) ' MyByte contains 126.

الدالة CCur

يستخدم هذا المثال الدالة CCur لتحويل تعبير إلى عملة.

Dim MyDouble, MyCurr
MyDouble = 543.214588 ' MyDouble is a Double.
MyCurr = CCur(MyDouble * 2)
' Convert result of MyDouble * 2 (1086.429176) to a
' Currency (1086.4292).

الدالة CDate

يستخدم هذا المثال الدالة CDate لتحويل سلسلة أحرف إلى تاريخ. بشكل عام لا يوصى باستخدام التواريخ والأوقات ذات التعليمات البرمجية المعقدة كسلاسل الأحرف (كما هو موضح في هذا المثال). استخدم بدلاً من ذلك أحرف التاريخ وأحرف الوقت، مثل #2/12/1969# و#4:45:23 PM#.

Dim MyDate, MyShortDate, MyTime, MyShortTime
MyDate = "February 12, 1969"
' Convert to Date data type.
MyShortDate = CDate(MyDate)
MyTime = "4:35:47 PM"
' Convert to Date data type.
MyShortTime = CDate(MyTime)

الدالة CDbl

يستخدم هذا المثال الدالة CDbl لتحويل تعبير إلى نوع بيانات مزدوج.

Dim MyCurr, MyDouble
MyCurr = CCur(234.456784)
' Convert result to a Double.
MyDouble = CDbl(MyCurr * 8.2 * 0.01)

الدالة CDec

يستخدم هذا المثال الدالة CDec لتحويل قيمة رقمية إلى قيمة عشرية.

Dim MyDecimal, MyCurr
MyCurr = 10000000.0587 ' MyCurr is a Currency.
MyDecimal = CDec(MyCurr) ' MyDecimal is a Decimal.

الدالة CInt

يستخدم هذا المثال الدالة CInt لتحويل قيمة إلى عدد صحيح.

Dim MyDouble, MyInt
MyDouble = 2345.5678 ' MyDouble is a Double.
MyInt = CInt(MyDouble) ' MyInt contains 2346.

الدالة CLng

يستخدم هذا المثال الدالة CLng لتحويل قيمة إلى نوع بيانات طويل.

Dim MyVal1, MyVal2, MyLong1, MyLong2
MyVal1 = 25427.45
MyVal2 = 25427.55 ' MyVal1, MyVal2 are Doubles.
MyLong1 = CLng(MyVal1)
' MyLong1 contains 25427.
MyLong2 = CLng(MyVal2)
' MyLong2 contains 25428.

الدالة CSng

يستخدم هذا المثال الدالة CSng لتحويل قيمة إلى نوع بيانات مفرد.

Dim MyDouble1, MyDouble2, MySingle1, MySingle2
' MyDouble1, MyDouble2 are Doubles.
MyDouble1 = 75.3421115: MyDouble2 = 75.3421555
MySingle1 = CSng(MyDouble1)
' MySingle1 contains 75.34211.
MySingle2 = CSng(MyDouble2)
' MySingle2 contains 75.34216.

الدالة CStr

يستخدم هذا المثال الدالة CStr لتحويل قيمة رقمية إلى نوع بيانات مفرد.

Dim MyDouble, MyString
MyDouble = 437.324 ' MyDouble is a Double.
MyString = CStr(MyDouble)
' MyString contains "437.324".

الدالة CVar

يستخدم هذا المثال الدالة CVar لتحويل تعبير إلى نوع بيانات متغير.

Dim MyInt, MyVar
MyInt = 4534 ' MyInt is an Integer.
MyVar = CVar(MyInt & "000")
' MyVar contains the string 4534000.

ملاحظة: إقرار إخلاء المسؤولية للترجمة الآلية: تمت ترجمة هذه المقالة بواسطة نظام كمبيوتر دون تدخل العامل البشري. توفر Microsoft هذه الترجمات الآلية لمساعدة المستخدمين الذين لا يتحدثون الإنجليزية على استخدام منتجات Microsoft، وخدماتها، وتقنياتها والاستمتاع بها. قد تحتوي هذه المقالة على أخطاء في المفردات، أو بناء الجملة، أو القواعد نظرًا لترجمتها آليًا.

مشاركة Facebook Facebook Twitter Twitter البريد الإلكتروني البريد الإلكتروني

هل كانت المعلومات مفيدة؟

رائع! هل لديك أي ملاحظات أخرى؟

كيف يمكننا تحسين ذلك؟

نشكرك على ملاحظاتك!

×