دوال جديدة تحتاج إلى شرح جديد

[alsohba]

السلام عليكم ورحمة الله وبركاته ..

يا أخواني أحتاج مساعدتكم في شرح بعض الـ(Functions) الجديدة علي ..
أتمنى من ذوي الخبرة شرحها شرح وافي .. مع بعض الأمثلة إذا تكرمتوا ..
آنة لقيت هذي الـ(Functions) في بعض المواقع و حاولت أدور لها على شرح لكن كل الشرح إلي حصلته باللغة الإنجليزية .. و مثل ما يقول المثل : عمك أصمخ !! لأني ما أفهم بالإنجليزي .. طقطقنا و ما فهمنا .. أتمنى إني ألقا عندكم شرح وافي و جيد .. وهذي هي الـ(Functions)..

show_word(); show_that(); show_would(); show_be(); show_a(); show_fun(); show_way(); show_to(); show_program();

[Pal Coder]

اخي الكريم هذه الدوال ليست دوال جاهزة انما هي من صنع اصحاب المواقع او كتابها ، المواقع التي وجدت بها هذه الدوال

وللتأكد من اي دالة

ما عليك الا

php.net/function name

[alsohba]

شكرا على مرورك أخي pal coder لكني نسيت أني أضع الفنكشن كاملة و هذي هي كاملة إنشاء الله للـ(show_word )

[QUOTE]function show_word($note)
{
$w = explode(' ', $note);
print join(' ',array_slice($w, 0, ceil(count($w) / 2)));
}

[القائد]

هذه الدالة معرفة بواسطة صاحب الموقع أو المبرمج اي انها ليست دالة اساسية في لغة PHP

سأشرح لك هذه الدالة وطريقة عملها

function show_word($note)
{
$w = explode(' ', $note);
print join(' ',array_slice($w, 0, ceil(count($w) / 2)));
} 

تعيد هذه الدالة (نصف عدد الكلمات) المرسلة إليها ... النصف الأول تحديدا ...

تأخذ هذه الدالة متغيرا أو وسيطا واحدا وهي النص المراد اقتطاعه..

$w = explode(' ', $note); 

البداية يتم فصل النص الكبير إلى مصفوفة يحوي كل عنصر فيها على كلمة من كلمات االنص
وذلك بإستخدام دالة explode
وتسند المصفوفة إلى المتغير $w


يتم جمع عناصر المصفوفة من جديد بإستخدام الدالة join وتحديد العناصر الأولى فقط والتي تبدأ من العنصر الأول وصولا إلى العنصر الذي يحمل الرقم (count($w)/2) حيث أن قيمة count($w) تساوي عدد العناصر



اتمنى ان اكون قد وفقت في الشرح

[alsohba]

مشكوووووور أخي الكريم القائد .. ولكن .. أحتاج إلى أمثلة يعني 3 كحد أدنى إذا أمكن حتى أني أستوعب الفنكشن .. لأني بالأساس ما أعرف أسوي أو أفهم الفنكشن من غير أمثلة .. و يا ريت اتبين لي شنو إهي المتغيرات الداخلة للدالة و الخارجا منها .. و أكون شاكر لك صنيعك هذا و ما راح أنساه أبداً ..

[القائد]

لا مشكلة عزيزي ...

سأستخدم كلماتك انت في شرح المثال ..:

مشكوووووور أخي الكريم القائد .. ولكن .. أحتاج إلى أمثلة يعني 3 كحد أدنى إذا أمكن حتى أني أستوعب الفنكشن .. لأني بالأساس ما أعرف أسوي أو أفهم الفنكشن من غير أمثلة

حسنا .. لديك هذا النص الموجود في الأعلى .. لكنك تريد نصفه فقط ..
قم بعد كلمات النص .. ستجدها 32 كلمة (متضمنة الرقم [3] والنقاط المتتالية [..])

اول شيء نسند هذا النص إلى متغير لنسهل التعامل به ..

$word = "مشكوووووور أخي الكريم القائد .. ولكن .. أحتاج إلى أمثلة يعني 3 كحد أدنى إذا أمكن حتى أني أستوعب الفنكشن .. لأني بالأساس ما أعرف أسوي أو أفهم الفنكشن من غير أمثلة "; 

الآن نستخدم الدالة التي تم تعريفها من قبلنا (يجب ادراجها قبل استعمالها طبعا):

function show_word($note) 
{ 
$w = explode(' ', $note); 
print join(' ',array_slice($w, 0, ceil(count($w) / 2))); 
} 

سنقوم الآن بإستدعاء الدالة وتطبيقها على النص :

show_word($word); 

سيصبح لدينا ملف php بهذا الشكل:

<?php
$word = "مشكوووووور أخي الكريم القائد .. ولكن .. أحتاج إلى أمثلة يعني 3 كحد أدنى إذا أمكن حتى أني أستوعب الفنكشن .. لأني بالأساس ما أعرف أسوي أو أفهم الفنكشن من غير أمثلة ";

function show_word($note) 
{ 
$w = explode(' ', $note); 
print join(' ',array_slice($w, 0, ceil(count($w) / 2))); 
}

show_word($word);
?>

جرب تشغيل هذا الملف .. ماذا تلاحظ؟

ستجد ان المستعرض قد طبع لك

مشكوووووور أخي الكريم القائد .. ولكن .. أحتاج إلى أمثلة يعني 3 كحد أدنى إذا أمكن

لو قمت بعد الكلمات ستجد انها 16 .. اي نصف عدد النص الاصلي


هل تريد مني أن آخذك في رحلة داخل الدالة واشرك لك طريقة عملها من الداخل؟

[alsohba]

مشكوووووووووووور جدا جدا أخي القائد الكبير ..
شرح وافي جدا جدا .. و أنا أقبل عرضك في الجولة إذا كان ما في تكلفة عليك .. الله يعافيك ..

لكن طرأ علي سؤال بعد ما شفت الناتج الرائع .. هل من الممكن إني أحدد عدد الكلمات التي تعرض لليوزر ؟؟

يعني مثلاً إذا كان المتغير $wosr هو نفسة الذي أدخلناه سابقاَ

$word = "مشكوووووور أخي الكريم القائد .. ولكن .. أحتاج إلى أمثلة يعني 3 كحد أدنى إذا أمكن حتى أني أستوعب الفنكشن .. لأني بالأساس ما أعرف أسوي أو أفهم الفنكشن من غير أمثلة ";

و أريد أن أخرج لليوزر أول 10 كلمات فيكون الخارج من الدالة هو " مشكوووووور أخي الكريم القائد .. ولكن .. أحتاج إلى أمثلة " و بس .. هل من الممكن هذا ؟؟

[القائد]

بالنسبة لسؤالك الثاني حول امكانية تحديد عدد الكلمات فالجواب نعم ....

كيف؟؟؟

هذا يعتمد على طريقة عمل الفانكشن ...

تابع معي هذا الشرح:

لدينا هذه الدالة المعرفة من قبلنا :

function show_word($note) 
{ 
$w = explode(' ', $note); 
print join(' ',array_slice($w, 0, ceil(count($w) / 2))); 
} 

حتى نتمكن من تعديلها بما يتوافق مع حاجاتنا يجب علينا في البداية ان نفهم اداء الدالة من الداخل ..

الخطوة الأولى هي معرفة دوال php الأساسية المستخدمة في هذه الدالة ....
الدوال الأساسية هي:

explode
join
array_slice
ceil
count
print 

بداية يجب ان نعرف وظيفة كل دالة من هذه الدوال وأيضا نعرف معاملات كل دالة

explode : هذه الدالة مهمتها هي انتاج مصفوفة array عبر قسمة أو كسر جملة محرفية ...
وهي تأخذ معاملين .. الأول قيمة محرفية التي سيتم تقسيم النص عند الوصول إليها .. والثاني هي الجملة او النص التي سيتم تقسيمه ..
في مثالنا تجد أننا قما بقسمة النص إعتمادا على ' ' أي على الفراغات .. فأصبحت كل كلمة بالتالي تشكل عنصرا واحدا في المصفوفة ...
مثال آخر:

$test = "this/is/a/test/only";
$test1 = explode("/" , "this/is/a/test/only");
print_r($test1); 

ستكون نتيجة هذا المثال عبارة عن مصفوفة بها 5 عناصر كل عنصر يحوي احدى كلمات النص .. لاحظ أن "/" لن تعود موجودة في المصفوفة لأنها كانت القيمة المحرفية التي اعتمدنا عليها في التقطيع ...

join : وهي على النقيض من explode تماما .. تقوم هذه الدالة بوضع عناصر المصفوفة في جملة محرفية واحدة ... وتفصل بين كل عنصر والذي يليه بقيمة نحددها نحن ..
مثال :

$test = array('I', 'love', 'my', 'country');
$test1 = join(' ', $test);
echo $test1; 

سيكون الناتج "I love my country"
لاحظ اننا في المعامل الاول للدالة join استخدمنا ' ' والتي تعني وضع مسافة فارغة بين العبارات

ceil : هذه الدالة العدد الصحيح التالي للقيمة الرقمية المدخلة وهي تأخذ معاملا واحدا هو القيمة العدديدة المراد معرفة اقرب رقم صحيح تالي لها
مثلا عند استخدام هذا الكود

echo ceil(10); 

سيكون الناتج 10
لكن عند استخدام

echo ceil(10.1); 

سيكون الناتج 11
هذه الدالة تفيد عندما لا نرغب في الحصول على كسور في نواتج الجمع والقسمة والضرب وغيرها

count : تقوم بعد عناصر المصفوفة وتأخذ معاملا واحدا هو إسم المصفوفة

$array= array('I', 'love', 'my', 'country');
echo count($array); 

الناتج = 4

array_slice : تقوم هذه الدالة بإعادة دالة تحوي على عدد معين من عناصر دالة أخرى ...
وهي تأخذ اربعة معاملات .. اثنان الزاميتان والباقي اختيارية .. المعاملات هي:
1 / المصفوفة التي سيتم الاجتزاء منها
2 / رقم العنصر الذي سيتم بدء الاجتزاء منه
3 / عدد العناصر التي سيتم الاجتزاؤها
4 / قيمة trueأو false تحدد اذا كنا نرغب في اعادة ترتيب فهارس المصفوفة الجديدة..
اذا لم نضع قيمة لعدد العغناصر فإنه سيتم وضع جميع العناصر التي تلي العنصر المحدد بالرقم 2
مثال:

$input = array("a", "b", "c", "d", "e");

$output = array_slice($input, 2);      // ستعيد "c", "d", "e" في مصفوفة $output 
$output = array_slice($input, 2, 2);  // ستعيد "d"  في مصفوفة $output 
$output = array_slice($input, 0, 3);  // returns "a", "b", and "c"  في مصفوفة $output 

الآن لدينا هذه الدالة:

function show_word($note) 
{ 
$w = explode(' ', $note); 
print join(' ',array_slice($w, 0, ceil(count($w) / 2))); 
} 

هذه الدالة تأخذ معاملا واحدا هو النص الذي نريد نصفه ..
نقوم بإنشاء المصفوفة $w التي ستحوي كلمات النص

$w = explode(' ', $note); 

ثم سنقوم بعد عناصر هذه المصفوفة

count($w) 

سنقسم العدد على 2 (لأننا نريد نصف العدد

count($w) / 2 

ربما كان عدد عناصر المصفوفة مفردا ... وبالتالي سيحوي ناتج القسمة على كسور .. دعنا نتخلص من الكسور ونجبر القيمة إلى اقرب عدد صحيح

ceil(count($w) / 2) 

حسنا .. أصبحنا الآن نعرف ماهو نصف عدد كلمات النص ... سنقوم الآن بإنشاء مصفوفة جديدة تحوي فقط نصف الكلمات الأولى من النص الاصلي

array_slice($w, 0, ceil(count($w) / 2)) 

الآن سنقوم بجمع عناصر المصفوفة الجديدة في جملة نصية عادية .. وسنفصل بين العناصر بمسافة مفردة

join(' ',array_slice($w, 0, ceil(count($w) / 2))) 

سنطبع الناتج

print join(' ',array_slice($w, 0, ceil(count($w) / 2))); 

إلى هنا انتهى تشريح هذه الدالة .. في ردي التالي سنعدل هذه الدالة لعرض عدد معين من كلمات النص المدخل

[القائد]

من الافضل دائما عدم استخدام print أو echo داخل الدوال التي ننشأها .. بل يفضل أن نجعل الدالة تعيد قيمة معينة ومن ثم نقوم بطباعة الناتج بشكل مستقل ...

هذا يعطينا قدرة اكبر في تطوير مهاراتنا وايضا تفيد في تتبع الاخطاء المحتملة وفي الاستخدامات المتقدمة للدوال ...

نريد الآن أن نقوم بإنشاء دالة وظيفتها طباعة عدد معين من كلمات نص معين

لدينا المثال التالي :

$word = "آنة لقيت هذي الـ(Functions) في بعض المواقع و حاولت أدور لها على شرح لكن كل الشرح إلي حصلته باللغة الإنجليزية "; 

ونريد الكلمات العشرة الأولى

الخطوة الأولى هي وضع كلمات النص في مصفوفة بحيث كل عنصر يحوي كلمة واحدة ...

$w = explode(" ", $word); 

نستحدم الدالة array_slice لإنشاء مصفوفة جديدة تحوي فقط العدد الذي نريده من العناصر/الكلمات

$w1 = array_slice($w, 0 , 10); 

نقوم الآن بجمع عناصر المصفوفة الجديدة في جملة واحدة

$w2 = join(' ',$w1); 

تصبح الدالة لدينا بهذا الشكل

function show_word1($note) 
{ 
$w = explode(' ', $note); 
print join(' ',array_slice($w, 0, 10)); 
} 

سنقوم بتطوير هذه الدالة قليلا لتصبح أكثر احترافية
أولا سنضيف امكانية تحديد عدد الكلمات
وثانيا سنجعل الدالة تعيد الجملة عوضا عن ان تطبعها

التطوير الاول يشمل السماح لنا بتحديد عدد الكلمات .. وهذا يعني اضافة معامل جديد للدالة

function show_word1($note, $number) 

حيث $number هو عد الكلمات
الآن سنقوم بالتأكد من ان $number هو قيمة رقمية وذلك بإستخدام الدالة intval التي تعيد القيمة الرقمية للمدخل
واذا كانت قيمة $number أقل من الصفر سنجعلها تساوي صفرا لنتجنب أي مشكلة قد تظهر لدينا

$n = intval($number);
if($n <0){$n = 0;} 

الآن سنتابع الدالة السابقة لكن سنسند ناتج استخدام الدالة join إلى متغير عوضا عن طباعتها

$w = explode(' ', $note); 
$result = join(' ',array_slice($w, 0, $n)); 

الآن سنقوم بإعادة الناتج إلى السكربت وانهاء الدالة

return $result;
} 

الدالة الجديدة كاملة

function show_word1($note, $number) 
{ 
$n = intval($number);
if($n <0){$n = 0;}
$w = explode(' ', $note); 
$result = join(' ',array_slice($w, 0, $n)); 
return $result;
} 

[القائد]

الآن يمكنك تطبيق هذا المثال الكامل:

function show_word1($note, $number) 
{ 
$n = intval($number); 
if($n <0){$n = 0;} 
$w = explode(' ', $note); 
$result = join(' ',array_slice($w, 0, $n)); 
return $result; 
} 

$word = "آنة لقيت هذي الـ(Functions) في بعض المواقع و حاولت أدور لها على شرح لكن كل الشرح إلي حصلته باللغة الإنجليزية ";

$test = show_word1($word, 10);

echo $test; 

[alsohba]

مشكوووووووووووووووووووور جدا أخي القائد .. ولكن يقول الشاعر ::: علمته الرماية فلما اشتد ساعده رماني :::

و أقولها و أنا أفتخر أنك معلمي الفاضل و أقول لك أنك أحسنت في شرحك إلى درجة أني سوف أصحح خطأ أنت وقعت فيه في الكود النهائي .. و لكني أهنيك في النهاية لأنك فهمتني و علمتني ما لم أكن أعلم .. فأسأل الله العلي القدير أن يعلي قدرك و يرفع شأنك في الدنيا و الآخرة ..

أما عن الخطأ هو أنك لما وضعت المتغير $number لم تحدد مكانه في الدالة !!! فيكون الناتج دائماً عشر كلمات فقط !!! وهذا ما جرني إلى أن أجرب تفكيك الدالة و أصحح الخطأ و أن الآن أضعه بين يدي معلمي الكبير القائد

--------------------------------------------------------------------
<?php

function show_word1($note, $number)
{
$n = intval($number);
if($n <0){$n = 0;}
$w = explode(' ', $note);
$result = join(' ',array_slice($w, 0, $number));
return $result;
}

$word = "شكر وعرفان لأخينا القائد البطل المناظل .. ونسأل الله أن يجزيه عنا خير الجزاء هو ولي ذلك و القادر عليه .. و أقول لك أيها القائد مرة أخرى شكراً لك";

$test = show_word1($word, 15);
echo "$test ...";
?>
--------------------------------------------------------------------

هذا هو الكود بعد التصحيح و مشكور على هذي المعلومات القيمة جداً و التي لا تقدر بثمن ..
و أتمنى من الأخوة أن يوجدوا فريق عمل يعملون فيه على شرح دوال البي أتش بي باللغة العربية حتى يتسنى لكل عربي العثور على مبتغاه .. و أكررها أخيراً وليس آخراً جزاك الله عنا خير الجزاء

[القائد]

صحيح وأعتذر عن هذا الخطأ ..

لكن كودك أيضا يحوي خطأ وهو المتغير $number ...

فنحن قد قمنا بالتأكد من أن قيمة $number هي قيمة رقمية عبر استخدامنا الدالة intval واسندنا ناتج الدالة إلى المتغير $n ...

لذلك من الأجدر أن أن تكون $n هي مكان $number في الدالة النهائية ...


قمت بتعديل ردي السابق لأصحح الكود وايضا اضع الكود الصحيح هنا مرة أخرى

<?php

function show_word1($note, $number)
{
$n = intval($number);
if($n <0){$n = 0;}
$w = explode(' ', $note);
$result = join(' ',array_slice($w, 0, $n));
return $result;
}

$word = "شكر وعرفان لأخينا القائد البطل المناظل .. ونسأل الله أن يجزيه عنا خير الجزاء هو ولي ذلك و القادر عليه .. و أقول لك أيها القائد مرة أخرى شكراً لك";

$test = show_word1($word, 15);
echo "$test ..."; 
?>

[alsohba]

و الله ... في خاطري أقول .. أن التلميذ يصعب عليه التغلب على أستاذه

[القائد]

ههههههههههههههههههههههههههههه

العفو

[alsohba]

السلام عليكم ..

أخي الحبيب أخشى إني طولت عليك .. لكن في دوال ودي أعرف في شنو نستعملهم ؟؟

print_r()
print()
fprintf()
printf()

يعني كلهم فيهم برنت !! بس ليش أمثلتهم مختلفة ؟؟ و معقدة ؟؟