https://3rabica.org/index.php?action=history&feed=atom&title=%D8%AA%D9%88%D8%AB%D9%8A%D9%82_%D9%87%D9%8A%D8%B1توثيق هير - تاريخ المراجعة2026-06-14T12:31:49Zتاريخ التعديل لهذه الصفحة في الويكيMediaWiki 1.45.3https://3rabica.org/index.php?title=%D8%AA%D9%88%D8%AB%D9%8A%D9%82_%D9%87%D9%8A%D8%B1&diff=3253320&oldid=prevعبد العزيز: بوت: إصلاح أخطاء فحص أرابيكا من 1 إلى 1042023-07-23T02:23:11Z<p>بوت: إصلاح أخطاء فحص أرابيكا من 1 إلى 104</p>
<p><b>صفحة جديدة</b></p><div>{{يتيمة|تاريخ=يوليو 2020}}<br />
[[ملف:NekroByte - Heredoc.png|تصغير|200بك|يسار]]<br />
'''توثيق هير''' أو ''' توثيق هنا'''؛ {{إنج|Here document}} ('''وثيقة هير'''، '''نص هير،''' {{إنج|heredoc ،hereis}}، '''سلسلة هير النصية''' أو '''هير النصي''') في [[حوسبة|الحوسبة]]، هو ملف حرفي أو [[جريان (حوسبة)|تيار مدخلات]] حرفي والذي هو مقطع من ملف [[نص برمجي مصدري|كود مصدري]] يعامل كما لو كان ملف منفصل. يستخدم المصطلح أيضًا لشكل من أشكال حرفيات السلسلة النصية متعددة الأسطر التي تستخدم بناء نحوي مماثل، وذلك بالحفاظ على فواصل الأسطر والمسافات البيضاء الأخرى (بما في ذلك المسافة البادئة) في النص.<br />
<br />
توثيقات هير أصلها من [[شل يونكس]]، <ref name="posix">{{استشهاد ويب<br />
| مسار = https://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_07_04<br />
| عنوان = Here-Document description in the POSIX/SUS standard<br />
| مسار أرشيف = https://web.archive.org/web/20140427082439/http://pubs.opengroup.org/onlinepubs/9699919799/utilities/V3_chap02.html#tag_18_07_04<br />
| تاريخ أرشيف = 2014-04-27<br />
| تاريخ الوصول = 2018-04-20<br />
}}</ref> وتوجد في sh ، csh ، <ref>{{استشهاد ويب<br />
| مسار = http://rosettacode.org/wiki/Here_document#C_Shell<br />
| عنوان = Here document - Rosetta Code<br />
| موقع = rosettacode.org<br />
| لغة = en<br />
| تاريخ الوصول = 2017-02-20<br />
|مسار أرشيف= https://web.archive.org/web/20200629092809/https://rosettacode.org/wiki/Here_document|تاريخ أرشيف=2020-06-29}}</ref> tcsh ، <ref name="Darwin">[https://developer.apple.com/library/archive/documentation/Darwin/Reference/ManPages/man1/csh.1.html Darwin tcsh man page] {{Webarchive|url=https://web.archive.org/web/20190701120853/https://developer.apple.com/library/archive/documentation/Darwin/Reference/ManPages/man1/csh.1.html |date=1 يوليو 2019}} {{وصلة مكسورة|تاريخ=2020-10-13|bot=JarBot}}</ref> ksh ، [[باش (يونكس)|باش]]، و[[زي شل]]، وغيرها. توجد وثيقة هير بحرفيات سلسلة نصية في مختلف [[لغة برمجة عالية المستوى|اللغات البرمجية عالية المستوى]]، لا سيما [[بيرل|لغة برمجة بيرل]] (بناء نحوي مستوحى من يونكس شل) واللغات المتأثرة بـبيرل، مثل [[بي إتش بي]] و[[روبي (لغة برمجة)|روبي]]. تحتوي اللغات الأخرى عالية المستوى مثل [[بايثون (لغة برمجة)|بايثون]] و[[جافا سكريبت|جافا سكربت]] و<nowiki/>[[تي سي إل]] على مرافق أخرى للسلاسل النصية متعددة الخطوط.<br />
<br />
يمكن التعامل مع توثيقات هير كملفات أو سلاسل نصية. تعاملها بعض أدوات شيل (shells) على أنها سلسلة تنسيق حرفية، مما يسمح [[متغير (علم الحاسوب)|باستبدال متغير واستبدال]] الأوامر داخل الحرف.<br />
<br />
أكثر بناء نحوي مشترك لتوثيق هير، والذي ينشأ في يونكس شيل، هو <code>>></code> تليها تعيين معرف التحديد (غالبا EOF أو END <ref name="EOF">{{استشهاد ويب<br />
| مسار = http://content.hccfl.edu/pollock/ShScript/HereDoc.htm<br />
| عنوان = Shell Here Document Overview<br />
| ناشر = hccfl.edu<br />
| مسار أرشيف = https://web.archive.org/web/20140529084958/http://content.hccfl.edu/pollock/ShScript/HereDoc.htm<br />
| تاريخ أرشيف = 2014-05-29<br />
| تاريخ الوصول = 2014-05-28<br />
| الأخير = Wayne Pollock<br />
}}</ref>)، تبدأ من بداية السطر الجديد من خلال اقتباس النص ب " ", وثم يغلق بنفس معرفات التحديد بنفس السطر. البناء النحوي هذا سببه أن توثيق هير يتم تدفقه بشكل حرفي مقيّد، يتم إعادة توجيه محتوى المستند إلى [[تيارات البيانات الموحدة|stdin]] (الإدخال القياسي) للأمر السابق؛ البناء النحوي لتوثيق هير مماثل للبناء النحوي لإعادة توجيه الإدخال، وهو <code>></code> «يتم أخذ الإدخال من الملف التالي».<br />
<br />
غالبًا ما تستخدم اللغات الأخرى بناء نحوي متشابه إلى حد كبير، ولكن يمكن أن تختلف تفاصيل البنيوية والوظائف الفعلية بشكل كبير. عندما تستخدم سلسلة حرفية بسيطة، و <code>>></code> لا تشير إلى انحراف حاسوبي {{إنج|indirection}}، ولكن هو مجرد اصطلاح لمحدد البداية. في بعض اللغات، مثل روبي، <code>>></code> يستخدم أيضا لإعادة توجيه المدخلات، مما يؤدي إلى أن تستخدم مرتين إذا كان أحد الرغبات هو لإعادة توجيه من توثيق هير الحرفي للسلسلة النصية المطلوبة.<br />
<br />
== المراجع ==<br />
{{مراجع|30em}}<br />
<br />
== روابط خارجية ==<br />
<br />
* [http://rosettacode.org/wiki/Here_document هنا الوثيقة] . رابط إلى مهمة Rosetta Code بأمثلة من المستندات هنا بأكثر من 15 لغة.<br />
{{شريط بوابات|علم الحاسوب|}}<br />
<br />
[[تصنيف:بنى البرمجة]]<br />
[[تصنيف:سلسلة (علم الحاسوب)]]</div>عبد العزيز