Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rkstudio585/currency-converter-c
A command-line tool for converting between various currencies. It supports a wide range of currencies with dynamic input, real-time conversion, and error handling for invalid inputs. Simple to use and easy to update with current exchange rates.
https://github.com/rkstudio585/currency-converter-c
c c-script conversater currency currency-converter program rk rk-studio
Last synced: 6 days ago
JSON representation
A command-line tool for converting between various currencies. It supports a wide range of currencies with dynamic input, real-time conversion, and error handling for invalid inputs. Simple to use and easy to update with current exchange rates.
- Host: GitHub
- URL: https://github.com/rkstudio585/currency-converter-c
- Owner: rkstudio585
- Created: 2024-09-01T01:48:22.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-09-01T02:35:31.000Z (4 months ago)
- Last Synced: 2024-11-07T16:16:24.178Z (about 2 months ago)
- Topics: c, c-script, conversater, currency, currency-converter, program, rk, rk-studio
- Language: C
- Homepage: https://github.com/mdriyadkhan585
- Size: 13.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Currency-Converter-C
[In Python3](https://github.com/mdriyadkhan585/Currency-Converter)
---
# Currency Converter
## Overview
The Currency Converter is a command-line utility written in C that allows users to convert amounts between different currencies. The tool supports a broad range of currencies and provides an easy-to-use interface for real-time currency conversion. The program uses exchange rates relative to USD, making it a versatile tool for various currency conversion needs.
## Features
- **Multi-Currency Support**: Convert between a wide range of currencies.
- **Dynamic Currency Input**: Enter currency codes and amounts dynamically.
- **Error Handling**: Handles invalid currency codes and amounts gracefully.
- **Customizable Exchange Rates**: Easily update exchange rates in the source code.
- **Simple Interface**: User-friendly command-line interface.
## Supported Currencies
---
# **Only Input UpperCase Character in command line**
---
The Currency Converter supports the following currencies:
- **USD**: United States Dollar
- **EUR**: Euro
- **JPY**: Japanese Yen
- **GBP**: British Pound Sterling
- **AUD**: Australian Dollar
- **CAD**: Canadian Dollar
- **CHF**: Swiss Franc
- **CNY**: Chinese Yuan
- **SEK**: Swedish Krona
- **NZD**: New Zealand Dollar
- **MXN**: Mexican Peso
- **SGD**: Singapore Dollar
- **HKD**: Hong Kong Dollar
- **NOK**: Norwegian Krone
- **KRW**: South Korean Won
- **TRY**: Turkish Lira
- **RUB**: Russian Ruble
- **INR**: Indian Rupee
- **BRL**: Brazilian Real
- **ZAR**: South African Rand
- **BDT**: Bangladeshi Taka
- **PKR**: Pakistani Rupee
- **THB**: Thai Baht
- **MYR**: Malaysian Ringgit
- **IDR**: Indonesian Rupiah
- **SAR**: Saudi Riyal
- **AED**: United Arab Emirates Dirham
- **CLP**: Chilean Peso
- **COP**: Colombian Peso
- **PEN**: Peruvian Nuevo Sol
- **DZD**: Algerian Dinar
- **EGP**: Egyptian Pound
- **MAD**: Moroccan Dirham
- **KWD**: Kuwaiti Dinar
- **BHD**: Bahraini Dinar
- **JOD**: Jordanian Dinar
- **OMR**: Omani Rial
- **LKR**: Sri Lankan Rupee
- **VND**: Vietnamese Dong
- **HUF**: Hungarian Forint
- **CZK**: Czech Koruna
- **PLN**: Polish Zloty
- **RON**: Romanian Leu
- **HRK**: Croatian Kuna
- **ISK**: Icelandic Króna
- **DOP**: Dominican Peso
- **NAD**: Namibian Dollar
- **MUR**: Mauritian Rupee
- **BMD**: Bermudian Dollar
## How It Works
1. **User Input**:
- The user provides the source currency code (e.g., USD).
- The user provides the target currency code (e.g., EUR).
- The user enters the amount to convert.
2. **Currency Lookup**:
- The program retrieves exchange rates for the specified currencies.
- The amount is converted to USD using the source currency's exchange rate.
3. **Conversion**:
- The amount in USD is then converted to the target currency using its exchange rate.
4. **Output**:
- The program displays the converted amount in the target currency.
## Building and Running
### Prerequisites
- **C Compiler**: Ensure you have a C compiler installed, such as `gcc`.
### Compilation
To compile the program, navigate to the directory containing `currency_converter.c` and use the following command:
```sh
git clone https://github.com/mdriyadkhan585/Currency-Converter-C
cd Currency-Converter-C
```
```sh
gcc -o currency_converter currency_converter.c
```
This will generate an executable file named `currency_converter`.
### Running the Program
Execute the compiled binary with:
```sh
./currency_converter
```
### Using the Program
1. **Enter the Source Currency Code**: Type the 3-letter currency code of the source currency (e.g., `USD`).
2. **Enter the Target Currency Code**: Type the 3-letter currency code of the target currency (e.g., `EUR`).
3. **Enter the Amount**: Provide the amount to convert in the source currency.
The program will display the converted amount in the target currency.
#### Example
```sh
./currency_converter
Enter the source currency code (e.g., USD): USD
Enter the target currency code (e.g., EUR): EUR
Enter amount to convert: 100
Converted amount: 93.00 EUR
```
This example converts 100 USD to EUR, displaying 93.00 EUR.
## Customization
### Updating Exchange Rates
To update exchange rates, modify the `currencies` array in `currency_converter.c` with the latest rates. Ensure that each currency's rate is updated relative to USD.
### Adding New Currencies
1. Add the currency code, full name, and exchange rate to the `currencies` array.
2. Ensure that the new currency code follows the 3-letter format and update the rates accordingly.
## Error Handling
The program handles:
- **Invalid Currency Codes**: If an invalid currency code is entered, the program will display an error message.
- **Invalid Amounts**: Non-numeric or negative amounts will trigger an error message.
## Contributing
Contributions to improve the Currency Converter are welcome. You can:
- Submit pull requests to add features or fix bugs.
- Open issues for reporting bugs or requesting new features.
## Contact
For questions or support, please contact [[email protected]](mailto:[email protected]).
---