FILELEV

Contents


filelev returns the "locality level" of the open tables.

 

Syntax

   filelev(< class | num_exp >)

 

Parameters

Element

Description

Restrictions

class

Describes the abbreviation of a table

The class must exist.

num_exp

Numeric expression that describes a table

num_exp >= 0

 

Examples

   # Names and "locality levels" of the open tables
   # in the current application
    Libelle I, NBFIL
    I = 1:  NBFIL = 25
    Repeat
       infbox filename(I)-num$(filelev(I))
       I += 1
    Until I > NBFIL

 

Description and Comments

filelev returns the "locality level" of a table for which the abbreviation or internal number is given in parameters (used by Adonix). The value zero (0) means that the table is not open; one (1) that it was opened in a process in the Nth subroutine "embedded" by the Call instruction.

If you give an abbreviation as a parameter, the table must be open. The internal number (used by Adonix) corresponds to the line number in the list of open tables displayed in the debugger, and starts with one (1). No error is returned when a numeric parameter does not correspond to a single open table, since the function returns the value zero (0).

The result of the function is of the Integer type.

 

Associated Errors

Error

Description

vERCLAS (7)

Class does not exist

ERDOM (50)

exp_num < 0.

 

Associated Keywords

FILE - FILENAME - CLOSE - FILE - MASKLEV - CALL


CONTENTS

 

 


Copyright © Sage 1999 - 2007