Click above to get retro games delivered to your door ever month!

 C_SAYTEXT()

 DESCRIPTION

 The C_SAYTEXT() function outputs a character string to the screen
 at the given row and column in a specified color with optional
 starting and ending positions in the string.  C_SAYTEXT() is useful
 for displaying text in different colors on the screen and providing
 a SUBSTR() type feature to extract only specified characters from a
 longer string.  This provides the functionality of @ SAY, SUBSTR(),
 and SETCOLOR() in one function.

 SYNTAX

 C_SAYTEXT(row, col, string [,color] [,st_pos] [,end_pos])

 PARAMETERS

 row (N), col (N) are the starting row and column to display the text.

 string (C) is the character string to display.

 color (C/N) is the color to display the string.  The color argument
 can be specified as a dBASE/Clipper character string or a numeric
 color code (see Appendix E).  If color is not specified, the
 current Clipper color is used.

 st_pos (N) is the starting position in the string to begin
 displaying characters.  If st_pos is not specified, the starting
 position is one (1).

 end_pos (N) is the ending position in the string to stop displaying
 characters.  If end_pos is not specified, the entire string is
 displayed.

 RETURNS

 There is no return value.

 EXAMPLES

 s1 = "This is the line of text to display"
 setcolor("W/B")

 && This displays string s1 at row 10, column 0 in the current screen
 && colors (W/B)
 c_saytext(10,0,s1)

 && This displays string s1 at row 10, column 0 in the colors red on white
 c_saytext(10,0,s1,"R/W")

 && This displays the word "text" from string s1 at row 10, column 0
 && in the colors red on white
 c_saytext(10,0,s1,"R/W",21,4)

 && This displays "text to display" from string s1 at row 5, column 25
 && in the current screen colors (w/b).
 c_saytext(5,25,s1,"",21)