第九十六章 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。

第八十章 SQL函数 $LIST（二）

示例

在以下嵌入式 SQL 示例中，两个 WRITE 语句都返回“Red”，即列表中的第一个元素。第一个默认写入第一个元素，第二个写入第一个元素，因为位置参数设置为 1：

第七十八章 SQL函数 $LENGTH

返回字符串中字符数或分隔子字符串数的字符串函数。

大纲

$LENGTH(expression[,delimiter])

参数

• expression - 目标字符串。它可以是数值、字符串文字、任何变量的名称或任何有效的表达式。
• delimiter - 可选 — 在目标字符串中划分不同子字符串的字符串。它必须是字符串文字，但可以是任意长度。括起来的引号是必需的。

$LENGTH 返回 SMALLINT 数据类型。

第七十六章 SQL函数 LEN

返回字符串表达式中字符数的字符串函数。

大纲

LEN(string-expression)

参数

• string-expression - 字符串表达式，可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。

LEN 返回 INTEGER 数据类型。

描述

注意：LEN 函数是 LENGTH 函数的别名。

SELECT len("yaoxin")  

6

第七十四章 SQL函数 LEAST

从一系列表达式中返回最小值的函数。

大纲

LEAST(expression,expression[,...])

参数

• expression - 解析为数字或字符串的表达式。
  将这些表达式的值相互比较，并返回最小值。
  表达式可以是字段名、文字、算术表达式、主机变量或对象引用。
  最多可以列出140个逗号分隔的表达式。

描述

LEAST从逗号分隔的表达式序列中返回最小值。
表达式按从左到右的顺序求值。
如果只提供一个表达式，则LEAST返回该值。
如果任何表达式为NULL, LEAST返回NULL。

第七十二章 SQL函数 LAST_IDENTITY

返回最后插入、更新、删除或读取的行的标识的标量函数。

大纲

LAST_IDENTITY()

描述

LAST_IDENTITY函数返回%ROWID局部变量值。在嵌入式SQL或ODBC中将%ROWID局部变量设置为一个值。动态SQL、SQL Shell或管理门户SQL界面未将%ROWID局部变量设置为值。动态SQL改为设置%ROWID对象属性。

LAST_IDENTITY函数不接受任何参数。请注意，参数括号是必需的。

LAST_IDENTITY返回受当前进程影响的最后一行的标识字段值。如果表没有标识字段，则返回受当前进程影响的最后一行的行ID(%ROWID)。返回值为数据类型INTEGER。

第七十章 SQL函数 $JUSTIFY

在指定宽度内右对齐值的函数，可以选择舍入到指定的小数位数。

大纲

$JUSTIFY(expression,width[,decimal])

参数

• expression - 要右对齐的值。它可以是数字值、字符串文字或解析为数字或字符串的表达式。
• width - 表达式要在其中右对齐的字符数。正整数或计算结果为正整数的表达式。
• decimal - 可选-小数位数。正整数或计算结果为正整数的表达式。将表达式中的小数位数四舍五入或填充到此值。如果指定DECIMAL，会将表达式视为数字。

描述

$JUSTIFY返回在指定宽度内右对齐的表达式指定的值。可以包括小数参数以在宽度内小数对齐数字。