Clean Code 101: Functions

Ilolo Izu
3 min readDec 9, 2022

--

Ilolo Izu, December 2022

In his book “Clean Code,” Robert C. Martin discusses the importance of writing clean and well-structured functions in software development. In Chapter 3, he argues that functions should be small, focused, and do one thing well. He also emphasizes the importance of choosing good names for functions and their parameters, as well as the need for clear and concise function signatures.

According to Martin, a well-written function should be easy to understand and clearly convey its purpose. It should be short enough to fit on a single screen and should not contain any unnecessary code or duplication. A function that is too long or complex can be difficult to understand and maintain and can lead to errors and bugs.

Duplication in code should be avoided because it can make the code difficult to understand and maintain. When the same code is repeated in multiple places, it can be hard to keep track of all the instances and ensure that they are all correct and up-to-date. If a change needs to be made to the code, it may need to be made in multiple places, which can be time-consuming and error-prone. Additionally, duplicated code can make the codebase larger and more difficult to navigate.

By avoiding duplication, we can make our code more readable, maintainable, and efficient. Instead of repeating the same code in multiple places, we can write a single function that performs the desired task and call that function whenever we need to perform the task. This allows us to keep our code DRY (Don’t Repeat Yourself), which can make it easier to understand and maintain. Additionally, by keeping our functions small and focused, we can make them more reusable and modular, which can make our code more flexible and adaptable.

One of the key principles of clean code is the fact that it should have One Level of Abstraction per Function—functions should have a single, well-defined purpose. This means that a function should only do one thing, and it should do it well. By following this principle, we can ensure that our functions are focused and easy to understand.

In addition to being focused, a well-written function should also have a clear and descriptive name. The name of a function should accurately reflect its purpose and should be easy to understand. This is important because a good name can help other developers quickly understand what a function does, without having to read through its entire code.

Another important aspect of clean code is the function signature, which is the part of the function that specifies its name, parameters, and return type. A good function signature should be clear and concise, and should not contain any unnecessary information. It should also use descriptive parameter names so that it is clear what each parameter represents.

In conclusion, writing clean and well-structured functions is an important part of software development. By following the principles outlined in Chapter 3 of “Clean Code,” we can ensure that our functions are small, focused, and easy to understand, which can help us avoid errors and bugs, and make our code more maintainable.

--

--

Ilolo Izu
Ilolo Izu

Written by Ilolo Izu

Software Engineer 👨🏾‍💻 | Advocating for Minorities in STEM | Track & Field World Record Holder