home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / STEVES / DBFAST.ZIP / READ.ME < prev   
Text File  |  1988-04-27  |  8KB  |  190 lines
  1. Changes made to dBFast not in the current manual.
  2.  
  3.         -> Set Softseek on/Off
  4.  
  5.         This will allow you to search for a record, and if the exact
  6.         record is not found will return the next record in sequence.
  7.         This will not effect the Set Relation To sequence.  If exact
  8.         records are not found in the related files those file will
  9.         still be set to EOF() = .t., FOUND() = .f., and RECNO() =
  10.         Number of records + 1.
  11.  
  12.         -> Insert command
  13.  
  14.         The only option we support in the INSERT command group is
  15.         INSERT BLANK.  In most situations it is probably smarter
  16.         and faster to use an Index however, for those of you who
  17.         do use this occasionally we have provided this version.
  18.         It doesn't matter which way you include it in your program.
  19.  
  20.  
  21.         -> The standard LIST/DISPLAY is changed so that if you specify
  22.         TO PRINTER it will do an automatic page break after every 60 lines.
  23.  
  24.         -> In the PACK command we ask if you are sure just as in all other
  25.         commands that do irretrievable operations on the files.  You can
  26.         disable this by just setting Safety Off, or at the end of the
  27.         command line put the HIDE modifier.  For example, PACK &&& Hide.
  28.  
  29.         -> Set Talk Off/ON
  30.  
  31.         This command differs from dBASE in that it does not
  32.         automatically display the results of all store's, etc.  The
  33.         results are the same as if you had included the HIDE option for
  34.         each command that does display anything. (If you set Talk OFF.)
  35.  
  36.         -> Deleted records
  37.  
  38.         In both EDIT and BROWSE a deleted record is denoted by
  39.         the asterisk '*'         next to the first field on the
  40.         screen.  And, as in dBASE you can toggle the Deleted Mark
  41.         on and off by continuing to press ^U.
  42.  
  43.         -> Insert On/Off
  44.  
  45.         To turn the insert mode on and off you press the Ins key just
  46.         like you normally would.  However, instead of putting a
  47.         message at the top or bottom of the screen dBFast will
  48.         change the cursor size.  In regular mode the cursor is
  49.         just a single or small line.  In insert mode the cursor will
  50.         be approximately twice that size or 1/2 the size of a
  51.         full block cursor.
  52.  
  53.         -> Set Filter To
  54.  
  55.         Is only supported in the mode in which the expression is stated
  56.         at compile time.
  57.  
  58.         -> Types of Indexes and how you search for them.
  59.  
  60.         If you created an index as a numeric or date index then the field
  61.         used in either a Find or Seek must be numeric or date.  You can
  62.         search for a numeric field with either a numeric or date field and
  63.         vice versa.  However, you cannot use a character field in either
  64.         situation nor can you use a numeric or date field to search a
  65.         character index.
  66.  
  67.         -> On escape/error/key note:
  68.  
  69.         You can only use the DO command in conjunction with the ON command.
  70.         For example -> ON ERROR DO ERR_OPT WITH X,Y,Z  is legal, however,
  71.         ON ERROR ? "ERROR" is not.
  72.  
  73.         -> New command - SET EXPRESSION <expression> TO <field>
  74.         This is the same as the typical dBASE usage as:
  75.  
  76.                 for_spec = 'X = Y+1'
  77.  
  78.                 DISPLAY ALL FOR &for_spec
  79.  
  80.         The same code in dBFast will look as follows:
  81.  
  82.                 SET EXPRESSION x = y+1 TO for_spec
  83.  
  84.                 DISPLAY ALL FOR for_spec
  85.  
  86.         Note that we don't put an ampersand (&) before the field
  87.         for_spec.  dBFast will evaluate any expression field when
  88.         used, however, if it is a macro field (preceeded with an
  89.         ampersand) then the program will try to find a matching
  90.         field in the field buffer.
  91.  
  92.         You can also do other things with this same expression.  For
  93.         example, the following:
  94.  
  95.                 x = 10
  96.                 set expr x * 5 to y     && Sets the expression into the field Y
  97.                 ? y                     && In this case the value printed is 50
  98.                 x = 40
  99.                 ? y                     && In this case the value printed is 200
  100.  
  101.         Note that we didn't have to re-execute the expression itself.  All we
  102.         did was change a value in the expression.  This will also work just as
  103.         well with a complex expression or if multiple values change in the same
  104.         expression.  This should solve the problem with needing to evaluate
  105.         expressions during runtime.  The only change you would make in your
  106.         code is to use the SET EXPRESSION command where you would normally just
  107.         use the STORE TO or simple '=' command.  The rest would work just like
  108.         you are use to.  The catch is that you cannot imbed macros within the
  109.         expression.  It has to be fields or constants only.
  110.  
  111.         At this time you cannot yet use imbedded macros in a field.
  112.         You can, however, add the line which will create the field
  113.         name and then pass dBFast the new name as a single
  114.         macro.  For example, if you have a field called
  115.         BUDGET and there are actually 12 elements in this
  116.         'pseudo-array' BUDGET11 to BUDGET22 (we use this
  117.         form of 11 to 22 to keep from having to do another
  118.         line).  The total field name could be created by
  119.         doing the following:
  120.  
  121.                 fld_name = 'BUDGET' + str(month+10,2,0)
  122.                 @ 1,1 say 'Enter budget amount ' get &fld_name
  123.  
  124.  
  125.         Note the ampersand (&) before the field (&fld_name) above.  In
  126.         this case we wanted to get the actual field not just the name.
  127.  
  128.         You could also have used the command:
  129.  
  130.                 SET EXPRESSION 'BUDGET' + str(month+10,2,0) TO FLD_NAME
  131.  
  132.         earlier, and then just before the @..say..get command
  133.         do:
  134.  
  135.                 MONTH = month(date())
  136.                 @ 1,1 say 'Enter budget amount ' get &fld_name
  137.  
  138.         Or any other similar command.
  139.  
  140.         Another variation of this same routine is:
  141.  
  142.                 USE filename
  143.                 X = field(1)
  144.                 @ 1,1 say X get &X
  145.  
  146.         Note that in the say portion above the first time X is evaluated
  147.         the program will print the name of the field within the file.  The
  148.         second time, or &X, the program will use the field value.  Also
  149.         note that we didn't use the SET EXPRESSION command here.  Since
  150.         'X' will have the entire field name and no expression needs to be
  151.         evaluated we DO NOT use the SET EXPRESSION command.  This would also
  152.         work in the situation where you want to use a macro for the EQUAL
  153.         or STORE .. TO command.  For example:
  154.  
  155.                 if choice = 1
  156.                         x = 'A1'
  157.                 else
  158.                         x = 'B1'
  159.                 endif
  160.                 &x = 100
  161.  
  162.         In this example if choice = 1 is .T. then A1 will be set to 100,
  163.         otherwise B1 will be set to 100.  If you do try to use the SET
  164.         EXPRESSION command when the field name is just a single constant
  165.         you will get a runtime error.
  166.  
  167.         We have tried to make dBFast much more versatile in its use of
  168.         macros.  We hope this will help.  You are encouraged to experiment
  169.         with their usage.  If it won't work the program will tell you.
  170.  
  171.  
  172. What this version doesn't include:
  173.  
  174.         -> This release of dBFast does not allow CHAIN'ing with parameters.
  175.         A future version will allow parameters and multi-level chaining.
  176.  
  177.         -> Extended memory is not used in this version.
  178.  
  179. Other Extras:
  180.  
  181.         We have included 3 files on the disk.  These are: DS; EDIT;
  182.         and BROWSE.  There is a .PRG and .EXE for each.  These are simple
  183.         programs but can be used as utilities.
  184.  
  185.         DS will display the structure of a file name you enter.
  186.         EDIT will edit a file, doesn't use indexes.
  187.         BROWSE will browse a file, doesn't use indexes.
  188.  
  189.  
  190.