QB64-PE/internal/help/CSRLIN.txt

The '''CSRLIN''' function returns the current text row position of the [[PRINT]] cursor.



::::::::{{PageSyntax}} row% = CSRLIN


{{PageDescription}}
*  The value returned is within the range of 1 to the current number of rows in the [[SCREEN]] mode used.
*  In screen modes that support page flipping, the [[CSRLIN]] function returns the vertical coordinate of the cursor on the active page.
* x = [[POS]](0) returns the column location of the cursor.


''Example:'' A semicolon stops the print cursor immediately after the print.
{{CodeStart}} '' ''
  LOCATE 5, 5: PRINT "HELLO ";
  Y = {{Cl|CSRLIN}} 'save the row
  X = {{Cl|POS}}(0) 'save the column  
  LOCATE 10, 10: PRINT "WORLD"
  LOCATE Y, X 'restore saved position
  PRINT "GOODBYE" '' ''
{{CodeEnd}}

{{OutputStart}}




         HELLO GOODBYE




         WORLD


{{OutputEnd}}
:''Explanation:'' "HELLO " is printed and the semicolon stops the cursor immediately after the text. The '''CSRLIN''' variable records the current print cursor's text row in Y. The [[POS]] function records the current print cursor's text column in X. The second [[PRINT]] statement displays the comment "WORLD" on the 10th line of the screen. The last [[LOCATE]] statement restores the position of the cursor to the original line and column immediately after the first print.


''See also:'' 
* [[SCREEN]], [[LOCATE]], [[POS]]
* [[_PRINTSTRING]] (graphic print)


{{PageNavigation}}