Categories: Linux

Approfondimenti e Caratteri Speciali in Ncurses

Nell’articolo precedente abbiamo introdotto l’uso delle librerie ncurses ed abbiamo fatto alcuni esempi per mostrare un approccio pratico alla programmazione del terminale in Linux. Questa volta approfondiremo l’argomento parlando dell’inizializzazione della libreria e l’uso dei caratteri speciali che la volta scorsa avevamo soltanto introdotto.
Vediamo innanzitutto le costanti ed i tipi di dato definiti nella libreria:

NCURSES_VERSION – costante con il valore della versione delle librerie
NCURSES_MOUSE_VERSION – costante con il valore della versione del protocollo di comunicazione con il mouse
OK – costante con il valore ritornato da una funzione in caso di successo
ERR – costante con il valore ritornato da una funzione in caso di errore
bool – tipo di dato booleano che può avere valori true o false
WINDOW – struttura dati che mantiene le informazioni sullo stato della finestra
chtype – tipo di dato che in ncurses equivale a int e può contenere un carattere
LINES – variabile con il numero di righe del terminale
COLS – variabile con il numero di colonne del terminale

Per quanto riguarda i nomi delle funzioni, la libreria adotta alcune convenzioni utili a rendere più sintetici i programmi. Data una generica funzione di output, che chiameremo f(parametri), sono possibili le seguenti varianti:

mvf( riga, colonna, parametri ) – sposta il cursore alla posizione specificata prima di chiamare f
wf( finestra, parametri ) – chiama f generando l’output sulla finestra specificata
mvwf( finestra, riga, colonna, parametri ) – sposta il cursore all’interno della finestra specificata ed esegue nella stessa finestra la funzione f

Normalmente, se non si specifica nessuna finestra, l’output avviene su stdscr. Se non si specifica nessuna posizione per il cursore, i caratteri sono scritti o letti a partire dalla posizione corrente. Da notare che le coordinate del cursore sono formate dalla riga e dalla colonna, il punto (0,0) si trova in alto a sinistra dello schermo, le x ( colonne ) crescono verso destra e le y ( righe ) verso il basso.
Come abbiamo visto nello scorso articolo, prima di utilizzare la libreria è necessario inizializzarla con la funzione initscr() che alloca lo spazio in memoria per le variabili curscr e stdscr ed inoltre inserisce i valori a LINES e COLS.

#include “ncursesw/curses.h”

int main(int argc, char** argv)
{
    initscr();
    printw(“Lo schermo ha %d righe e %d colonne\n\n”, LINES, COLS);
    addstr(“Premere un tasto per chiudere l’applicazione”);
    refresh();
    getch();
    endwin();

return 0;
}

Per compilare il programma ricordo che dovete dare il comando:

gcc -Wall -o test test.c -lncursesw

con il file sorgente che si chiama test.c ( maggiori informazioni sulla compilazione in Linux potete trovarli in questo articolo ). Dopo initscr() è facoltativa la chiamata di una o più delle seguenti funzioni:

start_color() – se l’applicazione userà i colori
noecho() per impedire che i caratteri digitati siano immediatamente visualizzati
cbreak() – per leggere un carattere alla volta, senza attendere la pressione del tasto INVIO
nonl() – per impedire la traduzione automatica del tasto INVIO ( CR codice ASCII 13 ) nella sequenza CR/LF, codici ASCII 13,10
keypad(stdscr, TRUE) – per rendere visibili ai programmi i tasti speciali ( cursori, tasti funzioni, ecc… )
meta(stdscr, TRUE) – per fare in modo che i caratteri siano significativi su 8 bit, non su 7, per gestire le lettere accentate
scrollok(stdscr, TRUE) – per abilitare lo scroll ( scorrimento ) dello schermo nel caso in cui l’output vada oltre l’ultima riga disponibile

Ecco quindi una tipica inizializzazione che noi inseriremo in una funzione che verrà richiamata ogni volta che si deve inizializzare la libreria.

…
void InitLib()
{
      initscr();
      if (has_colors())
          start_color();
      cbreak();
      nonl();
      keypad(stdscr, TRUE);
      meta(stdscr, TRUE);
      noecho();
}
…

Ncurses dispone di alcune funzioni per il disegno di linee o bordi con dei caratteri speciali che possono essere inoltre inseriti tramite la funzione addch().

border(left, right, top, bottom, tl_corner, tr_corner, bl_corner, br_corner ) – disegna una cornice attorno ad una finestra specificando quali caratteri utilizzare
hline(char, num) – disegna un carattere in linea orizzontale
vline(char, num) – disegna un carattere in linea verticale

Vediamo un esempio su come sfruttare quello che abbiamo imparato in questo articolo.

#include “ncursesw/curses.h”

void InitLib()
{
     initscr();
     if (has_colors())
         start_color();
     cbreak();
     nonl();
     keypad(stdscr, TRUE);
     meta(stdscr, TRUE);
     noecho();
}

int main(int argc, char** argv)
{
e=”font-size: x-small;”> InitLib();

      mvhline(5, 20, ‘-‘, 40);
      mvhline(15, 20, ‘-‘, 40);
      mvvline(5, 20, ‘|’, 10);
      mvvline(5, 60, ‘|’, 10);

mvaddstr(10, 30, “BENVENUTI IN NCURSES”);
mvaddstr(19, 1, “Premere un tasto per chiudere il programma…”);

      refresh();
      getch();
      endwin();

return 0;
}

In questo semplicissimo esempio abbiamo utilizzato le funzioni che abbiamo spiegato in questo articolo, come si può notare è ottimizzato solo per terminali 80 x 20, ma in futuro prenderemo in esame altre funzioni ed altre caratteristiche di questa potente libreria per terminali Linux e potremmo così creare dei programmi molto più elaborati.

<< Lezione Precedente – Lezione Successiva >>