cm_fields.c File Reference

Stand-alone Field Edit and Entry for C-Menu. More...

#include <common.h>
#include <monetary.h>
#include <stdbool.h>
#include <stddef.h>
#include <string.h>
#include <termios.h>
#include <unistd.h>

Include dependency graph for cm_fields.c:

Go to the source code of this file.

Functions
int	cf_accept (UiSurface *sfc, uint w, char *accept_s, uint flin, uint fcol, uint flen)
	Accepts input for a field in a C-Menu window.

Variables
bool	f_erase_remainder = true
	Structure to hold field information for C-Menu.

Detailed Description

Stand-alone Field Edit and Entry for C-Menu.

Currently, this modules contains a single function, cf_accept(), a lightweight yet fully functional field editor. For text fields, it is equivalent to the field editor in fields.c. Instead of the built-in formatting and validation in fields.c, this module provides a clean slate for a modular plug-in architecture to accomodate formatting, validation, and high-precision numeric data. It will eventually replace the field editor in fields.c. It is a work in progress.

Author

Bill Waller Copyright (c) 2025, 2026 MIT License billx.nosp@m.wall.nosp@m.er@gm.nosp@m.ail..nosp@m.com

Date

2026-02-09

Definition in file cm_fields.c.

Function Documentation

cf_accept()

int cf_accept	(	UiSurface *	sfc,
		uint	w,
		char *	accept_s,
		uint	flin,
		uint	fcol,
		uint	flen )

Accepts input for a field in a C-Menu window.

Parameters

UiSurface	*sfc The surface to accept input from
win	The window to accept input from
accept_s	The string to accept input into
flin	The line number of the field
fcol	The column number of the field
flen	The length of the field

Returns

The key pressed to exit the field (KEY_ENTER, KEY_F09, etc.)

< Enter accepts the field and moves to the next field if f_erase_remainder is set, it will clear the remaining characters above and after the current cursor location

KEY_IC toggles insert mode

KEY_DC deletes character at cursor

KEY_HOME moves cursor to start of field

KEY_BACKSPACE deletes character before cursor

KEY_LEFT moves cursor left one character

KEY_RIGHT moves cursor right one character

Handles mouse events for field editing

Definition at line 41 of file cm_fields.c.

                                                                                       {
    bool f_insert = false;
    int in_key = 0;
    char *s, *d;
    char *fstart;
    UiEvent event;
 
    click_x = click_y = -1;
    char *p = fstart = accept_s;
    char *fend = fstart + flen;
    int x = fcol;
    char *str_end = p + strlen(p);
    while (1) {
        if (in_key == 0) {
            ui_mvwaddstr(sfc, w, flin, fcol, accept_s);
            ui_wclrtoeol(sfc, w);
            ui_cursor_move(sfc, w, flin, x);
            ui_render();
            in_key = ui_get_event(sfc, WIN, &event, -1);
        }
        ui_curs_set(0);
        switch (in_key) {
        case KEY_F09:
            in_key = KEY_F09;
            return (in_key);
        case '\t':
        case KEY_END:
        case Ctrl('e'):
            while (*p != '\0')
                p++;
            x = fcol + (p - fstart);
            in_key = 0;
            continue;
        case '\n':
        case KEY_ENTER:
            if (f_erase_remainder)
                *p = '\0';
            in_key = KEY_ENTER;
            return (in_key);
        case KEY_IC:
            f_insert = !f_insert;
            in_key = 0;
            continue;
        case KEY_DC:
            s = p + 1;
            d = p;
            while (*s != '\0')
                *d++ = *s++;
            *d = '\0';
            str_end = d;
            f_insert = false;
            in_key = 0;
            continue;
        case KEY_HOME:
        case Ctrl('a'):
            p = fstart;
            x = fcol;
            in_key = 0;
            continue;
        case KEY_BACKSPACE:
            if (p > fstart) {
                p--;
                x--;
            }
            s = p + 1;
            d = p;
            while (*s != '\0')
                *d++ = *s++;
            *d = '\0';
            str_end = d;
            in_key = 0;
            continue;
        case KEY_LEFT:
            if (p > fstart) {
                p--;
                x--;
            }
            in_key = 0;
            continue;
        case KEY_RIGHT:
            if (p < fend && p < str_end) {
                p++;
                x++;
            }
            in_key = 0;
            continue;
        case KEY_MOUSE:
            x = click_x;
            flin = click_y;
            fstart = accept_s;
            fend = fstart + flen;
            str_end = fstart + strlen(fstart);
            p = fstart + (x - fcol);
            if (p > str_end)
                x -= p - str_end;
            p = min(p, str_end);
            in_key = 0;
            continue;
        default:
            if (p >= fend) {
                in_key = 0;
                continue;
            }
            if (in_key < ' ' || in_key > '~') {
                in_key = 0;
                continue;
            }
            if (f_insert) {
                if (str_end < fend) {
                    s = str_end - 1;
                    d = str_end;
                    while (s >= p)
                        *d-- = *s--;
                    *p++ = in_key;
                    str_end++;
                    x++;
                }
            } else {
                if (p < fend) {
                    if (p < str_end) {
                        if (p == accept_s && in_key == ' ') {
                            d = accept_s;
                            s = accept_s + 1;
                            while (*s != '\0')
                                *d++ = *s++;
                            *d = '\0';
                            in_key = 0;
                            continue;
                        }
                        *p++ = in_key;
                        x++;
                    } else if (p == str_end) {
                        *p++ = in_key;
                        *p = '\0';
                        str_end = p;
                        x++;
                    }
                }
            }
            in_key = 0;
            continue;
        }
    }
}

References click_x, click_y, f_erase_remainder, ui_curs_set(), ui_cursor_move(), ui_get_event(), ui_mvwaddstr(), ui_render(), ui_wclrtoeol(), and WIN.

Referenced by get_cmd_arg().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

f_erase_remainder

bool f_erase_remainder = true

Structure to hold field information for C-Menu.

Note

Not currently used in the code, but may be used in future versions of C-Menu

Definition at line 30 of file cm_fields.c.

Referenced by cf_accept().