توثيق هير

في البداية، توثيق هير أو توثيق هنا؛ (وثيقة هير، نص هير، ، سلسلة هير النصية أو هير النصي) في الحوسبة، هو ملف حرفي أو تيار مدخلات حرفي والذي هو مقطع من ملف كود مصدري يعامل كما لو كان ملف منفصل. يستعمل المصطلح كذلك لشكل من أشكال حرفيات السلسلة النصية متعددة الأسطر التي تستعمل بناء نحوي مماثل، وذلك بالحفاظ على فواصل الأسطر والمسافات البيضاء الأخرى (بما في ذلك المسافة البادئة) في النص.

المراجع

علاوةً على ذلك، يمكن التعامل مع توثيقات هير كملفات أو سلاسل نصية. تعاملها بعض أدوات شيل (shells) على أنها سلسلة تنسيق حرفية، مما يسمح باستبدال متغير واستبدال الأوامر داخل الحرف.

علاوةً على ذلك، توثيقات هير أصلها من شل يونكس، وتوجد في sh ، csh ، tcsh ، ksh ، باش، وزي شل، وغيرها. توجد وثيقة هير بحرفيات سلسلة نصية في مختلف اللغات البرمجية عالية المستوى، لا سيما لغة برمجة بيرل (بناء نحوي مستوحى من يونكس شل) واللغات المتأثرة بـبيرل، مثل بي إتش بي وروبي. تحتوي اللغات الأخرى عالية المستوى مثل بايثون وجافا سكربت وتي سي إل على مرافق أخرى للسلاسل النصية متعددة الخطوط.

ومن جهة أخرى، أكثر بناء نحوي مشترك لتوثيق هير، والذي ينشأ في يونكس شيل، هو >> تليها تعيين معرف التحديد (غالبا EOF أو END )، تبدأ من بداية السطر الجديد من خلال اقتباس النص ب " ", وثم يغلق بنفس معرفات التحديد بنفس السطر. البناء النحوي هذا سببه أن توثيق هير يتم تدفقه بشكل حرفي مقيّد، يتم إعادة توجيه محتوى المستند إلى stdin (الإدخال القياسي) للأمر السابق؛ البناء النحوي لتوثيق هير مماثل للبناء النحوي لإعادة توجيه الإدخال، وهو > «يتم أخذ الإدخال من الملف التالي».

علاوةً على ذلك، غالبًا ما تستعمل اللغات الأخرى بناء نحوي متشابه إلى حد كبير، ولكن يمكن أن تختلف تفاصيل البنيوية والوظائف الفعلية بدرجة كبيرة. عندما تستعمل سلسلة حرفية بسيطة، و >> لا تشير إلى انحراف حاسوبي ، ولكن هو مجرد اصطلاح لمحدد البداية. في بعض اللغات، مثل روبي، >> يستعمل كذلك لإعادة توجيه المدخلات، مما يؤدي إلى أن تستعمل مرتين إذا كان أحد الرغبات هو لإعادة توجيه من توثيق هير الحرفي للسلسلة النصية المطلوبة.