第107章 SQL函数 $PIECE

返回由分隔符标识的子字符串的字符串函数。

第105章 SQL函数 %OID

返回 ID 字段的 OID 的标量函数。

大纲

%OID(id_field)

参数

• id_field - ID 字段或引用字段的字段名称。

描述

%OID 采用字段名称并返回对象的完整 OID（对象 ID）。该字段必须是 ID 字段或引用字段（外键字段）。在 id_field 中指定任何其他类型的字段会生成 SQLCODE -1 错误。

示例

以下示例显示了与引用字段一起使用的 %OID：

第104章 SQL函数 %ODBCOUT

以 ODBC 格式返回表达式的格式转换函数。

大纲

%ODBCOUT(expression)

%ODBCOUT expression

参数

• expression - 要转换的表达式。字段名称、包含字段名称的表达式或以可转换数据类型（例如 DATE 或 %List）返回值的函数。不能是流字段。

描述

%ODBCOUT 在通过字段或数据类型的 LogicalToOdbc 方法传递值后以 ODBC 格式返回表达式。 ODBC 格式是可以通过 ODBC 呈现数据的格式。当数据暴露给 ODBC/SQL 时使用这种格式。可用的格式对应于 ODBC 定义的格式。

第102章 SQL函数 %OBJECT

标量函数，它打开一个流对象并返回相应的 oref。

大纲

%OBJECT(stream)

参数

• stream - 作为流字段名称的表达式。

描述

%OBJECT 用于打开一个流对象并返回流字段的 oref（对象引用）。

流字段上的 SELECT 返回流字段的完全形成的 oid（对象 ID）值。流字段上的 SELECT %OBJECT 返回流字段的 oref（对象引用）。这在以下示例中显示，其中 Notes 和 Picture 都是流字段：

第100章 SQL函数 NULLIF

如果两个表达式具有相同的值，则返回 NULL 的函数。

大纲

NULLIF(expression1,expression2)

参数

• expression1 - 表达式，可以是列名、数字或字符串文字、主变量或另一个标量函数的结果。
• expression2 - 表达式，可以是列名、数字或字符串文字、主变量或另一个标量函数的结果。

NULLIF 返回与 expression1 相同的数据类型。

描述

如果 expression1 的值等于 expression2 的值，则 NULLIF 函数返回 NULL。否则，它返回 expression1 值。

NULLIF 等价于：

第九十八章 SQL函数 MONTHNAME

返回日期表达式的月份名称的日期函数。

大纲

{fn MONTHNAME(date-expression)}

参数

• date-expression - 计算结果为 日期整数、ODBC 日期或时间戳的表达式。此表达式可以是列名、另一个标量函数的结果或日期或时间戳字面量。

描述

MONTHNAME 将日期整数、$HOROLOG 或 $ZTIMESTAMP 值、ODBC 格式日期字符串或时间戳作为输入。

日期表达式时间戳可以是数据类型 %Library.PosixTime（编码的 64 位有符号整数），也可以是数据类型 %Library.TimeStamp (yyyy-mm-dd hh:mm:ss.fff)。

时间戳的时间部分不被评估，可以省略。

第九十六章 SQL函数 MOD

注：IRIS可用，非IRIS版本不可用。

标量数值函数，返回一个数除以另一个数的模数（余数）。

大纲

MOD(dividend,divisor)

{fn MOD(dividend,divisor)}

参数

• dividend - 数字，它是除法的分子（除数）。
• divisor - 数字，它是除法的分母（除数）。

MOD 返回 NUMERIC 数据类型，除非被除数是数据类型 DOUBLE。如果dividend 为 DOUBLE，则 MOD 返回 DOUBLE。

描述

MOD 返回除数除数的数学余数（模数）。

第九十四章 SQL函数 %MINUS

将数字转换为规范整理格式，然后反转符号的整理函数。

大纲

%MINUS(expression)

%MINUS expression

参数

• expression - 表达式，可以是列名、数字或字符串文字、算术表达式或另一个函数的结果，其中基础数据类型可以表示为任何字符类型。

描述

%MINUS 将数字或数字字符串转换为规范形式，反转符号，然后以数字排序规则返回这些表达式值。

%MINUS 和 %PLUS 在功能上是相同的，只是 %MINUS 反转了符号。它为解析为正数的任何数字添加减号前缀，并从解析为负数的任何数字中删除减号。零从不签名。

[toc]

第九十二章 SQL函数 LPAD

字符串函数，它返回一个左填充到指定长度的字符串。

第九十章 SQL函数 LOG10

标量数值函数，它返回给定数值表达式的以 10 为底的对数。

大纲

{fn LOG10(expression)}

参数

• expression - 数值表达式。

LOG10 返回 NUMERIC 或 DOUBLE 数据类型。如果表达式为 DOUBLE数据类型，则 LOG10 返回 DOUBLE；否则，它返回 NUMERIC。

描述

LOG10 返回表达式的以 10 为底的对数值。LOG10 返回一个精度为 21、小数位数为 18 的值。

LOG10 只能用作 ODBC 标量函数（使用大括号语法）。

第八十八章 SQL函数 $LISTTOSTRING

从列表创建字符串的列表函数。

大纲

$LISTTOSTRING(list[,delimiter])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。可以使用 SQL 或 ObjectScript $LIST 函数从现有列表中提取列表。
• delimiter - 可选 — 插入以分隔子字符串的分隔符。分隔符可以是一个或多个字符，指定为带引号的字符串。要连接不带分隔符的子字符串，请指定空字符串 ('')。如果不指定分隔符，则默认为逗号 (,) 字符。

描述

$LISTTOSTRING 采用 列表并将其转换为字符串。在结果字符串中，列表的元素由分隔符分隔。

第八十六章 SQL函数 $LISTLENGTH

返回指定列表中元素数量的列表函数。

大纲

$LISTLENGTH(list)

参数

• list- 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。您可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。您可以使用 SQL 或 ObjectScript $LIST 函数从现有列表中提取列表。

描述

$LISTLENGTH 返回列表中元素的数量。

此函数返回 SMALLINT 类型的数据。

示例

以下嵌入式 SQL 示例返回 3，因为列表中有 3 个元素：

第八十四章 SQL函数 $LISTFROMSTRING

从字符串创建列表的列表函数。

大纲

$LISTFROMSTRING(string[,delimiter])

参数

• string - 要转换为 列表的字符串。此字符串包含一个或多个元素，由分隔符分隔。分隔符不会成为生成的列表的一部分。
• delimiter - 可选 — 用于分隔字符串中的子字符串（元素）的分隔符。将分隔符指定为带引号的字符串。如果未指定分隔符，则默认为逗号 (,) 字符。

描述

$LISTFROMSTRING 接受一个包含分隔元素的带引号的字符串并返回一个列表。列表以不使用分隔符的编码格式表示数据。因此，列表可以包含所有可能的字符，并且非常适合位串数据。使用 ObjectScript 和 SQL $LIST 函数处理列表。

第八十二章 SQL函数 $LISTDATA

列表函数，指示指定元素是否存在并具有数据值。

大纲

$LISTDATA(list[,position])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。您可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。您可以使用 SQL 或 ObjectScript $LIST 函数从现有列表中提取列表。
• position - 可选 — 指定列表中元素的整数表达式。

描述

$LISTDATA 检查列表中请求元素中的数据。如果位置参数指示的元素在列表中并且具有数据值，则 $LISTDATA 返回值 1。如果元素不在列表中或没有数据值，则 $LISTDATA 返回值 0。