GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTCLIGETS (3)

NAME

XmtCliGets() - get synchronous input from an XmtCli widget.

CONTENTS

SYNOPSIS

   #include <Xmt/Cli.h>

   char *XmtCliGets(char *buffer, int buffer_len, Widget w)

ARGUMENTS

INPUTS
buffer_len The number of characters in buffer.
w The XmtCli widget from which input is to be read.

OUTPUTS

buffer An array of characters into which user input is stored. No more than buffer_len-1 characters will be stored into this buffer, and the input will be null terminated.

RETURNS

buffer, the character array into which input is stored.

DESCRIPTION

XmtCliGets() is the XmtCli widget analog to the C library function fgets(). It is a synchronous input function that appears to ‘‘block’’ in an internal event loop, and is designed to be used for simple ports of terminal-based applications
to the X toolkit. Note the unusual order of its arguments-the XmtCli widget w is last by analogy to the input stream argument to fgets().

XmtCliGets() calls XmProcessTraversal() to give keyboard focus to the XmtCli widget, and calls XtAddGrab() to tell the Intrinsics to ignore user events that occur on any other widgets. Then it enters an internal event loop, processing events until the user has entered a string and typed the Return key. When the user completes the input, XmtCliGets() calls XtRemoveGrab() to return event dispatching to normal, and calls XmProcessTraversal() to restore keyboard focus to its previous location. Finally, XmtCliGets() copies the input string (up to a maximum of buffer_len-1 characters) into buffer, null-terminates the string, and returns buffer as its return value.

SEE ALSO

Chapter 21, Command Line Input,
XmtCli, XmtCliClear(), XmtCliFlush(), XmtCliPrintf(), XmtCliPuts().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTCLIGETS (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.