join.py

"""
Program to join a list of strings with a separator
"""


defjoin(separator: str, separated: list[str]) ->str:
"""
 Joins a list of strings using a separator
 and returns the result.

 :param separator: Separator to be used
 for joining the strings.
 :param separated: List of strings to be joined.

 :return: Joined string with the specified separator.

 Examples:

 >>> join("", ["a", "b", "c", "d"])
 'abcd'
 >>> join("#", ["a", "b", "c", "d"])
 'a#b#c#d'
 >>> join("#", "a")
 'a'
 >>> join(" ", ["You", "are", "amazing!"])
 'You are amazing!'
 >>> join(",", ["", "", ""])
 ',,'

 This example should raise an
 exception for non-string elements:
 >>> join("#", ["a", "b", "c", 1])
 Traceback (most recent call last):
 ...
 Exception: join() accepts only strings

 Additional test case with a different separator:
 >>> join("-", ["apple", "banana", "cherry"])
 'apple-banana-cherry'
 """

# Check that all elements are strings
forword_or_phraseinseparated:
# If the element is not a string, raise an exception
ifnotisinstance(word_or_phrase, str):
raiseException("join() accepts only strings")

joined: str=""
"""
 The last element of the list is not followed by the separator.
 So, we need to iterate through the list and join each element
 with the separator except the last element.
 """
last_index: int=len(separated) -1
"""
 Iterate through the list and join each element with the separator.
 Except the last element, all other elements are followed by the separator.
 """
forword_or_phraseinseparated[:last_index]:
# join the element with the separator.
joined+=word_or_phrase+separator

# If the list is not empty, join the last element.
ifseparated!= []:
joined+=separated[last_index]

# Return the joined string.
returnjoined


if__name__=="__main__":
fromdoctestimporttestmod

testmod()