QMClose()

 Top  Previous  Next

 

The QMClose() function closes a file. It is analogous to the QMBasic CLOSE statement.

 

The function takes a single argument, FileNo, which is the file number returned by a previous QMOpen() call.

 

The server maintains a list of files open for processing by the client application. The QMClose() function causes the server to close the specified file. It is not normally necessary to close files as there is no practical limit to the number of files that the server can hold open at once, however, for best performance applications should close files if they are unlikely to be referenced for a considerable time.

 

The program fragment in the examples below opens the CLIENTS file, reads the record identified by ClientNo, and then closes the file. A real program should test the error status from the read to determine if the action was successful.

 

 

hmtoggle_plus1C

void QMClose(int FileNo)

fClients = QMOpen("CLIENTS");

Rec = QMRead(fClients, ClientNo, Err);

QMClose(fClients);

 

Note that this example leaves variables Rec pointing to a dynamically allocated memory area that must be released using QMFree() when no longer needed.

 

hmtoggle_plus1VB.Net

QMClose ByVal FileNo as Integer

fClients = QMOpen("CLIENTS")

Rec = QMRead(fClients, ClientNo, Err)

QMClose(fClients)

 

 

hmtoggle_plus1QMBasic Class Module

Close(FileNo)

fClients = session->Open("CLIENTS")

Rec = session->Read(fClients, ClientNo, Err)

session->Close(fClients)

 

hmtoggle_plus1Java

Close(int FileNo)

fClients = qm.Open("CLIENTS");

Rec = qm.Read(fClients, ClientNo);

qm.Close(fClients);

 

hmtoggle_plus1Python

Close(FileNo)

fClients = qm.Open("CLIENTS")

Rec = qm.Read(fClients, ClientNo)

qm.Close(fClients)