如何在ncurses中创建支持宽字符的菜单？编译错误排查

问题背景 #

在Arch Linux环境下，尝试实现ncurses宽字符菜单时遇到编译错误，环境中ncurses包同时包含ncurses和ncursesw，排除文件引用问题。

示例代码 #

#include <menu.h>
#include <ncurses.h>
#include <stdlib.h>
#include <wchar.h>

#define ITEM_COUNT 2

int main() {

  wchar_t *choices[] = {L"揺らぎ", L"a widecharacter string"};

  ITEM **wide_items;
  MENU *wide_menu;

  initscr();
  noecho();
  cbreak();
  refresh();

  wide_items = (ITEM **)calloc(ITEM_COUNT + 1, sizeof(ITEM *));
  wide_items[0] = new_item(choices[0], choices[0]);
  wide_items[1] = new_item(choices[1], choices[1]);
  wide_items[ITEM_COUNT + 1] = NULL;

  wide_menu = new_menu(wide_items);

  refresh();

  getwchar();

  free_item(wide_items[1]);
  free_item(wide_items[0]);
  free(wide_items);
  free_menu(wide_menu);
  endwin();

  return 0;
}

编译错误信息 #

wide_menu.c: In function ‘main’:
wide_menu.c:21:35: error: passing argument 1 of ‘new_item’ from incompatible pointer type [-Wincompatible-pointer-types]
   21 |   wide_items[0] = new_item(choices[0], choices[0]);
      |                            ~~~~~~~^~~
      |                                   |
      |                                   wchar_t * {aka int *}
In file included from wide_menu.c:1:
/usr/include/menu.h:199:39: note: expected ‘const char *’ but argument is of type ‘wchar_t *’ {aka ‘int *’}
  199 |   extern MENU_EXPORT(ITEM *) new_item(const char *, const char *);
      |                                       ^~~~~~~~~~~~
wide_menu.c:21:47: error: passing argument 2 of ‘new_item’ from incompatible pointer type [-Wincompatible-pointer-types]
   21 |   wide_items[0] = new_item(choices[0], choices[0]);
      |                                        ~~~~~~~^~~
      |                                               |
      |                                               wchar_t * {aka int *}
/usr/include/menu.h:199:53: note: expected ‘const char *’ but argument is of type ‘wchar_t *’ {aka ‘int *’}
  199 |   extern MENU_EXPORT(ITEM *) new_item(const char *, const char *);
      |                                                     ^~~~~~~~~~~~
wide_menu.c:22:35: error: passing argument 1 of ‘new_item’ from incompatible pointer type [-Wincompatible-pointer-types]
   22 |   wide_items[1] = new_item(choices[1], choices[1]);
      |                            ~~~~~~~^~~
      |                                   |
      |                                   wchar_t * {aka int *}
/usr/include/menu.h:199:39: note: expected ‘const char *’ but argument is of type ‘wchar_t *’ {aka ‘int *’}
  199 |   extern MENU_EXPORT(ITEM *) new_item(const char *, const char *);
      |                                       ^~~~~~~~~~~~
wide_menu.c:22:47: error: passing argument 2 of ‘new_item’ from incompatible pointer type [-Wincompatible-pointer-types]
   22 |   wide_items[1] = new_item(choices[1], choices[1]);
      |                                        ~~~~~~~^~~
      |                                               |
      |                                               wchar_t * {aka int *}
/usr/include/menu.h:199:53: note: expected ‘const char *’ but argument is of type ‘wchar_t *’ {aka ‘int *’}
  199 |   extern MENU_EXPORT(ITEM *) new_item(const char *, const char *);

使用的编译命令 #

gcc wide_menu.c -lncursesw -lmenuw

疑问 #

是否存在支持存储宽字符指针的菜单创建函数？若没有，是否有替代方案实现ncurses菜单的宽字符支持？

解答 #

1. 无直接接收宽字符指针的菜单创建函数 #

ncurses的menu库（包括宽字符版本menuw）没有提供直接接收wchar_t*类型参数的new_item变体函数，所有菜单API仅支持传入多字节字符串（const char*）。

2. 替代方案：宽字符转多字节字符串 #

通过将wchar_t*类型的宽字符转换为当前locale下的多字节字符串，再传递给new_item函数，具体步骤如下：

• 初始化时设置支持宽字符的locale，确保转换函数能正确识别编码；
• 使用wcstombs函数将宽字符转换为多字节字符串，注意分配足够内存并手动释放。

修改后的示例代码：

#include <menu.h>
#include <ncurses.h>
#include <stdlib.h>
#include <wchar.h>
#include <locale.h>
#include <string.h>

#define ITEM_COUNT 2

// 辅助函数：将wchar_t*转换为多字节字符串
char* wchar_to_mb(const wchar_t* wstr) {
    if (!wstr) return NULL;
    size_t len = wcstombs(NULL, wstr, 0) + 1;
    char* mbstr = malloc(len);
    if (mbstr) {
        wcstombs(mbstr, wstr, len);
    }
    return mbstr;
}

int main() {
    // 设置locale以支持宽字符编码转换
    setlocale(LC_ALL, "");

    wchar_t *choices[] = {L"揺らぎ", L"a widecharacter string"};

    ITEM **wide_items;
    MENU *wide_menu;

    initscr();
    noecho();
    cbreak();
    refresh();

    wide_items = (ITEM **)calloc(ITEM_COUNT + 1, sizeof(ITEM *));
    
    // 转换宽字符为多字节字符串后创建菜单项
    char* mb_choice0 = wchar_to_mb(choices[0]);
    char* mb_choice1 = wchar_to_mb(choices[1]);
    
    wide_items[0] = new_item(mb_choice0, mb_choice0);
    wide_items[1] = new_item(mb_choice1, mb_choice1);
    wide_items[ITEM_COUNT] = NULL; // 修正原代码的索引越界问题

    wide_menu = new_menu(wide_items);
    post_menu(wide_menu); // 显示菜单
    refresh();

    getwchar();

    // 按顺序释放资源
    free_item(wide_items[1]);
    free_item(wide_items[0]);
    free(mb_choice1);
    free(mb_choice0);
    free(wide_items);
    free_menu(wide_menu);
    endwin();

    return 0;
}

3. 编译与注意事项 #

编译命令保持不变：

gcc wide_menu.c -lncursesw -lmenuw

• 必须调用setlocale(LC_ALL, "")，否则宽字符转换会失败；
• 转换后的多字节字符串需手动释放，避免内存泄漏；
• 修正原代码中数组索引越界的错误，菜单项数组的终止NULL应放在ITEM_COUNT索引位置。

内容的提问来源于stack exchange，提问作者Shreyas Jenner