Refactor timediff program for improved readability and maintainability #5

[jeevanghimire]

Fixed Issue #5

Describe your changes

This pull request introduces a program written in C and C++ to read two time inputs in 24-hour format (hours, minutes, and seconds), compute the time difference between the two inputs, and add a specified number of seconds to one of the time inputs. The program carefully handles edge cases, such as when the time crosses midnight or when the first input time is greater than the second one.

The following functionalities have been added:

• A Time structure to represent time in hours, minutes, and seconds.
• Two functions:
  • time_difference() to calculate and return the difference between two time values.
  • add_seconds() to add a specified number of seconds to a given time value.
• Input handling for user-provided times and seconds to add.
• Proper formatting of the output to show time in HH:MM:SS format.
• Edge cases involving time wrapping at midnight are managed effectively.

Context

• This feature does not currently fix any open issues, but it enhances time management functionality within the application, improving overall usability.

Checklist before requesting a review

• [x] If it is a core feature, I have added thorough tests: Tests are included to validate the time_difference() and add_seconds() functions for various scenarios.
• [x] My code follows the style guidelines of this project: The code adheres to common coding standards for readability.
• [x] I have performed a self-review of my code: I have thoroughly reviewed the code for correctness and formatting.
• [x] I have commented my code, particularly in hard-to-understand areas: Key areas of the code contain comments for clarity.
• [x] I have made corresponding changes to the documentation: The documentation has been updated to reflect all modifications, including code explanation, usage, and example output.
• [x] I have only one commit (if not, squash them into one commit): All changes have been consolidated into one commit for clarity.
• [x] This PR is not a duplicate: This change is original and not related to any existing pull requests.

[axyut]

Everything looks great! Please include a screenshot of the terminal recreating the output you wrote(even though copying the output contents is better, this time in all the PRs we require a photo of output in the README.md Output Section), you can store the picture inside assets folder.

[jeevanghimire]

@axyut its done ;)