px_put_recordn(3) [debian man page]

PX_PUT_RECORDN(3)					     Library Functions Manual						 PX_PUT_RECORDN(3)

NAME

       PX_put_recordn -- Stores record in Paradox file at certain position

SYNOPSIS

       #include <paradox.h>

       int PX_put_recordn(pxdoc_t *pxdoc, char *data, int recpos)

DESCRIPTION

       Stores  a  record  in the buffer data into a Paradox file at the given position recpos.	The first position has number 0. The function will
       determine the data block for this record. If the position is after the last data block, then as many as needed empty data  blocks  will	be
       added.  If the position is in the middle of a data block and there is no record right before the position, then the position will be recal-
       culated to make sure the new record will be stored in the first free slot of the datablock. For example, if a datablock contains H  records
       and  the first call of PX_put_recordn wants to store a record at postion 11, then this will be corrected to position H. PX_put_recordn will
       also add an empty data block and store the record as the first record of the second data block.	Storing a second  record  at  position	11
       again, will be executed without any position change.

       data  must  be constructed with PX_put_data_xxx(3) functions before. It is of the same structure as the record returned by PX_get_record(3)
       and PX_get_record2(3).

RETURN VALUE

       Returns the record position on success and -1 on failure. The first position has number 0.

SEE ALSO

       PX_get_record(3), PX_get_record2(3), PX_put_record(3),  PX_put_data_byte(3),  PX_put_data_short(3),  PX_put_data_long(3),  PX_put_data_dou-
       ble(3), PX_put_data_alpha(3)

AUTHOR

       This manual page was written by Uwe Steinmann uwe@steinmann.cx.

																 PX_PUT_RECORDN(3)

PX_GET_RECORD2(3)					     Library Functions Manual						 PX_GET_RECORD2(3)

NAME

       PX_get_record2 -- Returns record in Paradox file

SYNOPSIS

       #include <paradox.h>

       int PX_get_record2(pxdoc_t *pxdoc, int recno, char *data, int *deleted, pxdatablockinfo_t *pxdbinfo)

DESCRIPTION

       This  function is similar to PX_get_record(3) but takes two extra parameters. If *deleted is set to 1 the function will consider any record
       in the database, even those which are deleted. If *pxdbinfo is not NULL, the function will return some information  about  the  data  block
       where the record has been read from. You will have to allocate memory for pxdbinfo before calling PX_get_record2.

       On return *deleted will be set to 1 if the requested record is deleted or 0 if it is not deleted. The struct pxdatablockinfo_t has the fol-
       lowing fields:

       blockpos (long)
		 File positon where the block starts. The first six bytes of the block contain the header, followed by the record data.

       recordpos (long)
		 File position where the requested record starts.

       size (int)
		 Size of the data block without the six bytes for the header.

       recno (int)
		 Record number within the data block. The first record in the block has number 0.

       numrecords (int)
		 The number of records in this block.

       number (int)
		 The number of the data block.

       This function may return records with invalid data, because records are not explizitly marked as deleted, but rather the size  of  a  valid
       data  block  is	modified. A data block is a fixed size area in the file which holds a certain number of records. If for some reason a data
       block has newer been completely filled with records, the algorithmn anticipates deleted records in this data block, which  are  not  there.
       This often happens with the last data block in a file, which is likely to not being fully filled with records.

       If you accessing several records, do it in ascending order, because this is the most efficient way.

	      Note:

	      This function is deprecated.  Use PX_retrieve_record(3) instead

RETURN VALUE

       Returns 0 on success and -1 on failure.

SEE ALSO

       PX_get_field(3), PX_get_record(3)

AUTHOR

       This manual page was written by Uwe Steinmann uwe@steinmann.cx.

																 PX_GET_RECORD2(3)