Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
Aceste funcţii sunt restrânse sintactic la o singură expresie:<br />
>>> def make_incrementor(n):<br />
... return lambda x, incr=n: x+incr<br />
...<br />
>>> f = make_incrementor(42)<br />
>>> f(0)<br />
42<br />
>>> f(1)<br />
43<br />
>>><br />
4.7.6 Şirurile de documentaţie<br />
Există anumite convenţii privind conţinutul şi formatarea şirurilor de documentaţie.<br />
Prima linie ar trebui să fie scurtă şi foarte concisă. Pentru concizie nu ar trebui precizat numele obiectivului sau<br />
tipul, acestea fiind subînţelese. Această linie trebuie să înceapă cu literă mare şi să se termine cu virgulă.<br />
Dacă există mai multe linii, cea de-a doua ar trebui să fie vidă, pentru a separa descrierea scurtă de cea amănunţită.<br />
Următoarele linii ar trebui să descrie mai pe larg obiectul, semnificaţia parametrilor, etc.<br />
Interpretorul <strong>Python</strong> ia în consideraţie spaţiile din şirurile de caractere împărţite pe mai multe linii, din această<br />
cauză pentru a avea o documentaţie aranjată ”frumos” trebuie să vă folosiţi de un mic ”truc” la fel ca în exemplul<br />
următor:<br />
>>> def my_function():<br />
... " " "Nu face decat documentarea.<br />
...<br />
... Chiar nu face nimic!<br />
... " " "<br />
... pass<br />
...<br />
>>> print my_function.__doc__<br />
Nu face decat documentarea.<br />
Chiar nu face nimic!<br />
26 Capitolul 4. Structuri de control