this post was submitted on 20 Aug 2023
1262 points (99.0% liked)

Programmer Humor

19623 readers
113 users here now

Welcome to Programmer Humor!

This is a place where you can post jokes, memes, humor, etc. related to programming!

For sharing awful code theres also Programming Horror.

Rules

founded 1 year ago
MODERATORS
 
you are viewing a single comment's thread
view the rest of the comments
[–] [email protected] 15 points 1 year ago (3 children)

Also me when I'm forced to write documentation for a Python function

def delete_first_of_list(the_list: list):
[–] [email protected] 7 points 1 year ago

What if I pass an empty list, or NoneType?

[–] RagingRobot 5 points 1 year ago (1 children)

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.

[–] [email protected] 4 points 1 year ago

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 or without_first_item.

[–] [email protected] 2 points 1 year ago (1 children)

This is a good way to realise that you don't need a function for that use case.

[–] [email protected] 3 points 1 year ago

If they need it often it makes some sense, if it also perform some checks, if the list if empty or None/null.