alphacyberranger to Programmer Humor@programming.devEnglish • 11 months agoMore the merrierlemmy.worldimagemessage-square75fedilinkarrow-up11.23Karrow-down113
arrow-up11.22Karrow-down1imageMore the merrierlemmy.worldalphacyberranger to Programmer Humor@programming.devEnglish • 11 months agomessage-square75fedilink
minus-square@mashbooq@infosec.publinkfedilink15•11 months agoAlso me when I’m forced to write documentation for a Python function def delete_first_of_list(the_list: list):
minus-square@coloredgrayscale@programming.devlinkfedilink7•11 months agoWhat if I pass an empty list, or NoneType?
minus-square@RagingRobot@lemmy.worldlinkfedilink5•11 months agoDoes this return a new list or modify the original? I would hope it returns a new one but I would know for sure if there was documentation.
minus-square@kablammy@sh.itjust.workslinkfedilink4•11 months agoI would hope it modifies the original. It’s implied in the name. A function that returns all but the first item should be named something like tail or without_first_item.
minus-squarestilgar [he/him] linkfedilink2•11 months agoThis is a good way to realise that you don’t need a function for that use case.
minus-square@coloredgrayscale@programming.devlinkfedilink3•11 months agoIf they need it often it makes some sense, if it also perform some checks, if the list if empty or None/null.
Also me when I’m forced to write documentation for a Python function
def delete_first_of_list(the_list: list):
What if I pass an empty list, or NoneType?
Does this return a new list or modify the original? I would hope it returns a new one but I would know for sure if there was documentation.
I would hope it modifies the original. It’s implied in the name. A function that returns all but the first item should be named something like
tail
orwithout_first_item
.This is a good way to realise that you don’t need a function for that use case.
If they need it often it makes some sense, if it also perform some checks, if the list if empty or None/null.