第十章 设置结构化日志记录（二）

注：IRIS有，Cache无。

启用结构化日志记录

^LOGDMN 例程允许管理结构化日志记录；还有一个基于类的 API，将在下一节中介绍。

要使用 ^LOGDMN 启用结构化日志记录：

1. 打开终端并输入以下命令：

set $namespace="%sys"
do ^LOGDMN

这将启动一个带有以下提示的例程：

第二十五章 SQL函数 CHAR

返回具有在字符串表达式中指定的ASCII代码值的字符的字符串函数。

大纲

CHAR(code-value)

{fn CHAR(code-value)}

参数

• code-value - 与字符相对应的整数代码。

描述

Char返回与指定的整数代码值对应的字符。因为 IRIS是UNICODE系统，所以可以为任何UNICODE字符指定整数代码，从0到65535。如果code-value是超出允许值范围的整数，则CHAR返回NULL。

如果代码值是非数字字符串，则CHAR返回一个空字符串（''）。如果传递空值，CHAR返回NULL。

第104章 SQL函数 %ODBCOUT

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

大纲

%ODBCOUT(expression)

%ODBCOUT expression

参数

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

描述

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

第七十四章 SQL命令 SET TRANSACTION

设置事务的参数。

第一章 聚合函数概述

计算列的所有值并返回单个聚合值的函数。

支持聚合函数

聚合函数执行与单个列中的一个或多个值相关的任务，并返回单个值。
支持的功能有:

第五章 操作位和位串

有时可能希望在基于数据平台的应用程序中存储一系列相关的布尔值。可以创建许多布尔变量，也可以将它们存储在数组或列表中。或者可以使用称为“位串”的概念，它可以定义为位序列，首先呈现最低有效位。位串允许您以非常有效的方式存储此类数据，无论是在存储空间还是处理速度方面。

位串可以以两种方式之一存储，作为压缩字符串或整数。如果在没有上下文的情况下听到术语“位串”，则表示位序列存储为压缩字符串。本文向介绍了这两种类型的位串，然后介绍了一些可用于操作它们的技术。

将位序列存储为位串

存储位序列的最常见方式是在位串中，这是一种特殊的压缩字符串。除了节省存储空间外，还可以使用 ObjectScript 系统函数有效地操作位串。

这样的系统函数是 $factor，它将整数转换为位串。我们可以通过执行以下语句将整数 11744 转换为位串：

set bitstring = $factor(11744)

要查看位串内容的表示，可以使用 zwrite 命令：

第118章 SQL函数 REVERSE

标量字符串函数，它以相反的字符顺序返回一个字符串。

大纲

REVERSE(string-expression)

参数

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

描述

REVERSE 返回字符顺序颠倒的字符串表达式。例如 'Hello World!' 返回为 '!dlroW olleH'。这是一个简单的字符串顺序反转，没有额外的处理。

返回的字符串是数据类型 VARCHAR，与输入值的数据类型无关。数字转换为规范形式，数字字符串在反转之前不会转换为规范形式。

前导和尾随空白不受反转的影响。

反转 NULL 值会导致 NULL。

第103章 SQL函数 %ODBCIN

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

大纲

%ODBCIN(expression)

%ODBCIN expression

参数

• expression - 要转换的表达式。

描述

%ODBCIN 在通过字段或数据类型的 OdbcToLogical 方法传递值后以逻辑格式返回表达式。逻辑格式是数据的内存格式（执行操作的格式）。

%ODBCIN 是一个 SQL 扩展。

示例

以下示例显示了同一字段的默认显示格式、%ODBCIN 和 %ODBCOUT 格式。

第123章 SQL函数 SEARCH_INDEX

从索引的 Find() 方法返回一组值的函数。

第二十章 SQL谓词 %STARTSWITH（二）

首尾空格

在大多数情况下，%STARTSWITH将前导空格视为与任何其他字符相同的字符。
例如，%STARTSWITH ' B'可用于选择只有一个前导空白后跟字母B的字段值。然而，只包含空白的子字符串不能选择前导空白;
它选择非空值。

尾随空格的%STARTSWITH行为取决于数据类型和排序规则类型。
%STARTSWITH忽略定义为SQLUPPER的字符串子串的尾随空格。
%STARTSWITH不会忽略数字、日期或列表子字符串中的尾随空格。

在下面的示例中，%STARTSWITH将结果集限制为以“M”开头的名称。
因为Name是一个SQLUPPER字符串数据类型，子字符串的末尾空格将被忽略:

第二十三章 SQL函数 CAST（二）

转换位值

可以将expr值转换为BIT以返回0或1。
如果expr为1或任何其他非零数值，则返回1。
如果expr为“TRUE”、“TRUE”或“TRUE”，则返回1。
(“True”可以用任何大小写组合表示，但不能缩写为“T”。)
如果expr是任何其他非数值值，则返回0。
如果expr为0，则返回0。

在下面的例子中，前5个CAST操作返回1，后5个CAST操作返回0:

第二十四章 SQL函数 CEILING

数值函数，返回大于或等于给定数值表达式的最小整数。

大纲

CEILING(numeric-expression)

{fn CEILING(numeric-expression)}

参数

• numeric-expression - 要计算其上限的数字。

CELING返回与NUMERIC-EXPRESSION相同的数据类型。

描述

CELING返回大于或等于NUMERIC-EXPRESSION的最接近的整数值。返回值的小数位数为0。当numeric-expression为NULL值、空字符串(‘’)或任何非数字字符串时，CELING返回NULL。

第四十七章 SQL函数 DAYNAME

Date函数，它返回日期表达式的星期几的名称。

大纲

{fn DAYNAME(date-expression)}

参数

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

描述

DAYNAME返回与指定日期对应的日期的名称。返回值为字符串，最大长度为15。默认返回的日期名称为：Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday。

要更改这些默认日期名称值，请使用带有WEEKDAY_NAME选项的SET OPTION命令。

第七章 操作位和位串（三）

操作位串

要创建新的位串，请使用 $bit 函数将所需位设置为 1：

kill bitstring

set $bit(bitstring, 3) = 1

set $bit(bitstring, 6) = 1

set $bit(bitstring, 11) = 1

使用 $bit 将现有位串中的位设置为 1：

set $bit(bitstring, 5) = 1

使用 $bit 将现有位串中的位设置为 0：

set $bit(bitstring, 5) = 0

由于位串中的第一位是位 1，因此尝试设置位 0 会返回错误：