drmaa2_list_add - drmaa2_list_add, Adds a new element to a list.
#include "drmaa2.h"
drmaa2_error drmaa2_list_add(const drmaa2_list list, const void* element)
Appends a new element in the given list. The element itself must be from the same type as the list. When the list is freed with drmaa2_list_free(3) then the callback function specified during list creation time is called for the list elements.
Returns DRMAA2_SUCCESS in case of success or an drmaa2_error value in case of an error. The error condition can be read out by drmaa2_lasterror_text(3).
drmaa2_string_list strings = drmaa2_create_list(DRMAA2_STRINGLIST,
(drmaa2_list_entryfree) drmaa2_string_free);
if (DRMAA2_SUCCESS != drmaa2_list_add(strings, strdup("string one"))) {
drmaa2_error error = drmaa2_lasterror_text();
printf("Unexpected error happend: %s\n", (char *) error);
drmaa2_string_free(&error);
}
drmaa2_list_add(strings, strdup("string two"));
const drmaa2_string string = (const drmaa2_string) drmaa2_list_get(strings, 0);
printf("First element of the list %s\n", (const char *) string);
drmaa2_list_free(&strings);
drmaa2_list_create(3), drmaa2_list_free(3), drmaa2_list_add(3), drmaa2_list_del(3), drmaa2_list_size(3), drmaa2_list_has(3)
Copyright Univa Corporation 2013