Ns_SetSplit

Overview

Split a set into an array of new sets

Syntax

    Ns_Set **Ns_SetSplit(
    	Ns_Set		*set,
    	char		 sep
    );

Description

The Ns_SetSplit function assumes that each key name in the fields of a set contains a separating character. The fields of the set are partitioned into new sets whose set names are the characters before the separator and whose field key names are the characters after the separator. For example, if the separator is `.' and the set has fields whose key names are the following:

    
    dog.sound
    dog.food
    cat.sound
    cat.food

Ns_SetSplit would create two new sets named dog and cat, each containing two fields whose key names are sound and food.

Ns_SetSplit returns a newly allocated NULL-terminated array of new sets. The original set is left unaltered. The list of new sets can be freed at once with the Ns_SetListFree function.

Top of Page
Copyright © 1996 America Online, Inc.