第十七章 调用Callout Library函数 - 使用 $ZF(-3) 进行简单的库函数调用

2024-01-08 00:23:35

第十七章 调用Callout Library函数 - 使用 $ZF(-3) 进行简单的库函数调用

使用 $ZF(-3) 进行简单的库函数调用

$ZF(-3) 函数用于加载 Callout 库并执行该库中的指定函数。如果只使用一个库,或者没有进行足够的调用来担心加载库的开销,则 $ZF(-3) 最有用。它允许通过指定库名称、函数名称和以逗号分隔的函数参数列表来调用任何可用的库函数:

   result = $ZF(-3, library_name[, function_name[, arguments]])

如果先前调用 $ZF(-3) 尚未加载指定的库,则会加载指定的库。一次只能加载一个库。当后续 $ZF(-3) 调用指定不同的库时,旧库将被卸载,新库将替换它。只要后续 $ZF(-3) 调用指定相同的库,该库就会保持加载状态。加载库后,可以在后续调用中将库名称指定为空字符串 ("")

可以加载或卸载库而无需调用函数。要加载新库,只需指定库名称。要卸载当前库而不加载新库,请仅指定空字符串。无论哪种情况,$ZF(-3)都会返回一个状态代码,指示加载或卸载是否成功。

以下 ObjectScript 代码从两个不同的库中调用两个不同的函数,然后卸载当前库:

使用$ZF(-3)加载库和调用函数

   // define Callout library paths
   set libOne = "c:\intersystems\iris\bin\myfirstlibrary.dll"
   set libTwo = "c:\intersystems\iris\bin\anotherlibrary.dll"

   //load and call
   SET result1=$ZF(-3,libOne,"FuncA",123)   // loads libOne and calls FuncA
   SET result2=$ZF(-3,"","FuncB","xyz")   // calls FuncB from same library

   //load, then call with null name
   SET status=$ZF(-3,libTwo)   // unloads libOne, loads libTwo
   SET result1=$ZF(-3,"","FunctionOne","arg1")
   SET result2=$ZF(-3,"","FunctionTwo","argA", "argB")

   //unload
   SET status=$ZF(-3,"")   // unloads libTwo
  • 为了方便起见,库名称被分配给字符串 libOnelibTwo
  • 第一次调用 $ZF(-3) 加载 CalloutlibOne 并从该库调用函数 FuncA
  • 第二次调用为库名称指定一个空字符串,指示应再次使用当前加载的 libOne,并从该库调用函数 FuncB
  • $ZF(-3) 的第三次调用仅指定库名称 libTwo。这会卸载 libOne 并加载 libTwo,但不会调用任何库函数。该调用返回一个状态代码,指示 libTwo 是否已成功加载。
  • 第四个和第五个调用从当前加载的 libTwo 中调用库函数 FunctionOneFunctionTwo
  • 最后的 $ZF(-3) 调用不会调用库函数,并为库名称指定空字符串。这会卸载 libTwo 并且不会加载新库。该调用返回一个状态代码,指示 libTwo 是否已成功卸载。

本章的以下部分描述了可以一次加载多个库的 $ZF 函数。这些函数不会与$ZF(-3)冲突。始终可以使用 $ZF(-3),就好像它正在加载和卸载其自己的库的私有副本一样。

文章来源:https://blog.csdn.net/yaoxin521123/article/details/135435554
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。