Difference between revisions of "PUTENV()"

From Recital Documentation Wiki
Jump to: navigation, search
 
Line 1: Line 1:
 
==Purpose==
 
==Purpose==
Function to update the value of an environment symbol
+
Function to update the value of an environment variable
  
  
Line 12: Line 12:
  
 
==Description==
 
==Description==
The PUTENV() function updates the value of <expC1> with the character expression <expC2>.  The value of the symbol can be retrieved using the GETENV() function.  If variable <expC1> does not exist, it is created.  If the operation is successful, then PUTENV() returns .T., otherwise .F..
+
The PUTENV() function updates the value of <expC1> with the character expression <expC2>.  The value of the variable can be retrieved using the GETENV() function.  If variable <expC1> does not exist, it is created.  If the operation is successful, then PUTENV() returns .T., otherwise .F..
  
  
Line 18: Line 18:
 
<code lang="recital">
 
<code lang="recital">
 
set printer to \\spooler
 
set printer to \\spooler
putenv("db_print","/usr/recital/UD/print_labels")
+
putenv("DB_PRINT","/usr/recital/UD/print_labels")
 
list status to print
 
list status to print
? getenv("db_print")
+
? getenv("DB_PRINT")
 
/usr/recital/UD/print_labels
 
/usr/recital/UD/print_labels
 
</code>
 
</code>

Latest revision as of 16:14, 10 February 2012

Purpose

Function to update the value of an environment variable


Syntax

PUTENV(<expC1>,<expC2>)


See Also

ADDBS(), GETENV(), Printing


Description

The PUTENV() function updates the value of <expC1> with the character expression <expC2>. The value of the variable can be retrieved using the GETENV() function. If variable <expC1> does not exist, it is created. If the operation is successful, then PUTENV() returns .T., otherwise .F..


Example

set printer to \\spooler
putenv("DB_PRINT","/usr/recital/UD/print_labels")
list status to print
? getenv("DB_PRINT")
/usr/recital/UD/print_labels


Products

Recital, Recital Server