QMIns()

Top  Previous  Next

 

The QMIns() function inserts a field, value or subvalue in a dynamic array.

 

 

Format

 

VBQMIns(ByVal Src as String, ByVal Fno as Integer, ByVal Vno as Integer, ByVal Svno as Integer, ByVal NewData as String) as String

 

Cchar * QMIns(char * Src, int Fno, int Vno, int Svno, char * NewData)

 

where

 

Srcis the dynamic array to be processed

 

Fnois the number of the field to be inserted. If less than 1, 1 is assumed.

 

Vnois the number of the value to be inserted. If less than 1, an entire field is inserted.

 

Svnois the number of the subvalue to be inserted. If less than 1, an entire value is inserted.

 

NewDatais the new data to form the new dynamic array element.

 

 

The QMIns() function returns a new dynamic array with the specified field, value or subvalue inserted.

 

 

Note that in the C API library, a statement of the form

rec = QMIns(rec, 2, 1, 0, new_data)

will return a pointer to a newly allocated memory area, overwriting the rec pointer. The old memory is not freed by this call and it is therefore necessary to retain a pointer to the original rec string so that it can be freed later.