X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=man%2Fcurs_inch.3x;h=66f488f8a2d105bdf4e311b350985c3969eb4822;hb=725169bda4d3b4c3fde0d4a94f76d017812c7ea6;hp=2df5e11aaddb936099e2de8eb877353e1dcd9a58;hpb=31c4bcf3307145fc5368b4aaf15e41bdd66a984b;p=ncurses.git diff --git a/man/curs_inch.3x b/man/curs_inch.3x index 2df5e11a..66f488f8 100644 --- a/man/curs_inch.3x +++ b/man/curs_inch.3x @@ -1,6 +1,6 @@ '\" t .\"*************************************************************************** -.\" Copyright 2018-2022,2023 Thomas E. Dickey * +.\" Copyright 2018-2023,2024 Thomas E. Dickey * .\" Copyright 1998-2010,2017 Free Software Foundation, Inc. * .\" * .\" Permission is hereby granted, free of charge, to any person obtaining a * @@ -28,12 +28,19 @@ .\" authorization. * .\"*************************************************************************** .\" -.\" $Id: curs_inch.3x,v 1.37 2023/09/16 23:37:03 tom Exp $ -.TH curs_inch 3X 2023-09-16 "ncurses 6.4" "Library calls" -.ie \n(.g .ds `` \(lq -.el .ds `` `` -.ie \n(.g .ds '' \(rq -.el .ds '' '' +.\" $Id: curs_inch.3x,v 1.46 2024/03/16 15:35:01 tom Exp $ +.TH curs_inch 3X 2024-03-16 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls" +.ie \n(.g \{\ +.ds `` \(lq +.ds '' \(rq +.\} +.el \{\ +.ie t .ds `` `` +.el .ds `` "" +.ie t .ds '' '' +.el .ds '' "" +.\} +. .de bP .ie n .IP \(bu 4 .el .IP \(bu 2 @@ -45,15 +52,15 @@ \fB\%mvwinch\fP \- get a \fIcurses\fR character from a window .SH SYNOPSIS -\fB#include \fP -.sp -\fBchtype inch(void);\fP -.br -\fBchtype winch(WINDOW *\fIwin\fB);\fR -.sp -\fBchtype mvinch(int \fIy\fB, int \fIx\fB);\fR -.br -\fBchtype mvwinch(WINDOW *\fIwin\fB, int \fIy\fB, int \fIx\fB);\fR +.nf +\fB#include +.PP +\fBchtype inch(void); +\fBchtype winch(WINDOW *\fIwin\fP); +.PP +\fBchtype mvinch(int \fIy\fP, int \fIx\fP); +\fBchtype mvwinch(WINDOW *\fIwin\fP, int \fIy\fP, int \fIx\fP); +.fi .SH DESCRIPTION These routines return the character, of type \fBchtype\fP, at the current position in the named window. @@ -64,13 +71,16 @@ Constants defined in extract the character or attributes alone. . .SS Attributes -The following bit-masks may be AND-ed with characters returned by \fBwinch\fP. +The following bit masks may be AND-ed with characters returned by \fBwinch\fP. .PP .TS -l l . -\fBA_CHARTEXT\fP Bit-mask to extract character -\fBA_ATTRIBUTES\fP Bit-mask to extract attributes -\fBA_COLOR\fP Bit-mask to extract color-pair field information +Lb Lb +Lb Lx. +Name Description +_ +A_CHARTEXT Extract character +A_ATTRIBUTES Extract attributes +A_COLOR Extract color pair information .TE .SH RETURN VALUE Functions with a \*(``mv\*('' prefix first perform a cursor movement using @@ -107,13 +117,15 @@ This implementation uses 8 bits for character values. An application using more bits, e.g., a Unicode value, should use the wide-character equivalents to these functions. .SH SEE ALSO -.TP 5 -\fBcurses\fP(3X) -gives an overview of the WINDOW and \fBchtype\fP data types. -.TP 5 -\fBcurs_attr\fP(3X) +.TP +\fB\%curses\fP(3X) +gives an overview of the \fB\%WINDOW\fP and \fB\%chtype\fP data types. +.TP +\fB\%curs_attr\fP(3X) goes into more detail, pointing out portability problems and -constraints on the use of \fBchtype\fP for returning window information. -.TP 5 -\fBcurs_in_wch\fP(3X) -describes comparable functions for the wide-character (ncursesw) library. +constraints on the use of \fB\%chtype\fP for returning window +information. +.TP +\fB\%curs_in_wch\fP(3X) +describes comparable functions for the wide-character (ncursesw) +library.