Click above to get retro games delivered to your door ever month!

DBSELECTAREA()

Change to another work area
---------------------------------------------------------------------------------

 Syntax

        DBSELECTAREA(<xArea>) --> NIL  

 Arguments

        <xArea>   Alias or work area    

 Returns

        DBSELECTAREA()   always returns NIL.    

 Description

      This function moves the Harbour internal primary focus to the work
      area designated by <xArea>. If <xArea> is numeric, them it will
      select the numeric work area;if <xArea> is character,then it will
      select the work area with the alias name.

      DBSELECTAREA(0) will select the next avaliable and unused work area.
      Up to 255 work areas are supported.Each work area has its own alias
      and record pointer, as well as its own
      FOUND(),DBFILTER(),DBRSELECT(),  and DBRELATION() function values.

 Examples

      FUNCTION Main()
      LOCAL nId
      USE Tests NEW INDEX Tests
      USE Tests1 NEW INDEX Tests1
      DBSELECTAREA(1)
      nId:=Tests->Id
      DBSELECTAREA(2)
      IF DBSEEK(nId)
         ? Tests1->cName
      ENDIF
      DBCLOSEALL()
      RETURN NIL

Status

      Ready

 Compliance

      This function is CA-CLIPPER compatible.

 Files

      Library is rdd