6.13.4 SubstringObjects (Acquire substring function)

Acquire substring function (substr).

Organization of this subsection
(1) Definition items
(2) Definition example

(1) Definition items

Following table describes the definition items.

Table 6-29 TableSubstringObjects definition items

Item nameDefinition contentsValue that you can defineAdditional description
NameFunction nameValue of NCName typeThis is mandatory item. You cannot define same Name in Objects, in duplication.
InputInputSee "6.12.2 Setting up the mapping definition"-
AcquisitionSpecification itemEither of "left", "right", "division"This is mandatory item.
In case of "left"
As specification method, set "Specify range from the beginning"
In case of "right"
As specification method, set "Specify range from end"
In case of "division"
As specification method, set "Specify division character string"
StartStart positionInteger of 1~2,147,483,647This is mandatory item when acquisition is "left" or "right".
In other cases, setting value is not incorporated.
Surrogate pair is handled as 2 characters.
CountCharacters countInteger of 0~2,147,483,647 or spaceWhen Acquisition is "left" or "right" and Count is blank, set "all after start position".
When Acquisition is other than "left" and "right", setting value is not incorporated.
Surrogate pair is handled as 2 characters.
StringDivision character stringCharacter string less than 1,024 characters (you cannot define linefeed)This is mandatory item when Acquisition is "division".
In other cases, setting value is not incorporated.
PartAcquisition position"pre" or "post"This is mandatory item when Acquisition is "division".
In other cases, setting value is not incorporated.
In case of "pre"
Set "Previous" as acquisition part.
In case of "post"
Set "Post" as acquisition part.
(Legend)
-: Corresponding item does not exist.

(2) Definition example

Following figure shows the definition example:

Figure 6-66 FigureSubstringObjects definition example1

[Figure]

Figure 6-67 FigureSubstringObjects definition example2

[Figure]

Figure 6-68 FigureSubstringObjects definition example3

[Figure]