Microsoft Visual Basic համակարգչային ծրագրավորման լեզուն երկար տարիներ տարածված է ծրագրավորման շրջանակներում: Programրագրավորողներն այն օգտագործում են բոլոր տեսակի նախագծերի համար: Այս ծրագրավորման լեզվի տարբերակները օգտագործվում են վեբ էջերի համար, իսկ Visual Basic- ի այլ տեսակներ օգտագործվում են Windows- ի շատ ծրագրերի համար, որոնք մենք օգտագործում ենք ամեն օր: Visual Basic- ի էական տարրերից մեկը մեկնաբանություններ ներառելու ունակությունն է, որոնք ծածկագրում ներդրված նշումներ են, որոնք չունեն ֆունկցիոնալ կոդի նպատակ: Visual Basic- ը օգտագործում է հատուկ արձանագրություն `դրանք կոդից տարբերելու համար: Մեկնաբանություններ ավելացնելը չափազանց կարևոր է նախագծերի մեծ մասում, որոնք կօգնեն մարդկային ծածկադիտողներին ճիշտ կարդալ կոդի մոդուլները: Եթե Ձեզ անհրաժեշտ է մեկնաբանություններ ավելացնել Visual Basic- ին, ահա մի քանի հիմնարար քայլեր `համոզվելու համար, որ դա ճիշտ եք անում:
Քայլեր
Քայլ 1. Որոշեք, թե որ տեսակի մեկնաբանություն եք ցանկանում ավելացնել:
Programրագրավորողները մի քանի տարբեր հիմնական նպատակներ ունեն մեկնաբանությունների համար, որոնք որոշում են մեկնաբանության մեջ ներառվածի ճշգրիտ ձևն ու ոճը:
- Հաշվի առեք կոդի մոդուլի մեկնաբանությունները: Մոդուլի մեկնաբանությունները ավելի բարձր մակարդակի մեկնաբանություններ են, որոնք սովորաբար նկարագրում են կոդի մոդուլի ընդհանուր նպատակները, ինչպես նաև այլ տեղեկություններ, ինչպիսիք են հեղինակային իրավունքը, հեղինակությունը և այլն:
- Գնահատեք ընթացակարգի մեկնաբանությունների անհրաժեշտությունը: Պետք է մեկնաբանել նաև ֆունկցիոնալ կոդի տարբեր ընթացակարգեր: Ընթացակարգի մեկնաբանությունները վերաբերում են կոդի հատուկ գործառույթներին, և դրանք օգնում են այլ ծրագրավորողներին նախազգուշացնել ընթացակարգի ճշգրիտ արդյունքների մասին `ըստ այն, թե ինչպես է այն գրված:
Քայլ 2. Ընտրեք կոդերի մեկնաբանությունների օգտագործման մանրամասն կատեգորիաներ:
Մեկնաբանությունների որոշ տեսակներ, ինչպես ընթացակարգի մեկնաբանությունները, նույնպես լինում են տարբեր ձևերով: Հասկացեք այս տարբեր օգտագործումները `ձեր ծրագրին ճիշտ տեսակի մեկնաբանություններ ավելացնելու համար:
- Գնահատեք ընթացակարգերի համար նպատակային մեկնաբանությունների օգտագործումը: Դրանք նկարագրում են, թե ինչ է անում ընթացակարգը:
- Մտածեք գործառույթի վերադարձման արժեքի մեկնաբանությունների օգտագործումը: Դրանք կօգնեն մյուսներին հասկանալ, թե ինչ արժեքներ են վերադարձվում ընթացակարգով:
- Ներառեք պայմանական մեկնաբանություններ: Պայմանական մեկնաբանությունները կարող են նկարագրել հնարավոր սխալի պայմանները և սխալի լուծումը, ինչպես նաև պայմանները, որոնք պետք է բավարարվեն ծածկագրի ճիշտ աշխատանքի համար:
Քայլ 3. Ընտրեք մեկնաբանությունների ձևաչափ:
Կա նաև այն հարցը, թե ինչպես եք մեկնաբանություններ ավելացնելու կոդի որոշակի տողերին:
- Օգտագործեք ձախլիկ մեկնաբանություններ: Այս մեկնաբանությունները սկսվում են էկրանի ձախ մասում և շարունակվում ամբողջ գծով: Սովորաբար, ծածկագրողը պետք է կամայականորեն ավարտի մեկնաբանությունը էկրանի աջ կողմում, իջնի նոր տող և շարունակի մեկնաբանությունը:
- Օգտագործեք առցանց մեկնաբանություններ: Շարքային մեկնաբանություններն ունեն ապոստրոֆ ՝ անմիջապես ծածկագրից և տեղադրված են նույն տողում:
Քայլ 4. Ձեր մեկնաբանությունների սկիզբը նշելու համար օգտագործեք ապոստրոֆ:
Սա առանցքային քայլ է իրականում մեկնաբանություններ կոդի մեջ գրելու համար: Ապոստրոֆը հատուկ տեքստային արձանագրություն է, որը Visual Basic կոմպիլյատորը ճանաչում է մեկնաբանությունների համար: Առանց դրա, համակարգիչը կփորձի կարդալ մեկնաբանությունները որպես կոդ: