c_lsdel - Deletes a record within a label services file

SYNTAX

#include "las.h"
#include "vll.h"
FUNCTION c_lsdel (fd, key)

     long               *fd;
     char               *key;

PARAMETERS

fd (input, integer)

File descriptor of an opened label services file. The file descriptor is set by c_lsopen() and should not be altered.

key (input, character, length (1:KEYL))

Key of the record to be deleted. Spaces may be embedded in the key; however, right justified spaces are ignored. If the key is NULL or a blank, the current record within the file is marked for deletion. If a value is specified for the key, the first record found with the same key is marked for deletion.

DESCRIPTION

The c_lsdel() call is used to mark a record for deletion. The c_lsdel() function requires the label services file to be opened for read/write access. A record is marked for deletion by replacing the key with the string "DELETED" ("DELETED" is an invalid key specification).

RETURN VALUE

c_lsdel() returns

     E_SUCC (0)  --> successful completion 
     E_FAIL (-1) --> operation failed