home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / SUMUP / SUMUP.REA < prev    next >
Text File  |  1995-06-07  |  4KB  |  111 lines
  1. SAMPLE - SumUp
  2.  
  3.    DESCRIPTION:
  4.         This program uses a bag in which it stores integers. Then the
  5.         program iterates over the bag in two different ways:
  6.  
  7.         o   An Iterator Object is used to iterate over the bag to obtain
  8.             the sum of the contained integers.
  9.         o   An Iterator Function is used to iterate over the bag to
  10.             obtain the sum of the contained integers.
  11.  
  12.         If, for example you want to store and add the integers 1, 3, 4,
  13.         7, you invoke the program with the following command:
  14.  
  15.              sumup 1 3 4 7
  16.  
  17.    TASK:
  18.         This program iterates over a collection in different ways.
  19.  
  20.    CONCEPT/FEATURE:
  21.         This program is a sample to demonstrate the use of an iterator
  22.         object and an iterator function.
  23.  
  24.    PROJECT LOCATION:
  25.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  26.         folder).
  27.  
  28.    SOURCE FILE LOCATION:
  29.         X:\ibmcpp\samples\ioc\sumup
  30.  
  31.         where X: is the drive you installed the samples and document
  32.         component of VisualAge C++.
  33.  
  34.    HOW TO RUN THE SAMPLE:
  35.  
  36.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  37.              To run the prebuilt project, open the Samples folder on your
  38.              OS/2 desktop then double-click on the project's icon to open
  39.              the project view of the sample.  Click on the RUN button of
  40.              the project's toolbar.
  41.  
  42.         FROM THE COMMAND LINE:
  43.              Simply type the name of the .EXE file, that is:
  44.  
  45.                  SUMUP
  46.  
  47.              If the sample fails to execute or abnormally ends, you can
  48.              get more information about the failure by turning on the
  49.              ICLUI trace.  This is done by setting the environment
  50.              variable ICLUI_TRACE as follows:
  51.  
  52.                    SET ICLUI_TRACE=ON
  53.                    SET ICLUI_TRACETO=STDERR
  54.  
  55.              The second export controls where the trace information is
  56.              reported.  With tracing turned on, ICLUI exception text will
  57.              be written to a standard error file. For example:
  58.  
  59.                    HELLO1 >HELLO1.OUT 2>&1
  60.  
  61.              The exception data is now in the file hello1.out.
  62.  
  63.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  64.  
  65.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  66.              Open the Samples folder on your OS/2 desktop then
  67.              double-click on the project's icon to open the project view
  68.              of the sample. In the upper half of the project window you
  69.              will see the icons of the files associated with the sample.
  70.              From the Project pulldown, select Build -> Rebuild All. To run
  71.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  72.  
  73.         FROM THE COMMAND LINE:
  74.              A command file is provided to allow rebuilding of the
  75.              WorkFrame projects from the command line.  Simply type:
  76.  
  77.                  BUILD
  78.  
  79.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT
  80.              above.
  81.  
  82.    SOFTWARE/HARDWARE PREREQUISITES:
  83.  
  84.         o   IBM VisualAge C++
  85.         o   OS/2 2.1 or Warp
  86.         o   IBM or compatible 386 and up.
  87.  
  88.    ADDITIONAL INFORMATION:
  89.  
  90.         o   For more information on the creation and use of projects in
  91.             the WorkFrame environment, see the VisualAge C++ for OS/2
  92.             User's Guide.
  93.         o   For more information on the Collection Classes, see the
  94.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  95.  
  96.         Both books can be found online.  To access an online book, simply
  97.         open the main VisualAge C++ desktop folder, then open the
  98.         Information Folder inside.  To view a book, double-click on that
  99.         book's icon.
  100.  
  101.  
  102.   REQUIRED FILES:
  103.  
  104.    o   sumup.rea
  105.    o   build.cmd
  106.    o   sumup.cpp
  107.    o   sumup.xpc
  108.    o   sumup.exe
  109.  
  110.  
  111.