This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

ds_clear()

Delete a data server variable

Synopsis:

#include <ds.h>

int ds_clear( ds_t dsdes, 
              const char* variable_name );

Arguments:

dsdes

A data server descriptor returned by ds_register().

variable_name

The name of the variable that you want to delete.

Library:

libds

Use the -l ds option to qcc to link against this library.

Description:

The ds_clear() function deletes variable_name from the data server identified by dsdes.

Returns:

0

Success.

-1

An error occurred (errno is set).

Errors:

EBADF

Invalid file descriptor dsdes.

ESRCH

The variable doesn't exist in the data server.

Examples:

See slinger in the Utilities Reference.

Classification:

QNX Neutrino

See also:

ds_deregister(), ds_flags()