1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
<!--plsfield:text-->
<HTML><HEAD>
<TITLE>C API Reference -- Ns_SetDeleteKey</TITLE>
<LINK rel=Previous href="c-ch323.htm">
<LINK rel=ToC href="toc.htm">
<LINK rel=Index href="master.htm">
<LINK rel=Next href="c-ch325.htm">
</HEAD><BODY BGCOLOR="#ffffff"><A NAME="topofpage"></A>
<TABLE WIDTH=100%>
<TR>
<TD ALIGN=LEFT>
<A NAME="topofpage"></A> <IMG SRC="as-c-sm.gif">
</TD>
<TD ALIGN=RIGHT>
<A href="c-ch323.htm"><IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A>
<A href=toc.htm> <IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A>
<A href=master.htm> <IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A>
<A href="c-ch325.htm"> <IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A>
<A name="7983"> </A>
</TD>
</TR>
</TABLE>
<a name="129765">
</a><h3>Ns_SetDeleteKey</h3>
<a name="129766">
</a><h4>Overview</h4>
Remove a field from a set by key name
<a name="41006">
</a><a name="133293">
</a><h4>Syntax</h4>
<pre> <a name="41008"></a>void Ns_SetDeleteKey(
<a name="41009"></a>Ns_Set *set,
<a name="41010"></a>char *key
<a name="41011"></a>);
</pre><p><a name="134720">
</a><h4>Description</h4>
<p><a name="41013">
</a>The Ns_SetDeleteKey function removes the field whose key name matches the given key. Any fields that follow the deleted field are moved up to keep the set contiguous. If more than one field in the set has the same key name, Ns_Set-DeleteKey deletes just the first field.</p>
<p><a name="41014">
</a>The Ns_SetIDeleteKey function is this function's case-insensitive counterpart.</p>
<a name="232355">
</a><h4>Examples</h4>
<pre> <a name="232356"></a>Ns_Set *aSet;
<a name="232357"></a>aSet = Ns_SetCreate("");
<a name="232358"></a>Ns_SetPut(aSet, "foo", "foovalue");
<a name="232359"></a>Ns_SetPut(aSet, "bar", "barvalue");
<a name="232360"></a>Ns_SetDeleteKey(aSet, "foo"); /* deletes foo->foovalue */
<a name="232361"></a>/* finish processing of aSet */
<a name="232362"></a>Ns_SetFree(aSet);
</pre><p>
<TABLE BORDER="2" CELLPADDING="1" width="100%">
<TR><TD COLSPAN=3><P ALIGN=Center>
<IMG SRC="bluebult.gif">
<A HREF="#topofpage">
<FONT SIZE=-1>Top of Page</FONT></A>
<IMG SRC="bluebult.gif">
</TD></TR>
<TR><TD COLSPAN=3><P ALIGN=Center>
<A href="c-ch323.htm">
<IMG BORDER="0" src=navbprev.gif alt="[ Previous ]"></A>
<A href=toc.htm>
<IMG BORDER="0" src=navbhome.gif alt="[ Contents ]"></A>
<A href=master.htm>
<IMG BORDER="0" src=navbhelp.gif alt="[ Index ]"></A>
<A href="c-ch325.htm">
<IMG BORDER="0" src=navbnext.gif alt="[ Next ]"></A>
<BR align=center>
<FONT size=-1>Copyright © 1998-99 America Online,
Inc.</FONT>
</TD></TR></TABLE></BODY></HTML><!--plsfield:end-->
|
