其他 Python 语法选项
TreeAge Pro 支持多种调用 Python 函数的语法选项。前面提到的标准语法以及其他语法将在下表中说明。
| 函数语法 | 说明 |
myPythonFunction |
调用不需要参数的 Python 函数时,只需引用函数名即可。 |
Python( "expression" ) |
如果当前 Python 能够成功求值变量名、表达式或函数,Python() 函数将返回该值;如果无法求值,则返回错误。Python() 函数返回一个数值。 示例:Python( "10+1") 返回 11 示例:Python("int('0xff', 16)") 返回 255 |
PythonFunc( "module"; "function"; argument1 ; ... ) |
执行已导入模块中的函数。 只有在模块已导入的情况下此语法才有效。 示例:PythonFunc( "random"; "normalvariate"; mu; sd) 返回来自 Normal(mu,sd) 的一个随机数,其中 mu 与 sd 为数值 |
PythonGetList( "list"; "treeage table" ) |
PythonGetList() 函数将二维 Python 嵌套列表复制到 TreeAge 表格中。Python 表达式可以是字面列表(如下所示)、包含列表的变量,或返回列表的函数。 示例:PythonGetList("[[0,.1,.2],[1,.15,.25]]" ; "myTable") 加载 myTable 并返回行数(2) |
PythonRun( "command"; ... ) |
失败时返回 0,成功时返回 1。请指定有效的 Python 语句。若要运行一系列脚本或模块, 请用分号分隔多个用双引号括起的路径。如果 Python 成功运行了最后指定的 语句,PythonRun() 函数将返回值 1。如果 Python 在求值您的 命令时遇到错误,PythonRun() 函数将返回 0,而不是错误。若要强制产生 TreeAge Pro 错误,可将该 结果用作除法运算的分母。若要返回由所执行命令创建或修改的变量或函数的值,请使用 Python() 函数。 示例:PythonRun( "from random import *" ; "seed(1)"; "x=random()" ) = 1 value = Python("x") = .134364... |
PythonRunFile( "scriptfile" ; ... ) |
失败时返回 0,成功时返回 1。请指定有效的 Python 脚本文本文件或 模块的完整路径与文件名;或者,如果文件存放在 Python 默认路径中,只需指定文件名即可。若要运行一系列脚本 或模块,请用分号分隔多个用双引号括起的路径。(请注意,路径中可以用 正斜杠代替反斜杠。) 示例:PythonFile( "C:\Python24\lib\TransplantQueue.py" ) 使用 PythonRunFile() 执行文件,等同于让 Python 求值 execfile() 函数: PythonRun( "execfile( 'C:\Python24\lib\TransplantQueue.py')" ) 如果脚本或模块成功执行,可使用 Python() 函数返回变量的值: queueWait = Python("now()") |
User( "myPythonFunction"; argument1 ; ... ) |
调用 Python 函数并向该函数传递参数的 User 命令。 User( ) 函数仍受支持,但更推荐使用上面列出的其他命令。 |