IFX_ALLOW_NEWLINE 函数

IFX_ALLOW_NEWLINE 函数设置换行模式，在当前的会话内在用引号括起来的字符串中允许还是不允许换行字符。

IFX_ALLOW_NEWLINE 函数有下列语法。

如果您输入 't' 作为此函数的参数，则在该会话中启用用引号括起来的字符串中的换行字符。如果您输入 'f' 作为参数，则在该会话中不允许用引号括起来的字符串中的换行字符。

您可通过将 ONCONFIG 文件中的 ALLOW_NEWLINE 参数设置为值 0（不允许换行字符）或值 1（允许换行字符）来为所有会话设置换行模式。如果您未设置此配置参数，则缺省的值为 0。您每一次启动会话时，新的会话继承 ONCONFIG 文件中的换行模式设置。要更改会话的换行模式，请执行 IFX_ALLOW_NEWLINE 函数。一旦您已为会话设置了换行模式，该模式保持有效，直到会话结束为止，或直到您在会话内在此执行 IFX_ALLOW_NEWLINE 函数为止。

在下列示例中，假设您未为 ONCONFIG 文件中的 ALLOW_NEWLINE 指定任何值，因此，在缺省情况下，在任何会话中的用引号括起来的字符串中不允许换行字符。在您启动新的会话之后，您可通过执行 IFX_ALLOW_NEWLINE 函数来启用那个会话中的用引号括起来的字符串中的换行字符：

EXECUTE PROCEDURE IFX_ALLOW_NEWLINE('t');

在 ESQL/C 中，通过 ONCONFIG 文件中的 ALLOW_NEWLINE 参数设置换行模式，或通过在会话中执行 IFX_ALLOW_NEWLINE 函数设置换行模式，换行模式仅适用于 SQL 语句中的用引号括起来的字符串文字。换行模式不适用于 SQL 语句中包含在主变量中的用引号括起来的字符串。主变量可在字符串数据内包含换行字符，不理会当前生效的换行模式。

例如，您可使用主变量来将包含换行字符的数据插入到列内，即使 ONCONFIG 文件中的 ALLOW_NEWLINE 参数设置为 0。

要获取关于 IFX_ALLOW_NEWLINE 函数如何影响用引号括起来的字符串的更多信息，请参阅用引号括起的字符串。要获取关于 ONCONFIG 文件中的 ALLOW_NEWLINE 参数的更多信息，请参阅 GBase 8s 管理员参考手册。