iban.h

Go to the documentation of this file.

#ifndef IBAN_H
#define IBAN_H

#ifdef __cplusplus

#include <iostream>
#include <fstream>
#include <sstream>
#include <vector>
#include <map>
#include <ctype.h>

class Iban
{
public:

  Iban();

  Iban(const Iban& iban);

  Iban(const std::string& iban, bool normalize = true);

  ~Iban();

  const std::string& transmissionForm() const {
    return m_transmission;
  }

  const std::string& printableForm() {
    if (m_printable.empty()) 
      m_printable = createPrintable();
    return m_printable;
  }

private:
  std::string m_transmission; 
  std::string m_printable;    

  static std::string createTransmission(const std::string& iban_str);
  std::string createPrintable() const;
};

class IbanCheck {
public:

  enum Result {
    // do not change anything here without changing
    // the initialisation of m_ResultText!
    OK = 0,            
    TOO_SHORT,         
    PREFIX_NOT_FOUND,  
    WRONG_LENGTH,      
    COUNTRY_NOT_FOUND, 
    WRONG_COUNTRY,     
    BAD_CHECKSUM,      
  };


  IbanCheck(const std::string& filename = "");

  ~IbanCheck();

  Result check(const Iban& iban, const std::string& country = "") const {
    return check(iban.transmissionForm(), country); }

  Result check(const std::string& iban, const std::string& country = "") const;

  Result bic_position(const std::string& iban, int& start, int& end) const;

  static const char *resultText(Result res);

  bool error() const { return m_IbanSpec.size() == 0; }

  bool selftest();

private:

  static const char *m_ResultText[];

  typedef std::vector<std::string> svector;

  struct Spec {
    std::string prefix;
    unsigned int length;
    unsigned int bic_start, bic_end;
    std::string example;
  };

  typedef std::map<std::string,Spec*> specmap;

  struct Country {
    std::string country;
    svector prefixes;
  };

  typedef std::map<std::string, Country*> countrymap;

  friend std::istream& operator>>(std::istream &is, Spec &spec);
  friend std::istream& operator>>(std::istream &is, Country &c);

  bool readSpecTable(std::istream &fin, const std::string& stopcomment);
  bool readCountryTable(std::istream &fin);
  static int to_number(char c) { return c - 'A' + 10; }
  static std::string iban2number(const std::string& iban);
  static int modulo97(const std::string& number);

  specmap m_IbanSpec;
  countrymap m_CountryMap;
};

typedef IbanCheck::Result IbanCheck_Result;
extern "C" {
#else /* __cplusplus */
  typedef struct IbanCheck IbanCheck;
  typedef struct Iban Iban;
  typedef int IbanCheck_Result;
#endif /* __cplusplus */

  /* @{ */

  IbanCheck *IbanCheck_new(const char *filename);
  void IbanCheck_free(IbanCheck *p);
  IbanCheck_Result IbanCheck_check_str(const IbanCheck *p,
                                              const char *iban,
                                              const char *country);
  IbanCheck_Result IbanCheck_check_iban(const IbanCheck *p,
                                               const Iban *iban,
                                               const char *country);
  IbanCheck_Result IbanCheck_bic_position(const IbanCheck *p, 
                                                 const char *iban,
                                                 int *start, int *end);
  const char *IbanCheck_resultText(IbanCheck_Result res);
  int IbanCheck_error(const IbanCheck *p);
  int IbanCheck_selftest(IbanCheck *p);
  /* @} */

  /* @{ */
  Iban *Iban_new(const char* iban, int normalize);
  void Iban_free(Iban *p);
  const char *Iban_transmissionForm(const Iban *iban);
  const char *Iban_printableForm(Iban *iban);
  /* @} */
#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif /* IBAN_H */