مقارنة لغات البرمجة (بناء الجملة)

فيما يلي بعض لغات البرمجة البارزة التي تعتمد على الأسطر وتوفر إمكانية استمرار النص في السطر. ما لم يُذكر خلاف ذلك، يجب أن يكون مُحدِّد الاستمرار هو النص الأخير في السطر.

علامة العطف (&)

• فورتران 90 ، فورتران 95 ، فورتران 2003 ، فورتران 2008

رد فعل عكسي

• باش ^{[ 3 ]} وغيرها من واجهات يونكس
• وحدات المعالجة المسبقة للغة C ؛ تُستخدم بالتزامن مع لغات البرمجة C و C++ والعديد من سياقات البرمجة الأخرى.
• كريستال
• ماثيماتيكا ، لغة وولفرام
• بايثون ^{[ 4 ]}
• روبي
• جافا سكريبت – فقط داخل السلاسل النصية ذات علامات الاقتباس المفردة أو المزدوجة
• Vimscript كأول حرف في السطر المتواصل

علامة اقتباس معكوسة

• باور شيل

واصلة

• SQL*Plus

تسطير

• أوتو إت
• الكوبرا
• فيجوال بيسك
• زوجو

علامة الحذف (ثلاث نقاط)

• في MATLAB : لا يشترط أن تنتهي علامة الحذف (...) عند نهاية السطر، ولكن يتم تجاهل النص الذي يليها. ^{[ 5 ]} تبدأ هذه العلامة تعليقًا يمتد حتى (بما في ذلك) أول سطر جديد لاحق. قارن هذا بتعليق السطر الذي يمتد حتى السطر الجديد التالي.

فاصلة

• روبي: قد يتبع التعليق المحدد

فاصل القوس الأيسر

• ملف الدفعات : بدء كتلة بين قوسين يمكن أن يسمح باستمرار السطر ^{[ 6 ]}
• روبي: قوس مفتوح، أو قوس مربع مفتوح، أو قوس معقوف مفتوح

رمز المشغل

• روبي: كآخر عنصر في السطر؛ قد يتبع التعليق عامل التشغيل
• AutoHotkey : كأول حرف في السطر المتواصل؛ أي عوامل تعبير باستثناء ++ و --، وفاصلة أو نقطة ^{[ 7 ]}

يُستخدم نوع من أنواع التعليقات على الأسطر كامتداد للسطر

• مُجمِّع توربو :\
• m4 :dnl
• TeX :%

موقع الشخصية

• فورتران 77 : يُعتبر السطر غير التعليقي استمرارًا للسطر غير التعليقي السابق إذا ظهر أي حرف غير مسافة في العمود 6. لا يمكن استمرار الأسطر التعليقية.
• COBOL : يمكن استكمال الثوابت النصية عن طريق عدم إنهاء السلسلة الأصلية في عبارة PICTURE بـ '، ثم إدراج -في العمود 7 (نفس موضع *التعليق المستخدم).
• ملاحظة : الأسطر التي تبدأ بعلامة جدولة (بعد أي مسافة بادئة مطلوبة حسب السياق) تستمر في تنفيذ الأمر السابق.

يقوم مترجم لغة C بربط السلاسل النصية المتجاورة حتى لو كانت على أسطر منفصلة، ​​ولكن هذا ليس بناء جملة استمرار السطر لأنه يعمل بنفس الطريقة بغض النظر عن نوع المسافة البيضاء بين السلاسل النصية.

• #include <filename>أو – معالج C المسبق المستخدم بالتزامن مع لغتي C و C++ وأدوات التطوير الأخرى#include "filename"

• addpath(directory)– MATLAB ^{[ 8 ]}
• COPYfilename.– كوبول
• import<filename>;أو – لغة C++import"filename";
• :-include("filename").– مقدمة
• #include file="filename"– ASP
• #include <filename>أو – AutoHotkey ، AutoIt#include "filename"
• #import "filename"أو – أوبجكتيف سي#import <filename>
• Import["filename"]– ماثيماتيكا ، لغة وولفرام
• include'filename'– فورتران
• include "filename";– PHP
• include [filename] programأو #include [filename] program– اختر الأساسي
• include!("filename");– الصدأ
• load "filename"– روبي
• load%filename- أحمر
• require('filename')– لغة لوا
• require "filename";– بيرل ، بي إتش بي
• require"filename"– روبي ، كريستال
• source(""filename"")– ر
• @import("filename");– زيج

• #include filename– ج
• import module;– لغة C++
• #[path = "filename"] mod altname;– الصدأ
• @import module;– أوبجكتيف سي
• <<name– ماثيماتيكا ، لغة وولفرام
• :-use_module(module).– مقدمة :
• from module import *– بايثون
• extern crate libname;– أو أو – الصدأextern crate libname as altname;mod modname;
• library("package")– R :
• IMPORT module– أوبرون
• import altname "package/name"- يذهب :
• import package.module;أو – دimport altname = package.module;
• import Moduleأو – هاسكلimport qualified Module as M
• import package.*– جافا ، ماتلاب ، كوتلين
• import "modname";– جافا سكريبت
• import altname from "modname";– جافا سكريبت
• import packageأو – سكالاimport package._
• import module– سويفت
• import module– V (Vlang)
• import module– بايثون
• require('modname')– لغة لوا
• require"shard"– كريستال
• require"gem"– روبي
• use module– فورتران 90+
• use module, only : identifier– فورتران 90+
• use Module;– بيرل
• use Module qw(import options);– بيرل
• use Package.Name- الكوبرا
• uses unit- باسكال
• with package– آدا
• @import("pkgname");– زيج

• from module import Class– بايثون
• import package.class– جافا ، ماتلاب ، كوتلين
• import class from "modname";– جافا سكريبت
• import {class} from "modname";– جافا سكريبت
• import {class as altname} from "modname";– جافا سكريبت
• import package.class– سكالا
• import package.{ class1 => alternativeName, class2 }– سكالا
• import package._– سكالا
• use Namespace\ClassName;– PHP
• use Namespace\ClassName as AliasName;– PHP
• using namespace::subnamespace::Class;– لغة C++

استيراد الإجراءات/الدوال

• from module import function– بايثون
• import package.module : symbol;– د
• import package.module : altsymbolname = symbol;– د
• import Module (function)– هاسكل
• import function from "modname";– جافا سكريبت
• import {function} from "modname";– جافا سكريبت
• import {function as altname} from "modname";– جافا سكريبت
• import package.function– MATLAB
• import package.class.function– سكالا
• import package.class.{ function => alternativeName, otherFunction }– سكالا
• useModule('symbol');– بيرل
• use function Namespace\function_name;– PHP
• use Namespace\function_name as function_alias_name;– PHP
• using namespace::subnamespace::symbol;– لغة C++
• use module::submodule::symbol;– الصدأ
• use module::submodule::{symbol1, symbol2};– الصدأ
• use module::submodule::symbol as altname;– الصدأ

• use const Namespace\CONST_NAME;– PHP

يمكن أيضًا تصنيف العبارات المذكورة أعلاه حسب ما إذا كانت وسيلة ملائمة نحوية (تسمح بالإشارة إلى الأشياء باسم أقصر، ولكن لا يزال من الممكن الإشارة إليها باسم مؤهل بالكامل دون استيراد)، أو ما إذا كانت مطلوبة بالفعل للوصول إلى الكود (بدونها يستحيل الوصول إلى الكود، حتى مع الأسماء المؤهلة بالكامل).

• import package.*جافا
• import package.classجافا
• open moduleأوكاميل
• using namespace namespace::subnamespace;– لغة C++
• use module::submodule::*;– الصدأ

• import module;لغة سي++
• import altname "package/name"يذهب
• import altname from "modname";جافا سكريبت
• import moduleبايثون

في هذه الأمثلة، ~يُمثل النص محتوى التعليق، والنص المحيط به هو الفواصل. لا تُعتبر المسافات البيضاء (بما في ذلك سطر جديد ) فواصل.

فورتران

يُعدّ وضع مسافة بادئة للأسطر في لغة فورتران 66/77 أمرًا بالغ الأهمية. يُكتب النص الفعلي في الأعمدة من 7 إلى 72 من السطر. أي حرف غير مسافة في العمود 6 يُشير إلى أن هذا السطر هو امتداد للسطر السابق. وجود علامة اقتباس مفردة (' C') في العمود 1 يُشير إلى أن هذا السطر بأكمله عبارة عن تعليق. قد تحتوي الأعمدة من 1 إلى 5 على رقم يُستخدم كعلامة. يتم تجاهل الأعمدة من 73 إلى 80، ويمكن استخدامها للتعليقات؛ في زمن البطاقات المثقبة ، كانت هذه الأعمدة تحتوي غالبًا على رقم تسلسلي لتسهيل فرز مجموعة البطاقات بالترتيب الصحيح في حال سقوطها عن طريق الخطأ. ألغى فورتران 90 الحاجة إلى قاعدة المسافة البادئة، وأضاف تعليقات الأسطر، مستخدمًا الحرف !كفاصل للتعليقات.

كوبول

في التعليمات البرمجية ذات التنسيق الثابت، يُعدّ ترتيب الأسطر مهمًا. يتم تجاهل الأعمدة من 1 إلى 6 والأعمدة من 73 فصاعدًا. إذا وُجدت قيمة a *أو /في العمود 7، فإن هذا السطر يُعتبر تعليقًا. حتى إصدار COBOL 2002، إذا وُجدت قيمة a Dأو dفي العمود 7، فإنها تُعرّف "سطر تصحيح الأخطاء" الذي يتم تجاهله ما لم يُطلب من المُصرّف ترجمته.

الكوبرا

يدعم برنامج كوبرا التعليقات المطولة باستخدام " /#... #/"، وهي تشبه " /*... */" الموجودة عادةً في لغات البرمجة المبنية على لغة C، ولكن مع اختلافين: أولهما، #إعادة استخدام الحرف من صيغة التعليق أحادي السطر " #..."، وثانيهما، إمكانية تداخل التعليقات المطولة، مما يُسهّل عملية التعليق على أجزاء كبيرة من التعليمات البرمجية.

حليقة

يدعم Curl التعليقات المضمنة مع علامات محددة من قبل المستخدم كما في |foo# ... #foo|.

لغة لوا

كما هو الحال مع السلاسل النصية الخام، يمكن أن يحتوي كل من وسم الفتح ووسم الإغلاق على عدد متطابق من علامات المساواة؛ وهذا يسمح بالتداخل طالما أن التعليقات/السلاسل النصية الخام المتداخلة تستخدم عددًا مختلفًا من علامات المساواة عن التعليق المحيط بها. --[[comment --[=[ nested comment ]=] ]]تتجاهل لغة Lua أول سطر جديد (إن وجد) يلي وسم الفتح مباشرةً.

بيرل

تُعتبر التعليقات المطولة في لغة بيرل جزءًا من التوثيق، ويُطلق عليها اسم " التوثيق البسيط القديم " (POD). من الناحية التقنية، لا يوجد في بيرل اتفاقية محددة لإدراج التعليقات المطولة في شفرة المصدر، ولكن يُستخدم التوثيق البسيط القديم بشكل روتيني كحل بديل.

PHP

يدعم PHP التعليقات القياسية على نمط C/C++، ولكنه يدعم نمط Perl أيضًا.

بايثون

إن استخدام علامات الاقتباس الثلاثية للتعليق على أسطر من التعليمات البرمجية المصدرية لا يشكل تعليقًا فعليًا. ^{[ 19 ]} يصبح النص المضمن سلسلة نصية حرفية، والتي يتجاهلها بايثون عادةً (إلا إذا كانت العبارة الأولى في جسم وحدة أو فئة أو دالة؛ انظر docstring ).

إكسير

الحيلة المذكورة أعلاه، والمستخدمة في بايثون، تعمل أيضًا في إليكسير، لكن المُصرّف سيُصدر تحذيرًا إذا رصدها. لتجاهل هذا التحذير، يجب إضافة رمز ~S(يمنع استيفاء السلاسل النصية) قبل السلسلة النصية المُحاطة بثلاث علامات اقتباس، ما يُؤدي إلى البنية النهائية ~S""" ... """. إضافةً إلى ذلك، تدعم إليكسير شكلًا محدودًا من التعليقات الكتلية كميزة لغوية رسمية، ولكن كما هو الحال في بيرل، فإن هذه البنية مُخصصة لكتابة التوثيق فقط. على عكس بيرل، لا يُمكن استخدامها كحل بديل، إذ تقتصر على أجزاء مُعينة من الكود، وتُصدر أخطاءً أو حتى تُعطّل الدوال إذا استُخدمت في أماكن أخرى. ^{[ 20 ]}

راكو

يستخدم راكو#`(...) للدلالة على التعليقات الكتلية. ^{[ 21 ]} يسمح راكو فعليًا باستخدام أي زوج من الأقواس "اليمنى" و"اليسرى" بعد #`(أي #`(...)، #`[...]و #`{...}، و #`<...>، وحتى الأقواس الأكثر تعقيدًا كلها تعليقات كتلية صالحة). كما يُسمح بتداخل الأقواس داخل التعليقات (أي، حتى آخر قوس إغلاق).#`{{...}}#`{ a { b } c }

روبي

يُفتح التعليق الكتلي في لغة روبي عند =beginالسطر 1 ويُغلق عند =endالسطر 2.

دارجة

يتجاهل المفسر منطقة الأسطر المحصورة بين علامتي و . يمكن أن يكون اسم الوسم أي سلسلة من الأحرف والأرقام تُستخدم للإشارة إلى كيفية فك تشفير الكتلة المحصورة. على سبيل المثال، قد يشير إلى بداية كتلة من وثائق LaTeX المنسقة.#<tag>#</tag>#<latex>

مخطط واحتيال

يمكن التعليق على المكون النحوي الكامل التالي (تعبير-s) باستخدام #;.

ABAP

يدعم ABAP نوعين مختلفين من التعليقات. إذا كان الحرف الأول من السطر، بما في ذلك المسافة البادئة، علامة نجمية (* *)، يُعتبر السطر بأكمله تعليقًا، بينما "تبدأ علامة اقتباس مزدوجة واحدة (*) تعليقًا ضمن السطر يستمر حتى نهايته. لا يمكن كتابة تعليقات ABAP بين العبارات، EXEC SQLوذلك لأن لغة SQL الأصلية لها استخدامات أخرى لهذه الأحرف. في معظم لهجات SQL، يمكن استخدام ENDEXECالشرطة المزدوجة (- ) بدلاً من ذلك.--

اللغات الباطنية

تتبع العديد من لغات البرمجة الباطنية الاتفاقية القائلة بأن أي نص لا يتم تنفيذه بواسطة مؤشر التعليمات (مثل Befunge ) أو يتم تعيين معنى له بطريقة أخرى (مثل Brainfuck ) يعتبر "تعليقًا".

توجد أنماط كتابة متنوعة لكتابة التعليقات في الشيفرة المصدرية. BlockCommentيُستخدم الخط المائل هنا للإشارة إلى نمط التعليق الكتلي. LineCommentويُستخدم الخط المائل هنا للإشارة إلى نمط التعليق السطري.