Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic

GetSuperFileNames

Retrieve superfile member name.

Short Name

GETMNAME()

Type

Low-Level function

Declaration

COUNT GetSuperFileNames(COUNT filno, pTEXT nambuf,

VRLEN buflen, COUNT memberNo)

Description

GetSuperFileNames() retrieves the superfile member name for member number memberNo in superfile filno. After successful execution, the nambuf array, which is buflen bytes long, contains the superfile member name for member number memberNo.

Return

Value

Symbolic Constant

Explanation

0

NO_ERROR

Successful operation.

101

INOT_ERR

Member name not found.

411

BSUP_ERR

filno is not a superfile number.

See c-tree Error Codes for a complete listing of valid c-tree error values.

Example

#define buflen 64

TEXT nambuf[buflen]; /* superfile member name buffer */

COUNT ret=0; /* function return */

COUNT membno; /* member # for loop control */


/*list superfile member names for superfile number 5 */

for (membno =1; ret == 0; membno ++)

{

if (ret=GetSuperFileNames(5,nambuf,buflen, membno))

printf("\nError on GETMNAME, error = %d decimal",

ret) ;

else

printf("\n%s is member #%d of superfile #5", nambuf, membno);

}

TOCIndex