[New Algorithm] - Triangular Numbers (#10663)

* Add New Algorithm: Triangular Numbers

* Calculate nth triangular number instead of generating a list

* Handle 0th position and update function name and docstring
This commit is contained in:
Tauseef Hilal Tantary 2023-10-23 19:21:09 +05:30 committed by GitHub
parent d051db1f14
commit 4cbefadbd7
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -0,0 +1,43 @@
"""
A triangular number or triangle number counts objects arranged in an
equilateral triangle. This module provides a function to generate n'th
triangular number.
For more information about triangular numbers, refer to:
https://en.wikipedia.org/wiki/Triangular_number
"""
def triangular_number(position: int) -> int:
"""
Generate the triangular number at the specified position.
Args:
position (int): The position of the triangular number to generate.
Returns:
int: The triangular number at the specified position.
Raises:
ValueError: If `position` is negative.
Examples:
>>> triangular_number(1)
1
>>> triangular_number(3)
6
>>> triangular_number(-1)
Traceback (most recent call last):
...
ValueError: param `position` must be non-negative
"""
if position < 0:
raise ValueError("param `position` must be non-negative")
return position * (position + 1) // 2
if __name__ == "__main__":
import doctest
doctest.testmod()