Movatterモバイル変換

mitem_new(3x) — Linux manual page

mitem_new(3X)mitem_new(3X)

NAME        top

new_item,free_item- create and destroy menu items

SYNOPSIS        top

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

DESCRIPTION        top

       The functionnew_itemallocates a new item and initializes it from       thenameanddescriptionpointers.  Please notice that the item       stores only the pointers to the name and description.  Those       pointers must be valid during the lifetime of the item.  So you       should be very careful with names or descriptions allocated on the       stack of some routines.       The functionfree_itemde-allocates an item.  Please notice that       it is the responsibility of the application to release the memory       for the name or the description of the item.

RETURN VALUE        top

       The functionnew_itemreturnsNULLon error.  It setserrno       according to the function's failure:E_BAD_ARGUMENT            Routine detected an incorrect or out-of-range argument.E_SYSTEM_ERROR            System error occurred, e.g., malloc failure.       The functionfree_itemreturns one of the following:E_OKThe routine succeeded.E_BAD_ARGUMENT            Routine detected an incorrect or out-of-range argument.E_CONNECTED            Item is connected to a menu.E_SYSTEM_ERROR            System error occurred (seeerrno(3)).

SEE ALSO        top

curses(3X),menu(3X).

NOTES        top

       The header file<menu.h>automatically includes the header file<curses.h>.

PORTABILITY        top

       These routines emulate the System V menu library.  They were not       supported on Version 7 or BSD versions.

AUTHORS        top

       Juergen Pfeifer.  Manual pages and adaptation for new curses by       Eric S. Raymond.

COLOPHON        top

       This page is part of thencurses (new curses) project.       Information about the project can be found at        ⟨https://www.gnu.org/software/ncurses/ncurses.html⟩.  If you have a       bug report for this manual page, send it to       bug-ncurses-request@gnu.org.  This page was obtained from the       project's upstream Git mirror of the CVS repository       ⟨https://github.com/mirror/ncurses.git⟩ on 2025-08-11.  (At that       time, the date of the most recent commit that was found in the       repository was 2023-03-12.)  If you discover any rendering       problems in this HTML version of the page, or you believe there is       a better or more up-to-date source for the page, or you have       corrections or improvements to the information in this COLOPHON       (which isnot part of the original manual page), send a mail to       man-pages@man7.orgmitem_new(3X)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.