هل الدوال

تُعرف هذه Isالدوال (المعروفة أيضًا بدوال معلومات البيانات ، ^{[ 5 ]} أو دوال فحص البيانات ، ^{[ 6 ]} أو دوال اختبار البيانات ^{[ 6 ]} ) بأنها مجموعة من الدوال في لغات البرمجة التالية : Visual Basic 6 و Visual Basic for Applications و VBScript و Visual Basic .NET من مايكروسوفت . كما يُوفر موفر بيانات .NET Framework لخادم Microsoft SQL Server عددًا منها في لغة Transact-SQL .

هذه الدوال هي دوال بسيطة للتحقق من صحة البيانات وأنواعها. تحدد دوال التحقق من صحة البيانات ما إذا كان من الممكن تحويل قيمة البيانات المُمرَّرة كوسيط للدالة إلى النوع المُشار إليه في اسم الدالة، وتُعيد Booleanقيمة تُسجِّل ما إذا كان التحويل ممكنًا أم لا. (لاحظ أن دوال تحويل البيانات الفعلية، مثل `if`، Oct()تُطلق استثناءات في حال تعذُّر التحويل. تسمح دوال التحقق من الصحة باختبار ما إذا كان التحويل سيفشل ، وتغيير مسار تنفيذ البرنامج في عبارة `if` ). Trueيشير `if` إلى إمكانية التحويل، Falseبينما يشير `if` إلى عدم إمكانية التحويل. وبالمثل، تُعيد دوال التحقق من النوع قيمة Booleanتُسجِّل ما إذا كان تعبير الوسيط من نوع مُحدد.

في لغة Transact-SQL، تُرجع الدوال صفرًا أو واحدًا بدلاً من Booleanالقيم Trueو False.

IsArray(name)

تُحدد هذه الدالة ما إذا كان اسم المتغير المُمرر كوسيط لها عبارة عن مصفوفة. تجدر الإشارة إلى أن المصفوفات غير المُهيأة ستُعاد Falseمن هذه الدالة في Visual Basic .NET. ^{[ 7 ]} في Visual Basic 6، لا تُعتبر المصفوفات أنواعًا مرجعية، وستُعاد المصفوفة غير المُهيأة Trueمن هذه الدالة تمامًا كما تُعاد المصفوفة المُهيأة. ^{[ 8 ]}

IsDate(expression)

تُحدد هذه الدالة ما إذا كان التعبير المُمرر كوسيط لها قابلاً للتحويل إلى متغير من النوع Date، أو أنه بالفعل من النوع Date. يمكن بالطبع تحويل المتغيرات غير المُهيأة من النوع ، على الرغم من كونها غير مُهيأة، لذا ستُرجع هذه الدالة دائمًا قيمة خاطئة لهذه المتغيرات. ^{[ 9 ]} لاحظ أن السلاسل النصية التي تحتوي على يوم من أيام الأسبوع بالإضافة إلى تاريخ (مثل ) ستُرجع نتيجة فشل. ^{[ 10 ]} في VBScript وVisual Basic .NET، تستخدم عملية التحويل إعدادات اللغة في Microsoft Windows، مما يعني أن ما قد يُحلل كتاريخ على نظام مُهيأ لاستخدام لغة معينة، قد لا يُحلل كتاريخ على نظام آخر مُهيأ لاستخدام لغة مختلفة. ^{[ 11 ] [ 12 ]}DateTrue"Sat, October 12, 2010"

IsDBNull(expression)

تحدد هذه الدالة ما إذا كان التعبير المُمرر كوسيط لها يُقيّم إلى System.DBNull.Value. ^{[ 9 ]} وهذا يُعادل IsNull()دالة Visual Basic 6. ^{[ 10 ]} لاحظ أنه لا يُمكن مُقارنة تعبيرٍ ما مُباشرةً للتحقق من مُساواته مع System.DBNull، لأن أي تعبيرٍ من الشكل x = DbNullسيُقيّم إلى DbNullببساطة لاحتوائه على قيمة فارغة. IsDBNull()هي الطريقة الوحيدة لاختبار المُساواة مع System.DBNull. ^{[ 12 ]}

IsEmpty(expression)

تُحدد هذه الدالة ما إذا كان التعبير المُمرر كوسيط لها متغيرًا غير مُهيأ. تجدر الإشارة إلى أن المتغير غير المُهيأ يختلف عن المتغير الذي تم تهيئته لاحتواء قيمة معينة Null. ^{[ 13 ]} على الرغم من أن الدالة تأخذ تعبيرًا، وليس مجرد اسم متغير، فإن أي تعبير ليس مجرد اسم متغير يُعتبر غير مُهيأ. ^{[ 11 ]} كانت هذه الدالة متاحة في Visual Basic 6، ولكن تم استبدالها في Visual Basic .NET بالدالة ^{[ 14 ]}IsNothing() . في VBScript، إذا تم تعيين قيمة لمتغير ، فإن هذه الدالة لا تزال تُرجع قيمة معينة . ^{[ 15 ]}NothingFalse

IsError(expression)

تحدد هذه الدالة، في لغة Visual Basic .NET، ما إذا كان التعبير المُمرر كوسيط لها كائنًا استثنائيًا، أي كائنًا من System.Exceptionالفئة أو إحدى فئاتها الفرعية. ^{[ 7 ]} في Visual Basic 6، تختبر الدالة ما إذا كان التعبير متغيرًا من vbErrorالنوع الفرعي الخاص. ^{[ 16 ]}

IsMissing(name)

تُحدد هذه الدالة ما إذا كان اسم المتغير المُمرر كوسيط لها وسيطًا اختياريًا لم يُمرر إلى الدالة من قِبل مُستدعيها. وتُرجع الدالة Trueقيمة فارغة فقط إذا كان المتغير متغيرًا لم تتم تهيئته. هذه الدالة موجودة فقط في Visual Basic 6. أما في Visual Basic .NET، فيجب أن تحتوي المعاملات الاختيارية على مُهيئات افتراضية، وبالتالي لم تعد هذه الدالة موجودة. ^{[ 17 ]}

IsNothing(expression)

تحدد هذه الدالة ما إذا كان التعبير المُمرر كوسيط لها يُقيّم إلى Nothing. ^{[ 9 ]} وهي دالة مكتبة بسيطة (تتألف من 4 تعليمات CIL فقط ) يمكن كتابتها في Visual Basic على النحو التالي: ^{[ 18 ] [ 19 ]}

دالة عامة مشتركة IsNothing ( ByVal Expression As Object ) As Boolean Return ( Expression Is Nothing ) End Function

يؤدي هذا إلى إرجاع Falseقيمة فارغة لجميع تعابير القيمة (غير المرجعية)، لأنها ستُغلّف، كجزء من استدعاء الدالة، في كائنات، والتي بطبيعتها لن تكون كائنات فارغة. ^{[ 18 ] [ 19 ]} لتجنب هذا السلوك، يمكن استخدام ISعامل المقارنة لمقارنة كائن مباشرةً بنوع مرجعي Nothing، بكتابة `null` بدلاً من `null` . سيُصدر المُصرّف خطأً أثناء وقت الترجمة إذا كان التعبير المُقارن قيمةً وليس نوعًا مرجعيًا، مُكتشفًا عدم تطابق النوع أثناء الترجمة بدلاً من إرجاع القيمة الفارغة أثناء وقت التشغيل. ^{[ 20 ]} تُعتبر السلاسل النصية أنواعًا مرجعية في Visual Basic .NET، وبالتالي يُمكن أن تكون فارغة (على عكس السلاسل النصية الفارغة تمامًا). بالنسبة لهذه السلاسل النصية، تُرجع هذه الدالة `null` . (أما بالنسبة للسلاسل النصية الفارغة، فتُرجع `null` ). ^{[ 21 ] [ 18 ]}expression IS NothingIsNothing(expression)FalseTrueFalse

IsNull(expression)

تحدد هذه الدالة ما إذا كان التعبير المُمرر كوسيط لها يُقيّم إلى قيمة فارغة Null. القيمة الفارغة في أي تعبير فرعي من التعبير تجعل التعبير بأكمله يُعتبر فارغًا. ^{[ 15 ]}

IsNull(expression1,expression2)

هذه الدالة، التي تأخذ وسيطين، خاصة بلغة Transact-SQL. على عكس دالة Visual Basic التي تحمل نفس الاسم، فهي لا تُرجع قيمة فارغة Boolean، بل تُرجع التعبير الأول إذا لم يكن فارغًا NULL، وإلا تُرجع التعبير الثاني. ^{[ 22 ]} الغرض من هذه الدالة هو استبدال أي NULLقيم بقيمة أخرى، يُفترض (ولكن ليس شرطًا) أنها غير فارغة NULL. ^{[ 23 ]} وهي نسخة ذات وسيطين من الدالة COALESCE().

IsNumeric(expression)

تُحدد هذه الدالة ما إذا كان بالإمكان تحويل التعبير المُمرر كوسيط لها إلى رقم (سواء كان حرفًا Shortأو Integerسلسلة نصية Longأو رقمًا Singleأو رقمًا Doubleأو Decimalرقمًا) من حرف أو سلسلة نصية، أو ما إذا كان رقمًا بالفعل. ^{[ 24 ] [ 25 ]} في لغة Transact-SQL، يمكن تحويل السلاسل النصية إلى أرقام حتى لو احتوت على أحرف غير متوقعة في الأرقام. وذلك لأن Transact-SQL تسمح بالتحويل من أنواع البيانات moneyالمختلفة smallmoneyإلى أرقام، وقد تحتوي البيانات النقدية في شكل سلسلة نصية على رموز مؤشرات العملة مثل الرمزين ' £' أو ' $'. ^{[ 26 ]} وينطبق الأمر نفسه على VBScript، حيث تُعتبر أي سلسلة نصية يمكن تحويلها إلى قيمة عملة في اللغة المحلية الحالية سلسلة نصية رقمية. مع ذلك، لا تعتبر VBScript التواريخ والأوقات سلاسل نصية رقمية. ^{[ 27 ]}

IsObject(expression)

تحدد هذه الدالة ما إذا كان التعبير المُمرر كوسيط لها كائنًا أم قيمة. ^{[ 4 ]} وهذا يُعادل IsReference()دالة Visual Basic .NET. ^{[ 10 ]}

IsReference(expression)

تحدد هذه الدالة ما إذا كان التعبير المُمرر كوسيط لها مرجعًا أم قيمة. ^{[ 24 ]} وهذا يُعادل IsObject()دالة Visual Basic 6. ^{[ 10 ]}