Local variables

Local variables are declared using the DECLARE statement, which can be used only within a compound statement (that is, bracketed by the BEGIN and END keywords). The variable is initially set as NULL. The value of the variable can be set using the SET statement, or can be assigned using a SELECT statement with an INTO clause.

The syntax of the DECLARE statement is as follows:

DECLARE variable-name data-type

Local variables can be passed as arguments to procedures, as long as the procedure is called from within the compound statement.

Examples

The following batch illustrates the use of local variables.
```
BEGIN
	DECLARE local_var INT ;
	SET local_var = 10 ;
	MESSAGE 'local_var = ', local_var ;
END
```
Running this batch from ISQL gives the message
```
local_var = 10
```
on the server window.
The variable local_var does not exist outside the compound statement in which it is declared. The following batch is invalid, and gives a column not found error.
```
-- This batch is invalid.
BEGIN
	DECLARE local_var INT ;
	SET local_var = 10 ;
	MESSAGE 'local_var = ', local_var ;
END;
MESSAGE 'local_var = ', local_var ;
```
The following example illustrates the use of SELECT with an INTO clause to set the value of a local variable:
```
BEGIN
	DECLARE local_var INT ;
	SELECT 10 INTO local_var ;
	MESSAGE 'local_var = ', local_var ;
END
```
Running this batch from ISQL gives the message
```
local_var = 10
```
on the server window.

Compatibility

Names Adaptive Server Enterprise and Sybase IQ both support local variables. In Adaptive Server Enterprise, all variables must be prefixed with an @ sign. In Sybase IQ the @ prefix is optional. To write compatible SQL, ensure all your variables have the @ prefix.

Scope The scope of local variables is different in Sybase IQ and Adaptive Server Enterprise. Sybase IQ supports the use of the DECLARE statement to declare local variables within a batch. However, if the DECLARE is executed within a compound statement, the scope is limited to the compound statement.

Declaration Only one variable can be declared for each DECLARE statement in Sybase IQ. In Adaptive Server Enterprise, more than one variable can be declared in a single statement.