Şərh — proqramlaşdırmada kompüter proqramının mənbə kodunda proqramçı tərəfindən oxuna bilən izahatı və ya annotasiyası. Onlar mənbə kodunu insanların başa düşməsini asanlaşdırmaq məqsədi ilə əlavə edilir və ümumiyyətlə tərtibçilər və tərcüməçilər tərəfindən nəzərə alınmır. Müxtəlif proqramlaşdırma dillərində şərhlərin sintaksisi xeyli fərqlənir.
Şərhlər bəzən tərəfindən mənbə kodundan kənarda sənədlər yaratmaq üçün müxtəlif yollarla işlənir və ya mənbə kodu idarəetmə sistemləri və digər xarici proqramlaşdırma alətləri ilə inteqrasiya üçün istifadə olunur.
Şərhlərin təmin etdiyi çeviklik geniş dərəcədə dəyişkənliyə imkan verir, lakin onların istifadəsi ilə bağlı rəsmi konvensiyalar adətən proqramlaşdırma üslubu təlimatlarının bir hissəsidir.
İzahı
Şərhlər ümumiyyətlə blok (həmçinin proloq şərhləri deyilir) və ya sətir şərhləri (həmçinin daxili şərhlər adlanır) kimi formatlanır.
Blok şərhləri mənbə kodunun bir neçə sətrini və ya bir sətrin bir hissəsini əhatə edə bilən bölgəsini limitləşdirir. Bu bölgə başlanğıc və son ayırıcı simvolu ilə müəyyən edilir. Bəzi proqramlaşdırma dilləri (məsələn MATLAB) blok şərhlərini bir-birinin içərisində rekursiv şəkildə yerləşdirməyə imkan verir, digərləri isə (məsələn Java) bunu etmir.
Sətir şərhləri ya şərh ayırıcısı ilə başlayır və sətrin sonuna qədər davam edir, ya da bəzi hallarda mənbə kodundakı xüsusi sütundan (simvol xətti sürüşməsi) başlayır və sətrin sonuna qədər davam edir.
Bəzi proqramlaşdırma dilləri həm blok, həm də sətir şərhlərini müxtəlif şərh ayırıcıları ilə istifadə edir. Məsələn, dilində //
ilə ayrılmış sətir şərhləri və /*
və */
ilə ayrılmış blok şərhləri mövcuddur. Digər dillər yalnız bir şərh növünü dəstəkləyir. Məsələn, Ada dilinin şərhləri sətir şərhləridir, onlar --
ilə başlayır və sətrin sonuna qədər davam edir.
İstinadlar
- . "comment" // Rasim Əliquliyev (redaktor). İnformatika terminlərinin izahlı lüğəti (az.). Bakı: "İnformasiya texnologiyaları" / "Bakı" nəşriyyatı. 2017. səh. 147. ISBN . 6 sentyabr 2023 tarixində (PDF) (#archive_missing_url).
- Penny Grubb, Armstrong Takang. Software Maintenance: Concepts and Practice. World Scientific. 2003. 7, plese start120–121. ISBN .
Source code can be divided into program code (which consists of machine-translatable instructions); and comments (which include human-readable notes and other kinds of annotations in support of the program code).
- Ganguli, Madhushree. Making Use of Jsp. New York: Wiley. 2002. ISBN ., Hewitt, Eben. Java for Coldfusion Developers. Upper Saddle River: Pearson Education. 2003. ISBN .
- Dixit, J.B. Computer Fundamentals and Programming in C. Laxmi Publications. 2003. ISBN .
- Higham, Desmond. MATLAB Guide. SIAM. 2005. ISBN .
- Vermeulen, Al. The Elements of Java Style. Cambridge University Press. 2000. ISBN .
- "Using the right comment in Java". 2000-03-04. 2017-12-12 tarixində . İstifadə tarixi: 2007-07-24.
Əlavə ədəbiyyat
- Movshovitz-Attias, Dana and Cohen, William W. (2013) Natural Language Models for Predicting Programming Comments. In Association for Computational Linguistics (ACL), 2013.
Xarici keçidlər
- by Denis Krukovsky
- by PTLogica
- How to Write Comments for the Javadoc Tool
wikipedia, oxu, kitab, kitabxana, axtar, tap, meqaleler, kitablar, oyrenmek, wiki, bilgi, tarix, tarixi, endir, indir, yukle, izlə, izle, mobil, telefon ucun, azeri, azəri, azerbaycanca, azərbaycanca, sayt, yüklə, pulsuz, pulsuz yüklə, haqqında, haqqinda, məlumat, melumat, mp3, video, mp4, 3gp, jpg, jpeg, gif, png, şəkil, muisiqi, mahnı, kino, film, kitab, oyun, oyunlar, android, ios, apple, samsung, iphone, pc, xiomi, xiaomi, redmi, honor, oppo, nokia, sonya, mi, web, computer, komputer
Serh proqramlasdirmada komputer proqraminin menbe kodunda proqramci terefinden oxuna bilen izahati ve ya annotasiyasi Onlar menbe kodunu insanlarin basa dusmesini asanlasdirmaq meqsedi ile elave edilir ve umumiyyetle tertibciler ve tercumeciler terefinden nezere alinmir Muxtelif proqramlasdirma dillerinde serhlerin sintaksisi xeyli ferqlenir Qirmizi rengle qeyd edilmis proloq serhleri ile Java kodunun izahi ve yasil rengde olan daxili serhler Proqram kodu mavi rengdedir Serhler bezen terefinden menbe kodundan kenarda senedler yaratmaq ucun muxtelif yollarla islenir ve ya menbe kodu idareetme sistemleri ve diger xarici proqramlasdirma aletleri ile inteqrasiya ucun istifade olunur Serhlerin temin etdiyi ceviklik genis derecede deyiskenliye imkan verir lakin onlarin istifadesi ile bagli resmi konvensiyalar adeten proqramlasdirma uslubu telimatlarinin bir hissesidir IzahiSerhler umumiyyetle blok hemcinin proloq serhleri deyilir ve ya setir serhleri hemcinin daxili serhler adlanir kimi formatlanir Blok serhleri menbe kodunun bir nece setrini ve ya bir setrin bir hissesini ehate ede bilen bolgesini limitlesdirir Bu bolge baslangic ve son ayirici simvolu ile mueyyen edilir Bezi proqramlasdirma dilleri meselen MATLAB blok serhlerini bir birinin icerisinde rekursiv sekilde yerlesdirmeye imkan verir digerleri ise meselen Java bunu etmir Setir serhleri ya serh ayiricisi ile baslayir ve setrin sonuna qeder davam edir ya da bezi hallarda menbe kodundaki xususi sutundan simvol xetti surusmesi baslayir ve setrin sonuna qeder davam edir Bezi proqramlasdirma dilleri hem blok hem de setir serhlerini muxtelif serh ayiricilari ile istifade edir Meselen C dilinde ile ayrilmis setir serhleri ve ve ile ayrilmis blok serhleri movcuddur Diger diller yalniz bir serh novunu destekleyir Meselen Ada dilinin serhleri setir serhleridir onlar ile baslayir ve setrin sonuna qeder davam edir Istinadlar comment Rasim Eliquliyev redaktor Informatika terminlerinin izahli lugeti az Baki Informasiya texnologiyalari Baki nesriyyati 2017 seh 147 ISBN 978 9952 434 82 8 6 sentyabr 2023 tarixinde PDF archive missing url Penny Grubb Armstrong Takang Software Maintenance Concepts and Practice World Scientific 2003 7 plese start120 121 ISBN 978 981 238 426 3 Source code can be divided into program code which consists of machine translatable instructions and comments which include human readable notes and other kinds of annotations in support of the program code Ganguli Madhushree Making Use of Jsp New York Wiley 2002 ISBN 978 0 471 21974 3 Hewitt Eben Java for Coldfusion Developers Upper Saddle River Pearson Education 2003 ISBN 978 0 13 046180 3 Dixit J B Computer Fundamentals and Programming in C Laxmi Publications 2003 ISBN 978 81 7008 882 0 Higham Desmond MATLAB Guide SIAM 2005 ISBN 978 0 89871 578 1 Vermeulen Al The Elements of Java Style Cambridge University Press 2000 ISBN 978 0 521 77768 1 Using the right comment in Java 2000 03 04 2017 12 12 tarixinde Istifade tarixi 2007 07 24 Elave edebiyyatMovshovitz Attias Dana and Cohen William W 2013 Natural Language Models for Predicting Programming Comments In Association for Computational Linguistics ACL 2013 Xarici kecidlerby Denis Krukovsky by PTLogica How to Write Comments for the Javadoc Tool