QMWriteSeqKey()

 Top  Previous  Next

 

The QMWriteSeqKey() function writes a record using an automatically generated sequential numeric key. This is analogous to use of the CREATING.SEQKEY option of the QMBasic WRITE statement.

 

The function arguments are:

 

FileNois the file number returned by a previous QMOpen() call.

 

Idis the id of the record.

 

Recis the data to be written to this record.

 

 

The QMWriteSeqKey() function writes the given data to the hashed file opened as FileNo. The record id is automatically generated and returned as the value of this function. This operation is not valid for directory files or distributed files.

 

An update lock is automatically applied to this record for the duration of the internal processing of the write and released before returning from the function.

 

The example program fragments below write the data in ClientRec to the file open as fClients. The record id is generated automatically and returned in the Id variable.

 

 

hmtoggle_plus1C

char * QMWriteSeqKey(int FileNo, char * Rec)

Id = QMWriteSeqKey(fClients, ClientRec);

printf("New id is '%s'\n", Id);

QMFree(Id);

 

The returned pointer references a dynamically allocated memory area that must be released using QMFree() when no longer needed.

 

hmtoggle_plus1VB.Net

QMWriteSeqKey(ByVal FileNo as Integer, ByVal Rec as String) as String

Id = QMWriteSeqKey(fClients, ClientRec)

 

hmtoggle_plus1QMBasic Class Module

WriteSeqKey(FileNo, Rec)

Id = session->WriteSeqKey(fClients, ClientRec)

 

hmtoggle_plus1Java

String WriteSeqKey(int FileNo, String Rec)

Id = qm.WriteSeqKey(fClients, ClientRec);

System.out.printf("New id is '%s'%n", Id);

 

hmtoggle_plus1Python

WriteSeqKey(FileNo, Rec)

Id = qm.WriteSeqKey(fClients, ClientRec)

print("New id is ", Id)