Movatterモバイル変換

menu_new(3x) — Linux manual page

menu_new(3X)menu_new(3X)

NAME        top

new_menu,free_menu- create and destroy menus

SYNOPSIS        top

#include <menu.h>MENU *new_menu(ITEM **items);int free_menu(MENU *menu);

DESCRIPTION        top

       The functionnew_menucreates a new menu connected to a specified       item pointer array (which must beNULL-terminated).       The functionfree_menudisconnectsmenu from its item array and       frees the storage allocated for the menu.

RETURN VALUE        top

       The functionnew_menureturnsNULLon error.  It setserrno       according to the function's failure:E_NOT_CONNECTED            No items are connected to the menu.E_SYSTEM_ERROR            System error occurred, e.g., malloc failure.       The functionfree_menureturns one of the following:E_OKThe routine succeeded.E_SYSTEM_ERROR            System error occurred (seeerrno(3)).E_BAD_ARGUMENT            Routine detected an incorrect or out-of-range argument.E_POSTED            The menu has already been posted.

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.orgmenu_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.