Print out

Purpose: Print data out.

 print-out ( ( <string> [ length <length> ] [ url-encode | web-encode ] [ new-line ] )
           | <number> new-line
           | source-file [ new-line ]
           | source-line [ new-line ] ) , ...

Copied!

print-out outputs various kinds of data:

A <string> is output:
```
 print-out <string> [ <length> ] [ url-encode | web-encode ] [ new-line ]
```
Copied!
- By default, <string> is output without any encoding (meaning a string is output exactly as it appears). To output data verbatim to a client:
```
 set-string mydata="Hello world"
 print-out mydata
```
  Copied!
  Writing to client, outputting text followed by a horizontal rule - the text is output to a client (such as browser) as it is, and the browser will interpret tags "<br/>" and "<hr/>" as a line break and a horizonal line and display them as such:
```
 print-out "This is a non-encoded output<br/>" new-line
 print-out "<hr/>"
```
  Copied!
  Create a query text string by means of write-string statement:
```
 //
 // Construct the run-time text of dynamic SQL
 //
 write-string qry_txt
    @select * from <<print-out table_name>>
 end-write-string
```
  Copied!
- If "url-encode" clause is used, then the output is URL-encoded. This means such output is suited for use in URL parameters. Create a URL based on arbitrary strings used as URL parameters - for instance a space would be encoded as "%20" in the final output:
```
 @<a href='<<print-out "/update">>?item=<<print-out item_name url-encode>>'>Update</a>
```
  Copied!
If "web-encode" clause is used, then the output is web-encoded (or HTML-encoded). This means such output is suited for use in web pages - the text will be displayed verbatim without HTML-markup being interpreted. Display "We use <hr/> markup" text, without "<hr/>" being displayed as a horizontal line:
```
 print-out "We use <hr/> markup" web-encode
```
Copied!
If "length" clause is used, then only <length> leading bytes of <string> are output.

If "new-line" clause is used, then a new line ("\n") is output after <string>.

Note that all bytes of <string> are output, even if <string> contains null-bytes.
Outputs a number, given by <number>:
```
 print-out <number> [ new-line ]
```
Copied!
If "new-line" clause is used, then a new line ("\n") is output after <number>.

To output a number to a client:
```
 set-number x = 100
 print-out x
```
Copied!
Outputs a boolean, given by <bool>:
```
 print-out <bool> [ new-line ]
```
Copied!
If "new-line" clause is used, then a new line ("\n") is output after <bool>. The value of <bool> is output as 1 if true, and 0 if false.

To output a boolean to a client (outputs 1):
```
 set-bool b = true
 print-out b
```
Copied!
Outputs the file name of the current source file.
```
 print-out source-file [ new-line ]
```
Copied!
This outputs the file name (relative to the source code directory) of the source file where the statement is located; this is often used for debugging.

If "new-line" clause is used, then a new line ("\n") is output afterwards.
```
 @This file is <<print-out source-file>>
```
Copied!
Outputs current line number in the source file.
```
 print-out source-line [ new-line ]
```
Copied!
This outputs the line number in the source file where the statement is located. It is often used for debugging purposes.

If "new-line" clause is used, then a new line ("\n") is output afterwards.
```
 @This line is #<<print-out source-line>>
```
Copied!

List of expressions

You can specify a list of expressions separated by a comma to print them out in the order specified, with the end result the same as if they were separate print-outs, for instance:

 print-out str new-line, num, " some string ", str1 web-encode new-line

Copied!

In this case, you'll be outputting string "str", number "num", a string constant " some string ", and a web-encoded string "str1". There are no whitespaces between each item output.