1. drmaa2_list_free(3)
  2. DRMAA2
  3. drmaa2_list_free(3)

NAME

drmaa2_list_free - drmaa2_list_free, Frees a DRMAA2 list and its elements.

SYNOPSIS

#include "drmaa2.h"

void drmaa2_list_free(drmaa2_list * l);

DESCRIPTION

Frees the memory of the given drmaa2_list (independent of its type) and sets it to NULL. If the list was created by using a callback function (see drmaa2_list_create(3)) then the callback function is called for each element in the list. Usually the callback function frees an element. Lists returned by function of the Univa(R) Grid Engine(TM) DRMAA2 C implementation are initialized with appropriate callback functions so that the list and its entries are completely freed.

EXAMPLE

drmaa2_string_list strings = drmaa2_create_list(DRMAA2_STRINGLIST, (drmaa2_list_entryfree) drmaa2_string_free);

drmaa2_list_add(strings, strdup("string one"));
drmaa2_list_add(strings, strdup("string two"));
drmaa2_list_del(strings, "string one"));

printf("Size of list %ld", drmaa2_list_size(strings));

drmaa2_list_free(&strings); 

SEE ALSO

drmaa2_list_create(3), drmaa2_list_add(3), drmaa2_list_del(3), drmaa2_list_size(3), drmaa2_list_get(3), drmaa2_list_has(3)

AUTHOR

Copyright Univa Corporation 2013

  1. Univa Corporation
  2. October 2013
  3. drmaa2_list_free(3)