elektra/proposal.c File Reference

Implementation of proposed API enhancements. More...

#include <string.h>
#include <kdbprivate.h>

Include dependency graph for elektra/proposal.c:

Functions
Key *	elektraKsPopAtCursor (KeySet *ks, cursor_t pos)
	Pop key at given cursor position. More...

Detailed Description

Implementation of proposed API enhancements.

Copyright

BSD License (see LICENSE.md or https://www.libelektra.org)

Function Documentation

elektraKsPopAtCursor()

Key* elektraKsPopAtCursor	(	KeySet *	ks,
		cursor_t	pos
	)

Pop key at given cursor position.

Parameters

ks	the keyset to pop key from
c	where to pop

The internal cursor will be rewinded using ksRewind(). You can use ksGetCursor() and ksSetCursor() jump back to the previous position. e.g. to pop at current position within ksNext() loop:

cursor_t c = ksGetCursor(ks);
keyDel (ksPopAtCursor(ks, c));
ksSetCursor(ks, c);
ksPrev(ks); // to have correct key after next ksNext()

Warning

do not use, will be superseded by external iterator API

Returns

the popped key

Return values

0	if ks is 0