copyStr()

系统函数 StrLib.copyStr 将一个子串复制至另一个子串。

  StrLib.copyStr(
    target VagText inOut,
    targetSubstringIndex INT in,
    targetSubstringLength INT in,
    source VagText in,
    sourceSubstringIndex INT in,
    sourcetSubstringLength INT in)
target
从中派生目标子串的字符串。可以是项或文字。
targetSubstringIndex
在假定 target 中的第一个字节具有值 1 的情况下,标识 target 中的起始字节。此下标可以是整数文字。另外,此下标可以是被定义为具有 INT 类型或者具有以下等效类型的项:BIN 类型,长度为 9 并且不带小数位。
targetSubstringLength
标识从 target 派生的子串中的字节数。长度可以是整数文字。另外,长度可以是被定义为具有 INT 类型或者具有以下等效类型的项:BIN 类型,长度为 9 并且不带小数位。
source
从中派生源子串的字符串。可以是项或文字。
sourceSubstringIndex
在假定 source 中的第一个字节具有值 1 的情况下,标识子串在 source 中的起始字节。此下标可以是整数文字。另外,此下标可以是被定义为具有 INT 类型或者具有以下等效类型的项:BIN 类型,长度为 9 并且不带小数位。
sourceSubstringLength
标识从 source 派生的子串中的字节数。长度可以是整数文字。另外,长度可以是被定义为具有 INT 类型或者具有以下等效类型的项:BIN 类型,长度为 9 并且不带小数位。

如果源比目标长,则将源截断。如果源比目标短,则在右边用空格对源值进行填充。

定义注意事项

sysVar.errorCode 中返回下列值:
8
下标小于 1 或大于字符串长度。
12
长度小于 1。
20
双字节下标无效。DBCHAR 或 UNICODE 字符串的下标指向双字节字符的中间。
24
双字节长度无效。DBCS 或 UNICODE 字符串的以字节计的长度是奇数(双字节长度必须总是偶数)。

示例

  target = "120056";
  source = "34";
  StrLib.copyStr(target,3,2,source,1,2);
  // target = "123456"

相关参考
EGL 库 StrLib

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.