Iget_line

[ XITE Reference Manual | XITE home ]

Name

Iget_line - read a line from BIFF image text field

Syntax

 #include <xite/biff.h>

 BiffStatus Iget_line( IMAGE i, char* s );

Description

Read a whole line from text field of image i to the string s. The line terminates when: a) ^J is encountered, or b) 80 characters are read, or c) at end of text. The returned string will not contain the eventual ^J, but it will contain the terminating null. The character position is moved to after the line.

Restrictions

i should be initialized, s should be large enough (size 81 is always enough).

See also

Iput_text(5), Inchars(5), Igetpos(5), Isetpos(5), Igetchar(5), biffinfo(1)

Return value

status

Author

Tor Lønnestad, BLAB, Ifi, UiO