دالات تحويل أنواع البيانات
يطبق على:
Microsoft Office Access 2007
طباعة
إظهار الكل
إخفاء الكل
تفرض كل دالة
تعبيرًا (تعبير: أية تركيبة من عوامل التشغيل الرياضية أو المنطقية، والثوابت، والدالات، وأسماء الحقول، وعناصر التحكم، والخصائص التي تنتج قيمة واحدة. يمكن للتعابير إنجاز الحسابات، أو معالجة الأحرف، أو فحص البيانات.) على
نوع بيانات (نوع البيانات: صفات الحقل التي تحدد نوع البيانات التي يمكنها التواجد فيه. وتتضمن أنواع البيانات منطقي، وعدد صحيح، وعدد صحيح طويل، وعملة، ومفرد، ومزدوج، وتاريخ، وسلسلة، ومتغير (افتراضي).) محدد.
بناء الجملة
CBool(expression)
CByte(expression)
CCur(expression)
CDate(expression)
CDbl(expression)
CDec(expression)
CInt(expression)
CLng(expression)
CSng(expression)
CStr(expression)
CVar(expression)
إن وسيطة
expression المطلوبة (وسيطة: قيمة توفّر معلومات لإجراء ما، أو حدث، أو أسلوب، أو خاصية، أو دالة، أو برنامج جزئي.) هي أي
تعبير سلسلة أحرف (تعبير سلسلة: أي تعبير يقيّم إلى تتابع من الأحرف المتتالية. ويمكن لعناصر التعبير أن تتضمن: دالات تُرجع سلسلة أو سلسلة Variant (VarType 8)؛ سلسلة أحرف، أو ثابت، أو متغير، أو Variant.) أو
تعبير رقمي (تعبير رقمي: أي تعبير يقّيم إلى رقم. ويمكن للتعبير أن يضم أية تركيبة من المتغيرات، والثوابت، والدالات، وعوامل التشغيل.).
أنواع الإرجاع
يحدد اسم الدالة نوع الإرجاع كما هو موضح في ما يلي:
الوظيفةنوع الإرجاعنطاق لوسيطة expressionCBoolمنطقي أي تعبير
سلسلة أحرف أو تعبير رقمي صحيح.
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
يستخدم هذا المثال الدالة
CBool لتحويل تعبير إلى قيمة
منطقية. إذا كان التعبير ذو قيمة غير صفرية، تقوم
CBool بإرجاع
True، وإلا تقوم بإرجاع
False.
Dim A, B, CheckA = 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, MyByteMyDouble = 125.5678 ' MyDouble is a Double.MyByte =
CByte(MyDouble
) ' MyByte contains 126.
الدالة CCur
يستخدم هذا المثال الدالة
CCur لتحويل تعبير إلى
عملة.
Dim MyDouble, MyCurrMyDouble = 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, MyShortTimeMyDate = "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, MyDoubleMyCurr = CCur(234.456784)' Convert result to a Double.MyDouble =
CDbl(MyCurr * 8.2 * 0.01
) الدالة CDec
يستخدم هذا المثال الدالة
CDec لتحويل قيمة رقمية إلى قيمة
عشرية.
Dim MyDecimal, MyCurrMyCurr = 10000000.0587 ' MyCurr is a Currency.MyDecimal =
CDec(MyCurr
) ' MyDecimal is a Decimal.
الدالة CInt
يستخدم هذا المثال الدالة
CInt لتحويل قيمة إلى
عدد صحيح.
Dim MyDouble, MyIntMyDouble = 2345.5678 ' MyDouble is a Double.MyInt =
CInt(MyDouble
) ' MyInt contains 2346.
الدالة CLng
يستخدم هذا المثال الدالة
CLng لتحويل قيمة إلى
نوع بيانات طويل.
Dim MyVal1, MyVal2, MyLong1, MyLong2MyVal1 = 25427.45MyVal2 = 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.3421555MySingle1 =
CSng(MyDouble1
)' MySingle1 contains 75.34211.MySingle2 =
CSng(MyDouble2
)' MySingle2 contains 75.34216.
الدالة CStr
يستخدم هذا المثال الدالة
CStr لتحويل قيمة رقمية إلى
نوع بيانات مفرد.
Dim MyDouble, MyStringMyDouble = 437.324 ' MyDouble is a Double.MyString =
CStr(MyDouble
)' MyString contains "437.324".
الدالة CVar
يستخدم هذا المثال الدالة
CVar لتحويل تعبير إلى نوع بيانات
متغير.
Dim MyInt, MyVarMyInt = 4534 ' MyInt is an Integer.MyVar =
CVar(MyInt & "000"
) ' MyVar contains the string 4534000.