X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fmitem_new.3x.html;h=b4ed66765bb707de1ffbcd9aa0fcd2c2fabf5a22;hb=e2153a14ebfb90265151d608778aaf9f403b3d24;hp=13c93da54b0413319be0015af9075c6a9a97f74a;hpb=ed646e3f683083e787c6ba773364401dc9fa9d40;p=ncurses.git diff --git a/doc/html/man/mitem_new.3x.html b/doc/html/man/mitem_new.3x.html index 13c93da5..b4ed6676 100644 --- a/doc/html/man/mitem_new.3x.html +++ b/doc/html/man/mitem_new.3x.html @@ -1,7 +1,7 @@ -
- --mitem_new(3x) mitem_new(3x) +mitem_new(3x) Library calls mitem_new(3x) @@ -52,23 +52,24 @@
#include <menu.h> - ITEM *new_item(const char *name, const char *description); - int free_item(ITEM *item); + + ITEM *new_item(const char *name, const char *description); + int free_item(ITEM *item);
The function new_item allocates a new item and initializes it from the - name and description pointers. 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 + name and description pointers. 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 function free_item de-allocates an item. Please notice that it is + The function free_item de-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.
- The function new_item returns NULL on error. It sets errno according + The function new_item returns NULL on error. It sets errno according to the function's failure: E_BAD_ARGUMENT @@ -88,21 +89,12 @@ Item is connected to a menu. E_SYSTEM_ERROR - System error occurred (see errno). - - -
- curses(3x), menu(3x). - - -
- The header file <menu.h> automatically includes the header file - <curses.h>. + System error occurred (see errno(3)).
- These routines emulate the System V menu library. They were not sup- - ported on Version 7 or BSD versions. + These routines emulate the System V menu library. They were not + supported on Version 7 or BSD versions.
@@ -110,8 +102,12 @@ Raymond. +
+ curses(3x), menu(3x) + + - mitem_new(3x) +ncurses 6.5 2024-03-16 mitem_new(3x)