Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmtCliGets(3)		   Library Functions Manual		 XmtCliGets(3)

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

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 loca-
       tion. 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().

Xmt				  Motif	Tools			 XmtCliGets(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmtCliGets&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help