1.1. Att Kommentera
Programmeringsteknik
(Skillnad mellan versioner)
Rad 21: | Rad 21: | ||
==Funktion, klass, metod== | ==Funktion, klass, metod== | ||
+ | |||
+ | <pre>def funktionens_namn(param1, param2): | ||
+ | '''<Kort kommentar/förklaring om vad funktionen gör> | ||
+ | |||
+ | param param1: <förklara inparametern> | ||
+ | param param2: <förklara inparametern> | ||
+ | returns: <returvärden> | ||
+ | ''' | ||
+ | </pre> | ||
+ | |||
+ | Exempel: | ||
+ | |||
+ | <pre>def calculate_c_and_f(degree, choice): | ||
+ | """Converts temperatures between Celsius and Fahrenheit | ||
+ | param degree: temperature in either C or F | ||
+ | param choice: key to convert from C to F ('F') or F to C ('C') | ||
+ | returns: temperature according to param choice | ||
+ | """ | ||
+ | convert = {'F' : degree * 9/5 + 32, | ||
+ | 'C' : degree * 5/9 - 32} | ||
+ | |||
+ | return convert[choice] | ||
+ | </pre> |
Versionen från 16 september 2014 kl. 14.52
Teori | Att kommentera | Att namnge | Övningar |
Kommentarer
# Skriv ut Charles ålder print("Charles is") age = 2012-1987 print(age, "years old")
Den första raden i det här programmet, raden som börjar med #-tecknet, är en så kallad kommentar. Raden påverkar inte vad som händer när man kör programmet utan är enbart avsedd som information för den som läser programmet. I Python räknas allt från och med #-tecknet till radslut som en kommentar.
Kommentarer kan kanske verka överflödiga men är i själva verket mycket viktiga för att man ska kunna förstå och överblicka sina program.
Funktion, klass, metod
def funktionens_namn(param1, param2): '''<Kort kommentar/förklaring om vad funktionen gör> param param1: <förklara inparametern> param param2: <förklara inparametern> returns: <returvärden> '''
Exempel:
def calculate_c_and_f(degree, choice): """Converts temperatures between Celsius and Fahrenheit param degree: temperature in either C or F param choice: key to convert from C to F ('F') or F to C ('C') returns: temperature according to param choice """ convert = {'F' : degree * 9/5 + 32, 'C' : degree * 5/9 - 32} return convert[choice]