pncurrency


Introduction

The PNCurrency library is a powerful tool for handling currency conversions and calculations in iOS apps. With an easy-to-use interface, it provides developers with the functionality to convert and perform mathematical operations with various currencies. Whether you need to display currency information, make calculations, or fetch exchange rates, the PNCurrency library has got you covered.


Features

  • Supports conversion between different currencies
  • Fetches the latest exchange rates from reliable sources
  • Handles mathematical operations with currencies
  • Formatted currency display for easy user readability
  • Supports custom exchange rate providers for flexibility


Installation

To get started with the PNCurrency library, follow the steps below:

  1. Open your Xcode project
  2. Navigate to your project’s Build Phases
  3. In the Link Binary With Libraries section, click the + button
  4. Search for PNCurrency.framework and add it to your project
  5. Import the PNCurrency module into your source code by adding the following line:
    import PNCurrency


Usage


Currency Conversion

To convert currencies using the PNCurrency library, follow the steps below:

  1. Create an instance of the CurrencyConverter class
  2. Specify the base currency and the target currency using their respective ISO codes
  3. Call the convert(amount:) method, passing the amount to be converted
  4. Receive the converted amount as the return value

Example:

// Create a currency converter instance
let converter = CurrencyConverter()

// Convert 50 USD to EUR
let result = converter.convert(amount: 50, from: "USD", to: "EUR")

print(result) // Output: 43.19 EUR

Fetching Exchange Rates

To fetch the latest exchange rates using the PNCurrency library, follow the steps below:

  1. Create an instance of the ExchangeRateFetcher class
  2. Specify the base currency using its ISO code
  3. Call the fetchExchangeRates(completion:) method, passing a completion block to handle the retrieved rates

Example:

// Create an exchange rate fetcher instance
let rateFetcher = ExchangeRateFetcher()

// Fetch exchange rates for USD
rateFetcher.fetchExchangeRates { (rates) in
    if let exchangeRates = rates {
        // Handle the retrieved exchange rates
        // Display or process the exchange rate data
    } else {
        print("Failed to fetch exchange rates.")
    }
}

Mathematical Operations

The PNCurrency library also provides functions for performing mathematical operations with currencies:

  • Addition: Use the add(_:) function to add two currency values
  • Subtraction: Use the subtract(_:) function to subtract one currency value from another
  • Multiplication: Use the multiply(by:) function to multiply a currency value by a constant factor
  • Division: Use the divide(by:) function to divide a currency value by a constant divisor

Example:

// Perform mathematical operations with currencies
let currencyA = PNCurrency("USD", value: 50)
let currencyB = PNCurrency("EUR", value: 30)

// Addition
let sum = currencyA.add(currencyB)

// Subtraction
let difference = currencyA.subtract(currencyB)

// Multiplication
let multiplied = currencyA.multiply(by: 2.5)

// Division
let divided = currencyB.divide(by: 2)

print(sum) // Output: 80 USD
print(difference) // Output: 20 USD
print(multiplied) // Output: 125 USD
print(divided) // Output: 15 EUR


Customization

If you need to customize the behavior of the PNCurrency library, you can implement a custom exchange rate provider by conforming to the ExchangeRateProvider protocol. This allows you to integrate your own API for fetching exchange rates or use another third-party service. Simply create a class or struct that conforms to the protocol and implement the required methods.


Conclusion

The PNCurrency library provides a reliable and easy-to-use solution for currency conversions, calculations, and fetching exchange rates in iOS apps. Whether you are working on a financial app, e-commerce platform, or any other application requiring currency operations, the PNCurrency library offers the necessary functionality to handle various currency-related tasks efficiently.