DOC: Incorrect Syntax for TAG() and DESCENDING() Commands

ID: Q196025

The information in this article applies to:
  • Microsoft Visual FoxPro for Windows, versions 3.0, 3.0b, 5.0, 5.0a, 6.0

SUMMARY

In Visual FoxPro help the syntax for the TAG() and DESCENDING() commands incorrectly shows the "nTagNumber" and "nIndexNumber" arguments respectively as required when they are actually optional. If you run either of the commands, without any arguments, they return information for the controlling Index of a table that is open in the current work area.


MORE INFORMATION

The text of the TAG() and DESCENDING() functions in the Visual FoxPro Help notes that the syntax is as follows:

TAG([CDXFileName,] nTagNumber [, nWorkArea | cTableAlias])

DESCENDING([CDXFileName,] nIndexNumber [, nWorkArea | cTableAlias])
The text incorrectly shows the nTagNumber and nIndexNumber arguments, for TAG() and DESCENDING() functions respectively, as required.

The syntax should be as follows:
TAG([CDXFileName[, nTagNumber [, nWorkArea | cTableAlias]]])

DESCENDING([CDXFileName[, nIndexNumber [, nWorkArea | cTableAlias]]])
The nTagNumber and nIndexNumer arguments are optional. If nTagNumber or nIndexnumber are not specified, then the TAG() and DESCENDING() functions will return information for the controlling Index of the table that is open in the current Work Area. If there is no table open, in the current Work Area or a controlling index is not in place, then TAG() returns an empty string and DESCENDING() returns a False.

To test this issue, create and run a program with the following code: 

   CLEAR
   CLOSE ALL

   ?"Return values with no open Tables:"
      DO TagInfo

   CREATE DATABASE MyDbc
   CREATE TABLE MyTbl (Fld1 C(7) PRIMARY KEY, Fld2 C(4))
   INSERT INTO MyTbl VALUES("111-111","AAAA")
   INSERT INTO MyTbl VALUES("111-112","BBBB")
   INSERT INTO MyTbl VALUES("111-113","CCCC")

   ?"Return values with no controlling Index:"
      OPEN DATABASE MyDbc
      USE MyTbl
      DO TagInfo

   ?"Return values with controlling Index:"
      SET ORDER TO Fld1 DESCENDING
      DO TagInfo

   PROCEDURE TagInfo
      ?TAG()
      ?DESCENDING()

Additional query words:

Keywords : kbdocerr kbDatabase kbVFp300bbug kbVFp500abug kbVFp600bug kbXBase KbDBFDBC
Version : WINDOWS:3.0,3.0b,5.0,5.0a,6.0
Platform : WINDOWS
Issue type :


Last Reviewed: August 19, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.