~ubuntu-branches/ubuntu/natty/ncurses/natty

« back to all changes in this revision

Viewing changes to man/curs_scanw.3x

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2007-05-17 09:00:42 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20070517090042-86fgxrr6j5jzagot
Tags: 5.6-0ubuntu1
* New upstream version.
  - Remove patches applied upstream: ncurses.upstream, signed-chars.
  - Update patches: debian-backspace.
* Build-depend on g++-multilib instead of lib{32,64}c*-dev-*.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\"***************************************************************************
2
 
.\" Copyright (c) 1998,2000 Free Software Foundation, Inc.                   *
 
2
.\" Copyright (c) 1998-2000,2006 Free Software Foundation, Inc.              *
3
3
.\"                                                                          *
4
4
.\" Permission is hereby granted, free of charge, to any person obtaining a  *
5
5
.\" copy of this software and associated documentation files (the            *
26
26
.\" authorization.                                                           *
27
27
.\"***************************************************************************
28
28
.\"
29
 
.\" $Id: curs_scanw.3x,v 1.12 2002/07/20 15:48:09 tom Exp $
 
29
.\" $Id: curs_scanw.3x,v 1.13 2006/02/25 21:42:22 tom Exp $
30
30
.TH curs_scanw 3X ""
31
31
.SH NAME
32
32
\fBscanw\fR,
36
36
\fBvwscanw\fR, \fBvw_scanw\fR - convert formatted input from a \fBcurses\fR window
37
37
.SH SYNOPSIS
38
38
\fB#include <curses.h>\fR
39
 
 
 
39
.sp
40
40
\fBint scanw(char *fmt, ...);\fR
41
41
.br
42
42
\fBint wscanw(WINDOW *win, char *fmt, ...);\fR
54
54
\fBwgetstr\fR were called on the window, and the resulting line used as input
55
55
for \fBsscanf\fR(3).  Fields which do not map to a variable in the \fIfmt\fR
56
56
field are lost.
57
 
 
 
57
.PP
58
58
The \fBvwscanw\fR and \fBvw_scanw\fR routines are analogous to \fBvscanf\fR.
59
59
They perform a \fBwscanw\fR using a variable argument list.
60
60
The third argument is a \fIva_list\fR,
62
62
.SH RETURN VALUE
63
63
\fBvwscanw\fR returns \fBERR\fR on failure and an integer equal to the
64
64
number of fields scanned on success.
65
 
 
 
65
.PP
66
66
Applications may use the return value from the \fBscanw\fR, \fBwscanw\fR,
67
67
\fBmvscanw\fR and \fBmvwscanw\fR routines to determine the number of fields
68
68
which were mapped in the call.