Difference between revisions of "PUTENV()"

From Recital Documentation Wiki
Jump to: navigation, search
 
Line 1: Line 1:
=PUTENV()=
 
 
 
 
==Class==
 
==Class==
 
Environment
 
Environment
Line 15: Line 12:
  
 
==See Also==
 
==See Also==
[[GETENV()]]
+
[[ADDBS()]], [[GETENV()]], [[:Category:Printing|Printing]]
  
  
 
==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 is very useful for passing parameters to Recital programs spawned in the background, when used in conjunction with the GETENV() function.
+
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..
  
  
 
==Example==
 
==Example==
 
<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
Line 36: Line 33:
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
[[Category:Environment]]
 +
[[Category:Environment Functions]]

Revision as of 11:31, 9 June 2009

Class

Environment


Purpose

Function to update the value of an environment symbol


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 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..


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 Database Server, Recital Mirage Server, Recital Terminal Developer