Cum se dezvoltă un program C simplu

Cum se dezvoltă un program C simplu
Ultima revizuire: ianuarie 1999
(McCann)
Studenții par să aibă întotdeauna probleme să înțeleagă (sau poate doar să facă) ceea ce aștept de la ei atunci când atribuie un program. Cerințele sunt într-adevăr foarte simple; este în mare parte o chestiune de a-ți lăsa suficient timp pentru a face totul.

simplu

Pentru a vă ajuta să înțelegeți ce se așteaptă de la dvs., în acest document voi lua un eșantion simplu de programare și vă voi ghida prin pașii majori ai procesului de dezvoltare a programului.

(Dacă sunteți în căutarea detaliilor despre documentația programului, veți găsi unele aici, dar ar trebui să vizitați pagina mea Stil de programare, care conține colecția mea de documente de stil, inclusiv câteva pagini de stil de la alte persoane. Majoritatea este dezvoltată cu experiență programatori în minte. Acest document este destinat studenților care abia încep să învețe C.)


Pasul 1: începeți devreme
Programarea nu este o activitate care poate fi programată în mod fiabil pentru a dura o perioadă prestabilită de timp. Chiar și programele care par a fi realizabile în 2 ore vor dura adesea 4 sau 5 ore pentru a fi finalizate. Cel mai bun lucru pe care îl poți face pentru tine este să spui: „Nu am nicio idee cât va dura acest lucru; mai bine mă apuc imediat”.

Pasul 2: Citiți cu atenție fișa de atribuire
Fișele mele de atribuire a programării tind să fie foarte detaliate, dacă nu perfect organizate. Tot ceea ce aștept de la tine este dat acolo undeva, așa că citește-l cu atenție și evidențiază punctele cheie, astfel încât să nu treci cu vederea niciuna dintre ele.

De exemplu, să luăm în considerare acest exemplu de atribuire:

COMSC 1613 Programare I

Programul # 0: Calorii datorate grăsimilor

Data limită: Smarch 36th, 2028, la începutul orei

Trebuie să efectuați această atribuire pe sistemul AIX1.

Prezentare generală: Orice dietetician vă va spune că limitarea consumului zilnic de grăsimi să fie sub 30% din totalul caloriilor este o idee bună. Dar câte dintre caloriile din alimentele tale preferate sunt din grăsimi? Etichetele nutriționale vă vor spune câte grame de grăsime există într-o porție și câte calorii totale există în acea porție, dar trebuie să faceți singur restul calculelor.

După cum se întâmplă, un gram de grăsime are aproximativ 9 calorii. Prin urmare, dacă luați grame de grăsime într-o porție a unui anumit aliment, înmulțiți-o cu 9 și împărțiți-o cu numărul total de calorii din porție, veți obține fracțiunea caloriilor datorate grăsimilor. Pentru a obține rezultatul ca procent, trebuie doar să înmulțiți cu 100.

De exemplu, luați în considerare un produs care are 3 grame de grăsime și 170 de calorii pe porție. Există 27 de calorii datorate grăsimilor (3 * 9), iar 27/170 = 0,1588. Înmulțirea cu 100 oferă răspunsul final: 15,88 la sută din calorii se datorează grăsimilor.

Temă: scrieți un program C complet, bine documentat, care începe prin a cere utilizatorului să introducă grame de grăsime și calorii într-o porție de produs alimentar. Programul va calcula procentul caloriilor alimentelor datorate grăsimilor și va afișa informațiile introduse și procentajul sub forma unei propoziții în limba engleză completă.

Date: Rulați programul de două ori, o dată pentru fiecare set de date prezentat în tabelul următor:

Total calorii

Predare: la data scadenței, introduceți următoarele elemente: O imprimare a programului dvs. C documentat și o imprimare a rezultatului produs de programul dvs. când a fost rulat pe fiecare dintre seturile de date date mai sus. Asigurați-vă că vă scrieți numele în colțul din dreapta sus al imprimării; acest lucru vă va face mai ușor să vă revendicați programul atunci când vi-l returnez.

Pasul 3: Scrieți documentația externă
Am auzit deja zâmbetul („Scrieți comentarii acum? Deveniți serios!”) Dar sunt serios: ar trebui să vă scrieți documentația în timp ce scrieți programul, nu după aceea. În special, Documentația externă ar trebui să fie aproape completă înainte de a scrie chiar o linie de cod.

Îmi înmânez claselor mele de programare un document de o pagină care listează informațiile pe care mă aștept să le văd în programele dvs. În special, iată ce ar trebui să conțină documentația externă:

  1. Numele dvs., numele cursului, numele/numărul sarcinii, numele instructorului și data scadenței.
  2. Descrierea problemei pe care programul a fost scris să o rezolve.
  3. Abordare utilizată pentru a rezolva problema. Aceasta ar trebui să includă întotdeauna o scurtă descriere a principalilor algoritmi utilizați sau a numelor lor, dacă sunt algoritmi obișnuiți.
  4. Cerințele operaționale ale programului: ce sistem de limbă ați folosit, informații speciale de compilare, unde intrarea poate fi localizată pe disc etc.
  5. Funcțiile necesare ale sarcinii pe care nu le-ați putut include.
  6. Bugurile cunoscute ar trebui raportate și aici. Dacă o anumită caracteristică nu funcționează corect, este în interesul dumneavoastră să fiți cinstit și complet cu privire la neajunsurile programului dvs.
Pentru a vă ajuta, am creat un șablon pe care îl puteți importa în programul dvs., care conține o etichetă pentru fiecare secțiune pe care vreau să o văd. Tot ce trebuie să faceți este să completați spațiile libere; Nu pot să o fac mult mai ușoară decât atât. Pagina Blocare șabloane de comentarii cu exemple arată șablonul de documentație externă și îl puteți găsi pe AIX1 în fișier

mc/docs/external.c. Să aveți o copie pe AIX1 este plăcut, deoarece puteți utiliza comanda de importare a fișierelor editorului (: r în editorul vi, de exemplu) pentru ao introduce în program; importul șablonului poate economisi o mulțime de tastare.

Iată cum arată șablonul:

Rețineți că am inclus câteva comentarii scurte în fiecare secțiune, pentru a vă informa ce trebuie să adăugați. Deoarece ștergerea tuturor acestor comentarii este dificilă, am o versiune fără comentarii pe AIX1 numită ext.c pe care o puteți importa în schimb. Se află în același director ca external.c .