curs_addchstr(3X) | curs_addchstr(3X) |
NOM¶
addchstr, addchnstr, waddchstr, waddchnstr, mvaddchstr, mvaddchnstr, mvwaddchstr, mvwaddchnstr - ajoute une suite de caractères (et leurs attributs) à une fenêtre de curses
SYNOPSIS¶
#include <curses.h>
int addchstr(const chtype *chstr);
int addchnstr(const chtype *chstr, int n);
int waddchstr(WINDOW *win, const chtype *chstr);
int waddchnstr(WINDOW *win, const chtype *chstr, int n);
int mvaddchstr(int y, int x, const chtype *chstr);
int mvaddchnstr(int y, int x, const chtype *chstr, int n);
int mvwaddchstr(WINDOW *win, int y, int x, const chtype *chstr);
int mvwaddchnstr(WINDOW *win, int y, int x, const chtype *chstr, int
n);
DESCRIPTION¶
Ces routines copient chstr dans la structure d'image de la fenêtre à partir de la position actuelle du curseur. Les quatre routines ayant n en dernier argument copient au plus n éléments, mais pas plus que ce qui tient sur la ligne. Si n=-1, la totalité de la suite est copiée, avec le nombre de caractères tenant sur une ligne.
Le curseur de la fenêtre n'est pas avancé, et ces routines travaillent plus vite que waddnstr. D'un autre côté, ils ne font aucune sorte de vérification (par exemple pour les caractères de nouvelle ligne, d'effacement ou de retour chariot), ils n'avancent pas la position du curseur, ils ne transforment pas les autres caractères de contrôles en ^-échap, et ils tronquent la suite si elle dépasse la marge de droite, au lieu de créer une nouvelle ligne.
VALEURS DE RETOUR¶
Toutes les routines retournent l'integer ERR en cas d'échec et OK en cas de succès (le manuel de SVr4 ne spécifie qu'un « integer de valeur autre que ERR » en cas de succès, à moins que cela ne soit noté autre part dans la description précédente de la routine).
NOTES¶
Notez que toutes les routines, sauf waddchnstr, peuvent être macros.
PORTABILITE¶
Tous ces points d'entrée sont décrits dans les Curses standard CSI, de version 4.
VOIR AUSSI¶
curses(3X).
TRADUCTION¶
Simon Depiets, KDE <2df_CHEZ_tuxfamily_POINT_org>
AVERTISSEMENT SUR LA TRADUCTION¶
Il est possible que cette traduction soit imparfaite ou périmée. En cas de doute, veuillez vous reporter au document original en langue anglaise fourni avec le programme.