Sortix
Sortix Download Manual Development Source Code News Blog More
current nightly

Sortix nightly manual

This manual documents Sortix nightly, a development build that has not been officially released. You can instead view this document in the latest official manual.

NAME

free_item, new_item — create or delete menu item

LIBRARY

Curses Menu Library (libmenu, -lmenu)

SYNOPSIS

#include <menu.h>
int
free_item(ITEM *item);
ITEM *
new_item(char *name, char *description);

DESCRIPTION

The free_item() function destroys the item and frees all allocated storage for that item. The new_item() allocates storage for a new item then copies in the item name and description for the new item. A pointer to the newly created item is returned to the caller.

RETURN VALUES

The new_item() function returns NULL on failure, the free_item() returns one of the following error values:
E_OK
The function was successful.
E_BAD_ARGUMENT
One or more of the arguments passed to the function was incorrect.

SEE ALSO

curses(3), menus(3)

NOTES

The header <menu.h> automatically includes both <curses.h> and <eti.h>.
Copyright 2011-2025 Jonas 'Sortie' Termansen and contributors.
Sortix's source code is free software under the ISC license.
#sortix on irc.sortix.org
@sortix_org