Wiki source for KeyPgInputnum


Show raw source

{{fbdoc item="title" value="INPUT()"}}----
Reads a number of characters from console or file

{{fbdoc item="syntax"}}##
[[KeyPgDeclare|declare]] [[KeyPgFunction|function]] **Input** ( //n// [[KeyPgAs|as]] [[KeyPgInteger|integer]] ) [[KeyPgAs|as]] [[KeyPgString|string]]
[[KeyPgDeclare|declare]] [[KeyPgFunction|function]] **Input** ( //n// [[KeyPgAs|as]] [[KeyPgInteger|integer]], //filenum// [[KeyPgAs|as]] [[KeyPgInteger|integer]] ) [[KeyPgAs|as]] [[KeyPgString|string]]
##
{{fbdoc item="usage"}}##
//result// = **Input**[$]( //n// [, [#]//filenum// ] )
##
{{fbdoc item="param"}}
##//n//##
Number of bytes to read.
##//filenum//##
File number of a bound file or device.

{{fbdoc item="ret"}}
Returns a ##[[KeyPgString|String]]## of the characters read.

{{fbdoc item="desc"}}
Reads a number of characters from the console, or a bound file/device specified by ##//filenum//##.

The first version waits for and reads ##//n//## characters from the keyboard buffer. Extended keys are not read. The characters are not echoed to the screen.

The second version waits for and reads ##//n//## characters from a file or device. The file position is updated.

{{fbdoc item="ex"}}
{{fbdoc item="filename" value="examples/manual/console/input-n.bas"}}%%(freebasic)
print "Select a color by number"
print "1. blue"
print "2. red"
print "3. green"
dim choice as string
do
choice = input(1)
loop until choice >= "1" and choice <= "3"
%%

{{fbdoc item="lang"}}
- The string type suffix "$" is required in the //[[CompilerOptlang|-lang qb]]// dialect.
- The string type suffix "$" is optional in the //[[CompilerOptlang|-lang fblite]]// dialect.
- The string type suffix "$" is ignored in the //[[CompilerOptlang|-lang fb]]// dialect, warn only with the //[[CompilerOptw|-w suffix]]// compile option (or //[[CompilerOptw|-w pedantic]]// compile option).

{{fbdoc item="diff"}}
- None in the //[[CompilerOptlang|-lang qb]]// dialect.

{{fbdoc item="see"}}
- ##[[KeyPgWinput|Winput()]]##
- ##[[KeyPgGetkey|Getkey]]##
- ##[[KeyPgInkey|Inkey]]##

{{fbdoc item="back" value="CatPgFile|File I/O Functions"}}{{fbdoc item="back" value="CatPgInput|User Input"}}
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki



sf.net phatcode