Annotation of researchv10dc/630/man/src/p_man/man3/pfkey.3r, revision 1.1

1.1     ! root        1: .ds ZZ DEVELOPMENT PACKAGE
        !             2: .TH PFKEY 3R "630 MTG"
        !             3: .XE "pfkey()"
        !             4: .SH NAME
        !             5: pfkey \- get programmable function (PF) key strings
        !             6: .SH SYNOPSIS
        !             7: .ft B
        !             8: int pfkey (keynum, str, maxlen)
        !             9: .br
        !            10: int keynum, maxlen;
        !            11: .br
        !            12: char \(**str;
        !            13: .SH DESCRIPTION
        !            14: The
        !            15: .I pfkey
        !            16: function
        !            17: places up to
        !            18: (\f2maxlen\f1-1)
        !            19: characters from the given programmable function (PF) key
        !            20: .I keynum
        !            21: into the character array
        !            22: \f2str\f1
        !            23: which must be big enough to accept them. 
        !            24: When
        !            25: .I pfkey
        !            26: encounters a null value or it has processed the 
        !            27: (\f2maxlen\f1-1) th
        !            28: character,
        !            29: .I pfkey 
        !            30: terminates the string with a \s-1NULL\s+1 and returns the length of the string.
        !            31: .PP
        !            32: The value of
        !            33: .I keynum
        !            34: must be between 0x80 and 0x87, inclusive, which corresponds to PF key F1 to F8 on the
        !            35: keyboard.
        !            36: Each PF key
        !            37: can store up to 80 characters plus a NULL in the non-volatile BRAM space of the 
        !            38: terminal.
        !            39: .SH EXAMPLE
        !            40: The following code displays the value of programmable function key F1 on the window.
        !            41: .PP
        !            42: .RS 3
        !            43: .nf
        !            44: .ft CM
        !            45: #include <dmd.h>
        !            46: 
        !            47: #define MAXPFKEY 80
        !            48: 
        !            49: showf1 () {
        !            50:     char pfval[MAXPFKEY+1];
        !            51: 
        !            52:     pfkey (0x80, pfval, MAXPFKEY+1);
        !            53:     jstring (pfval);
        !            54: }
        !            55: \fR
        !            56: .fi
        !            57: .RE
        !            58: 
        !            59: 
        !            60: .SH SEE ALSO
        !            61: keyboard(3R).

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.