[Top] [Prev] [Next] [Bottom] [Contents]

SutRemoveNList

Removes the item at a specified position of an SutList and returns it.

Synopsis

#include "SutList.h"
void* SutRemoveNList(pSutList p, int n);

Arguments

p
A pSutList
n
Specifies the position of the item within the pSutList to be removed

Return Values

Returns and removes the item at a specified position of an the SutList. Returns NULL if passed a NULL p value. Returns NULL, if n is less than 0 or greater than the number of items in the list - 1.

Description

SutRemoveNList removes and returns an item at a specified position of a SutList. Returns NULL if passed a NULL p value. Returns NULL, if n is less than 0 or greater than the number of items in the list -1. The position parameter is 0 based. The returned item is of type void*. The item must be typecast appropriately in order to use the returned item. The SutList structure and related functions manage a dynamically sized array of void pointers which can be used as a generic container for C/C++ programmers.

Example

#include "SutList.h"
#include <stdio.h>
pSutList list;
int i, size;
char *str;
char* str1 = "Hello";
char* str2 = "World";
list = SutNewList();
SutAddList(list, str1);
SutAddList(list, str2);
size = SutSizList(list);
for (i=0; i<size; i++)
{
	str = (char*) SutRemoveNList(list, 0);
	fprintf(stderr, "%s\n", str);
}
SutDestroyList(list);

See Also



[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com
Copyright © 1997, Bluestone. All rights reserved.