Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Finance::Currency::ConUser:ContributednPere::Currency::Convert::WebserviceX(3)

NAME
       Finance::Currency::Convert::WebserviceX - Lightweight currency
       conversion using	WebserviceX.NET

SYNOPSIS
	   use Finance::Currency::Convert::WebserviceX;
	   my $cc = Finance::Currency::Convert::WebserviceX->new;
	   my $result =	$cc->convert(1.95, 'USD', 'JPY');

DESCRIPTION
       This is a lightweight module to do currency conversion using the
       Currency	Converter web service at http://www.webservicex.net/.

       The motivation for this module was many fold. First,
       Finance::Currency::Convert with Finance::Quote was a little too bulky
       for my needs, esp the need to download or maintain conversion tables.
       Finance::Currency::Convert::Yahoo seemed	to be based on screen
       scraping. Way to	fragile	for my taste. Finance::Currency::Convert::XE
       has usage restrictions from XE.com. [No offense intended	to any of the
       authors above]

CONSTRUCTOR
       You know	the routine. "new" is your friend.

	   use Finance::Currency::Convert::WebserviceX;
	   my $cc = Finance::Currency::Convert::WebserviceX->new;

METHODS
   convert($value, $from, $to)
       Converts	a number value from one	currency to another and	returns	the
       result.

	   my $result =	$cc->convert(1.95, 'USD', 'JPY');

       If an error occurs, no value is given, or the from/to aren't 3 letter
       currency	codes, "convert" returns "undef".

       For now,	you can	access the request response after calling C>convert>:

	   my $response	= $self->{'response'};

       This returns a HTTP::Response object that can be	used to	inspect	any
       remote web service errors. $self->response{'request'} is	reset at the
       beginning of every call to "convert" and	returns	"undef"	otherwise.

       value
	   The number or price to be converted.

       from
	   The three letter ISO	currency code for the currency amount
	   specified in	"value". See Locale::Currency for the available
	   currency codes.

       to  The three letter ISO	currency code for the currency you want	the
	   "value" to be converted to. See Locale::Currency for	the available
	   currency codes.

   cache
       Gets the	reference to the cache hash.

SEE ALSO
       Locale::Currency, Finance::Currency::Format, Memoize::Expire

AUTHOR
	   Christopher H. Laco
	   CPAN	ID: CLACO
	   claco@chrislaco.com
	   http://today.icantfocus.com/blog/

perl v5.32.1			  20Finance::Currency::Convert::WebserviceX(3)

NAME | SYNOPSIS | DESCRIPTION | CONSTRUCTOR | METHODS | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Finance::Currency::Convert::WebserviceX&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help