home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 565a.lha / CurrencyConvert_v1.5 / Convert.doc.pp / Convert.doc
Encoding:
Text File  |  1991-11-10  |  8.6 KB  |  221 lines
  1.  
  2.  
  3.                        Currency Convert   ® v1.5 1991
  4.                        ______________________________
  5.  
  6.                            Written by Ian Steuart
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                What is Currency Convert you may ask?
  15.  
  16.     Well, hopefully the name gives a little bit away as to its origin. It
  17. is an exchange rate conversion program born out of frustration, due to my
  18. never having seen any other similar program in the Public Domain for the
  19. AMIGA. 
  20.     
  21.     In its simplest form it will Convert a given Currency over
  22. to one of three Countries formats.  Namely:- 
  23.  
  24.  
  25.                             Sterling to Australian
  26.                             Australian to Sterling
  27.                             U.S. to Australian
  28.                             Australian to U.S.
  29.                             Sterling to U.S.
  30.                             U.S. to Sterling 
  31.  
  32.  
  33.     I often read overseas AMIGA magazines to compare Software/Hardware
  34. prices with those here in Australia and have often wished there was a
  35. quicker way than using the calculator to work out the exchange rate between
  36. Australia and U.S.A. or Australia and England etc.... Plus I can never
  37. remember the exchange rate any way, and often end up ringing the bank or
  38. grabbing the daily NewsPaper to look up the exchange rate for the day.
  39.  
  40.     Currency Convert I hope will solve part of that problem.
  41.  
  42.     Supposing you see in a U.S. magazine a software program costing
  43. around $ 400.50, it would be nice to know how much in Australian Dollars
  44. that would be so that a comparison could be made with Australian prices.
  45. Whilst it is always best to buy from your home Countries dealer, if you work
  46. on a tight monetary budget, it is on occasions, sometimes a little cheaper
  47. to buy from overseas.
  48.  
  49.     Hence, here now enters Currency Convert.
  50.  
  51.     This program will take input from the user, of say $ 200.50 plus
  52. if you know it, the exchange rate between the Countries concerned
  53. ( converting U.S. $ to Australian $ ). Enter Exchange rate of $ 78.40,
  54. then the converted amount of Australian $ 255.74 will be output.
  55.  
  56.     When designing the layout of the program I went to great lengths to
  57. ensure that it was V E R Y user friendly. I have attempted to catch every
  58. ERROR that could possibly be input so that the outputted money figure will
  59. always be as accurate as possible ( of course dependent on accurate exchange
  60. rate input from the user ). The program can be started from the both the
  61. CLI and WORKBENCH and will sense from which mode it is provoked and thus
  62. the startup procedures will vary slightly, as will be explained below.
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         CLI STARTUP
  69.     
  70.     At the CLI prompt type program name ( from here on called Convert as 
  71. it appears in its release form ) with no additional arguments. After
  72. selecting <RETURN>, the screen display will consist of a HELP menu explaining
  73. its operation which is fairly self explanatory. The allowable arguments for
  74. provoking the exchange rate conversions are:-
  75.  
  76.  
  77.     Sterling to Australian, type > Convert [ea]  [-r]
  78.     Australian to Sterling, type > Convert [ae]  [-r]
  79.     U.S. to Australian,     type > Convert [ua]  [-r]
  80.     Australian to U.S.,     type > Convert [au]  [-r]
  81.     Sterling to U.S.,       type > Convert [eu]  [-r]
  82.     U.S. to Sterling,       type > Convert [ue]  [-r]
  83.  
  84.  
  85.     There is a second argument that can be used if you wish, following
  86. the country of origin option and that is [-r].
  87.     What this does will leave you in the [Re-enter Mode] so that after
  88. each conversion is completed, instead of the CLI prompt returning, you will
  89. be prompted for a new conversion option ie: [ue]. This loop will
  90. continue until you have enjoyed dreaming of cheaper prices and decide to
  91. QUIT the program - this can be done at  A N Y   P R O M P T  that appears in
  92. Convert by simply typing the letter "Q" and selecting <RETURN>.
  93.  
  94.     There are a number of additional options available to the user once
  95. the first prompt appears....
  96.  
  97.  
  98.  
  99.     USAGE: Converts Australian $ to U.S. $
  100.            
  101.     Enter amount in Australian Dollars $ 200.50           - 1st prompt
  102.  
  103.     Enter U.S./Australian exchange rate in cents ¢ 78.40  - 2nd prompt
  104.  
  105.     
  106.     Converted to Australian Dollars  =  $ 255.74 ¢        - amount to pay
  107.  
  108.  
  109.  
  110.  
  111.  
  112.     
  113.     FIRST PROMPT 
  114.  
  115.     Entering "?" will display a the currently known exchange rate as of
  116. the date when this program was completed "06/11/91"
  117. This action can also occur at the second prompt.
  118.  
  119.     Type in "m" and this will abort the current conversion status and
  120. return you to a menu of options and selector prompt.
  121. This action can also occur at the second prompt.
  122.  
  123.     Entering "h" will display an extensive display of all the arguments
  124. available to the user from within the program as explained above.
  125. This action can also occur at the second prompt.
  126.  
  127.     In addition there is full ERROR CHECKING. Try a few errors of say 
  128. alphabetical input, number input lower than 5, control codes or whatever and 
  129. unless there is something I have missed, you should get back an error report!!
  130.  
  131.  
  132.  
  133.  
  134.  
  135.     SECOND PROMPT
  136.  
  137.     Entering "b" will abort the prompt and return you to the first prompt.
  138. This function is useful in case you realize that the input at the 1st prompt
  139. is incorrect and you wish to change it.
  140.  
  141.     Enter in "d" and this will type out a default exchange rate I have
  142. encoded in that was current as of "06/11/91". This is an active function
  143. and will actually complete the calculation resulting in an answer displayed.
  144. This function is only meant as an example but is useful if you are only after
  145. an idea of an approximate exchange rate value.
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.     WORKBENCH STARTUP
  153.     
  154.      If beginning Convert from the workbench icon(.info), naturally the
  155. startup arguments cannot be switched in at program execution, so I have allowed
  156. optional input to be selected after Convert is run.
  157.     Clicking on the program icon will result in an output window opening up
  158. of 604 X 200 (ntsc size) in which will appear the following display....
  159.  
  160.     
  161.     
  162.     O P T I O N S  M E N U             
  163.                                    
  164.     Sterling to Australian, type "ea"  
  165.     Australian to Sterling, type "ae"  
  166.     U.S. to Australian,     type "ua"  
  167.     Australian to U.S.,     type "au"  
  168.     Sterling to U.S.,       type "eu"  
  169.     U.S. to Sterling,       type "ue"  
  170.                                    
  171.                                    
  172.             
  173.     Enter your selection :   
  174.  
  175.  
  176.  
  177.     After entering selection and <RETURN> the program will operate
  178. fairly much the same as when in the CLI mode with one exception. If you enter
  179. at the prompt "h" you will find a fairly extensive HELP display that is
  180. along similar lines to that displayed if run from the CLI with no arguments.
  181. This feature was added to allow new WORKBENCH users to gain additional HELP
  182. if unsure of some of the programs features. This display like all others is
  183. based on a timing feature and will display for a preset amount of time and
  184. then return to a prompt etc - if you find it is not long enough then hit the
  185. space bar once, and when finished reading, hit <RETURN> and the program will
  186. continue.....
  187.  
  188.  
  189.     Remember, at any prompt regardless from where "CONVERT" was begun,
  190. typing in the letter "Q" will abort the program.
  191.     All input incidently is NOT CASE SENSITIVE.
  192.  
  193.     The selection of Countries that I used for this version of "CONVERT"
  194. was based on the where I currently peruse pricing of Software/Hardware. I am
  195. quite happy to encode other exchange rates into the program only if I am
  196. provided with full details including the exchange rate between the nominated
  197. countries.
  198.  
  199.      Any compliments "good or bad" about "CONVERT" would be
  200. appreciated, so I would love to hear from you at the address indicated below. 
  201.  
  202.  
  203.     Hope you find a use for "CONVERT" and that it becomes a useful addition
  204. to your program requirements!!
  205.  
  206.  
  207.  
  208.  
  209.  
  210.     Have Fun!!!!                Author Ian Steuart
  211.  
  212.                                                11 St. Georges Terrace
  213.                                             Bellevue Heights
  214.                                                Adelaide S.A. 5050
  215.                                             Australia.
  216.  
  217.                                             Phone (08) 276.4817 
  218.     
  219.  
  220.  
  221.