الفرق بين المراجعتين لصفحة: «Sass/function exists»

مراجعة 11:14، 8 مايو 2018

تتحقَّق الدالة function_exists()‎ إذا كانت دالةٌ ما موجودةً أم لا.

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

function_exists($name)

المعاملات

`‎$name`

اسم أو مرجع الدالة المراد التحقُّق من وجودها.

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

تُعاد القيمة المنطقيَّة TRUE إذا كانت الدالة مُعرّفةً. خلا ذلك، تُعاد القيمة FALSE.

أمثلة

مثال عن استخدام الدالة function_exists()‎ لمعرفة إن كانت الدالة myfunc التي عرّفها المستخدم موجودةً أم لا:

// تعريف الدالة myfunc
@function myfunc() { @return "something"; }

@if function_exists(myfunc) {
  @debug "myfunc exists!";
}

يمكن أيضًا استخدام الدالة function_exists()‎. لمعرفة إن كانت الدالة content_exists()‎ متوافرةً أم لا (أضيفت هذه الدالة في الإصدار 3.5 من Sass). لاحظ استخدام التعليمة ‎@warn و ‎@debug:

@if function_exists(content_exists) {
  @debug "You can use content_exists()";
} @else {
  @warn "Upgrade Sass compiler";
}

ستخرج الشيفرة السابقة الناتج الآتي عند تصريفها بمصرّف Sass ذي إصدارٍ أقل من 3.5 (الإصدار الذي أُضيفتَ فيه الدالة content_exists()‎):

WARNING: Upgrade Sass compiler
         on line 4 of style.scss

وستخرج الناتج الآتي عند تصريفها بمصرِّف Sass حديث:

style.scss:2 DEBUG: You can use content_exists()

انظر أيضًا

الدالة global_variable_exists()‎: تتحقَّق ما إذا كان متغير ما موجود في النطاق العام.
الدالة feature_exists()‎: تتحقَّق ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل Sass.
الدالة mixin_exists()‎: تتحقَّق ما إذا كان مخلوط ما موجودًا.

مصادر

قسم الدالة function_exists في صفحة الدوال في توثيق Sass الرسمي.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>()function_exists</code> في Sass}}</noinclude>
-تتحقَّق الدالة <code>function_exists()‎</code> إذا كانت دالة ما موجودةً أم لا.
+تتحقَّق الدالة <code>function_exists()‎</code> إذا كانت دالةٌ ما موجودةً أم لا.
 == البنية العامة ==
@@ سطر 16: / سطر 16: @@
 ==  أمثلة ==
-المثال 1: استخدام الدالة <code>function_exists()‎</code>.<syntaxhighlight lang="sass">
+مثال عن استخدام الدالة <code>function_exists()‎</code> لمعرفة إن كانت [[Sass/function directives|الدالة <code>myfunc</code> التي عرّفها المستخدم]] موجودةً أم لا:<syntaxhighlight lang="sass">
-function-exists(lighten) // true
+// تعريف الدالة myfunc
+@function myfunc() { @return "something"; }
-@function myfunc { @return "something"; }
+@if function_exists(myfunc) {
-function-exists(myfunc) // true
+  @debug "myfunc exists!";
+}
+</syntaxhighlight>يمكن أيضًا استخدام الدالة <code>function_exists()‎</code>. لمعرفة إن كانت الدالة <code>[[Sass/content exists|content_exists()‎]]</code> متوافرةً أم لا (أضيفت هذه الدالة في الإصدار 3.5 من Sass). لاحظ استخدام التعليمة ‎<code>[[Sass/@ rules#.D8.A7.D9.84.D8.AA.D8.B9.D9.84.D9.8A.D9.85.D8.A9 .E2.80.8E.40warn|@warn]]</code> و <code>‎[[Sass/@ rules#.D8.A7.D9.84.D8.AA.D8.B9.D9.84.D9.8A.D9.85.D8.A9 .E2.80.8E.40debug|@debug]]</code>:<syntaxhighlight lang="sass">
+@if function_exists(content_exists) {
+  @debug "You can use content_exists()";
+} @else {
+  @warn "Upgrade Sass compiler";
+}
+</syntaxhighlight>ستخرج الشيفرة السابقة الناتج الآتي عند تصريفها بمصرّف Sass ذي إصدارٍ أقل من 3.5 (الإصدار الذي أُضيفتَ فيه الدالة <code>[[Sass/content exists|content_exists()‎]]</code>):<syntaxhighlight lang="text">
+WARNING: Upgrade Sass compiler
+         on line 4 of style.scss
+</syntaxhighlight>وستخرج الناتج الآتي عند تصريفها بمصرِّف Sass حديث:<syntaxhighlight lang="text">
+style.scss:2 DEBUG: You can use content_exists()
 </syntaxhighlight>
-== انظر أيضًا ==
+== <span> </span>انظر أيضًا ==
 * الدالة <code>[[Sass/global variable exists|global_variable_exists()]]</code>‎: تتحقَّق ما إذا كان متغير ما موجود في النطاق العام.
 * الدالة <code>[[Sass/feature exists|feature_exists()]]</code>‎: تتحقَّق ما إذا كانت ميزة معينةٌ موجودةٌ في وقت تشغيل <code>[[Sass]]</code>.