The REPFOOTER command defines a report footer. Report footers print on the last page of a report, after the last detail line and before the bottom title. See Chapter 3 for more information.
REPF[OOTER] [OFF|ON]|
[COL x|
S[KIP] x|
TAB x|
LE[FT]|
CE[NTER]|
R[IGHT]|
BOLD|
FOR[MAT] format_spec|
text|
variable...]where:
- REPF[OOTER]
May be abbreviated REPF. Issuing the REPFOOTER command with no parameters causes SQL*Plus to display the current report footer setting.
- OFF
Turns the report footer off, but does not erase its definition. You can turn it back on again with ON.
- ON
- COL x
Causes any footer text following this parameter to print at the specified column position.
- S[KIP] x
May be abbreviated to S, and inserts the specified number of line breaks before printing any subsequent footer text.
- TAB x
TAB is similar to COL, but moves you the specified number of columns relative to the current position. Negative numbers move you backwards. TAB has nothing whatsoever to do with tab characters.
- LE[FT]
May be abbreviated LE, and causes subsequent footer text to be printed beginning at the leftmost column of the current footer line.
- CE[NTER]
May be abbreviated CE, and causes subsequent footer text to be centered within the current line. The LINESIZE setting controls the line width.
- R[IGHT]
May be abbreviated R, and causes subsequent footer text to be printed flush right. The LINESIZE setting controls where SQL*Plus thinks the right end of the line is.
- BOLD
Makes a footer “bold” by printing it three times. Only text following the BOLD command is repeated on each line. There is not a NOBOLD parameter.
- FOR[MAT]
May be abbreviated to FOR, and allows you to control how subsequent numeric data in the footer is displayed.
- format_spec
Is a string that specifies the display format to use for subsequent numeric data in the footer. The format elements you can use here are the same as for the COLUMN command, and are described in Appendix B. It is possible to specify a character format, such as A20, but that has no effect on subsequent character strings.
- text
Is any text you want to have in the footer. To be safe, you should enclose this in quotes, but you don’t have to as long as your title text doesn’t include any keywords like BOLD or TAB that have meaning to REPFOOTER. Either single or double quotes may be used. If you need to include a quote as part of your text, use two quote characters back to back.
- variable
May be one of the variables shown in Table 1.1, which is shown under the BTITLE command.