Admin at 19:56, 11 February 2013

2013-02-11T19:56:32Z

Admin: Created page with "= Action = Read a Line from an opened File.
2013-02-11T19:55:45Z

Created page with "= Action = Read a Line from an opened File. Action =

Read a Line from an opened File.

 

 

= Syntax =

LINEINPUT #bFileNumber, sLineText

LINE_INPUT #bFileNumber, sLineText

 

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="609" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="20%" style="width: 118px; border: 1px solid rgb(0, 0, 0);" |
BfileNumber

| valign="top" width="100%" style="width: 482px; border: 1px solid rgb(0, 0, 0);" |
(Byte) File number, which identifies an opened file

|- style="vertical-align: top;"
| valign="top" width="20%" style="width: 118px; border: 1px solid rgb(0, 0, 0);" |
SlineText

| valign="top" width="100%" style="width: 482px; border: 1px solid rgb(0, 0, 0);" |
(String) A string, which is assigned with the next line from the file.

|}
</div>
 

Only valid for files opened in mode INPUT. Line INPUT works only with strings. It is great for working on text files.

 

 

= See also =

[http://avrhelp.mcselec.com/initfilesystem.htm INITFILESYSTEM] , [http://avrhelp.mcselec.com/open.htm OPEN] , [http://avrhelp.mcselec.com/close.htm CLOSE], [http://avrhelp.mcselec.com/flush.htm FLUSH] , [http://avrhelp.mcselec.com/print.htm PRINT], [http://avrhelp.mcselec.com/loc.htm LOC], [http://avrhelp.mcselec.com/lof.htm LOF] , [http://avrhelp.mcselec.com/eof.htm EOF] , [http://avrhelp.mcselec.com/freefile.htm FREEFILE] , [http://avrhelp.mcselec.com/fileattr.htm FILEATTR] , [http://avrhelp.mcselec.com/seek.htm SEEK] , [http://avrhelp.mcselec.com/bsave.htm BSAVE] , [http://avrhelp.mcselec.com/bload.htm BLOAD] , [http://avrhelp.mcselec.com/kill.htm KILL] ,[http://avrhelp.mcselec.com/diskfree.htm DISKFREE] , [http://avrhelp.mcselec.com/disksize.htm DISKSIZE] , [http://avrhelp.mcselec.com/get.htm GET] , [http://avrhelp.mcselec.com/put.htm PUT] , [http://avrhelp.mcselec.com/filedate.htm FILEDATE] , [http://avrhelp.mcselec.com/filetime.htm FILETIME] , [http://avrhelp.mcselec.com/filedatetime.htm FILEDATETIME] , [http://avrhelp.mcselec.com/dir.htm DIR] , [http://avrhelp.mcselec.com/filelen.htm FILELEN] , [http://avrhelp.mcselec.com/write.htm WRITE] , [http://avrhelp.mcselec.com/input.htm INPUT]

 

 

= ASM =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="634" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="18%" style="width: 111px; border: 1px solid rgb(0, 0, 0);" |
Calls

| valign="top" width="38%" style="width: 237px; border: 1px solid rgb(0, 0, 0);" |
_FileLineInput

| valign="top" width="60%" style="width: 274px; border: 1px solid rgb(0, 0, 0);" |
 

|- style="vertical-align: top;"
| valign="top" width="18%" style="width: 111px; border: 1px solid rgb(0, 0, 0);" |
Input

| valign="top" width="38%" style="width: 237px; border: 1px solid rgb(0, 0, 0);" |
r24: filenumber

| valign="top" width="60%" style="width: 274px; border: 1px solid rgb(0, 0, 0);" |
X: Pointer to String to be written from file

|- style="vertical-align: top;"
| valign="top" width="18%" style="width: 111px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="38%" style="width: 237px; border: 1px solid rgb(0, 0, 0);" |
r25: Stringlength

| valign="top" width="60%" style="width: 274px; border: 1px solid rgb(0, 0, 0);" |
 

|- style="vertical-align: top;"
| valign="top" width="18%" style="width: 111px; border: 1px solid rgb(0, 0, 0);" |
Output

| valign="top" width="38%" style="width: 237px; border: 1px solid rgb(0, 0, 0);" |
r25: Errorcode

| valign="top" width="60%" style="width: 274px; border: 1px solid rgb(0, 0, 0);" |
C-Flag: Set on Error

|}
</div>
 

 

= Example =

 <source lang="bascomavr">
'Ok we want to check if the file contains the written lines
Ff = Freefile()' get file handle
Open "test.txt" For Input As #ff ' we can use a constant for the file too
Print Lof(#ff); " length of file"
Print Fileattr(#ff); " file mode"' should be 1 for input
Do
LineInput #ff , S ' read a line
' line input is used to read a line of text from a file
Print S ' print on terminal emulator
Loop Until Eof(ff)<> 0
'The EOF() function returns a non-zero number when the end of the file is reached
'This way we know that there is no more data we can read
Close #ff
</source> {{Languages}}

[[Category:BASCOM Language Reference]]

@@ Line 46: / Line 46: @@
 = <span class="f_Header">See also</span> =
-[http://avrhelp.mcselec.com/initfilesystem.htm INITFILESYSTEM]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/open.htm OPEN]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/close.htm CLOSE],&nbsp;[http://avrhelp.mcselec.com/flush.htm FLUSH]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/print.htm PRINT],&nbsp;[http://avrhelp.mcselec.com/loc.htm LOC],&nbsp;[http://avrhelp.mcselec.com/lof.htm LOF]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/eof.htm EOF]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/freefile.htm FREEFILE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/fileattr.htm FILEATTR]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/seek.htm SEEK]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/bsave.htm BSAVE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/bload.htm BLOAD]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/kill.htm KILL]&nbsp;,[http://avrhelp.mcselec.com/diskfree.htm DISKFREE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/disksize.htm DISKSIZE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/get.htm GET]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/put.htm PUT]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/filedate.htm FILEDATE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/filetime.htm FILETIME]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/filedatetime.htm FILEDATETIME]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/dir.htm DIR]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/filelen.htm FILELEN]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/write.htm WRITE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/input.htm INPUT]
+[[INITFILESYSTEM]] , [[OPEN]] , [[CLOSE]], [[FLUSH]] , [[PRINT]], [[LOC]], [[LOF]] , [[EOF]] , [[FREEFILE]] , [[FILEATTR]] , [[SEEK]] , [[BSAVE]] , [[BLOAD]] , [[KILL]] ,[[DISKFREE]] , [[DISKSIZE]] , [[GET]] , [[PUT]] , [[FILEDATE]] , [[FILETIME]] , [[FILEDATETIME]] , [[DIR]] , [[FILELEN]] , [[WRITE]] , [[INPUT]]
 <span style="font-family: Arial;">&nbsp;</span>

LINEINPUT - Revision history

Admin at 19:56, 11 February 2013