.foreach_part Macro

This macro iterates through and transforms the parts of the input template, with the parts delimited by a separator pattern.

.foreach_part (expression [,"separator" [,head [,tail]]])
	simple-template
.next[(separator)]

This macro creates a new scope wherein the local variable CurrentPart is defined to be the i-th part of the input template at iteration i. The Separator local variable contains the following separator.

This macro is often used in applying naming conventions (see Core Features Guide > The PowerDesigner Interface > Objects > Object Properties > Naming Conventions).

The following parameters are available:

Parameter	Description
`input`	Input text over which iteration is performed Type: Simple template
`separator-pattern`	Char and word separators Any character specified in the pattern can be used as separator [<c1> - <c2>] specifies a character within the range defined between both characters <c1> and <c2> For example, the pattern " -_,[A-Z]" specifies that each part can be separated by a space, a dash, an underscore, a comma or a character between A and Z (in capital letter). By default, the <separator-pattern> is initialized with the pattern (). If the specified pattern is empty, the pattern is initialized using the default value. A separator <separator> can be concatenated between each part. <head> and <tail> expressions can be added respectively at the bottom or at the end of the generated expression. There are two kinds of separator: Char separator - for each char separator, the separator specified in the next statement of the macro is returned (even for consecutive separators) Word separator - they are specified as interval, for example [A-Z] specifies that all capital letters are separator. For a word separator, no separator (specified in next statement) is returned Default: " -_,\t" Type: Text
`head`	[optional] Generated before output, if there is one Type: Text
`tail`	[optional] Appended to the output, if there is one Type: Text
`simple-template`	Template to apply to each part. Type: Complex template
`separator`	[optional] Generated between non empty evaluations of `complex-template` Type: Text

Examples:

Convert a name into a class code (Java naming convention). In the following example, the variable %Name% is equal to Employee shareholder, and it is converted to EmployeeShareholder:

.foreach_part (%Name%, " _-'")
	%.FU:CurrentPart%
.next

Convert a name into a class attribute code (Java naming convention). In the following example, the variable %Name% is equal to Employee shareholder, and it is converted to EmployeeShareholder:

.set_value(_First, true, new)
.foreach_part(%Name%,"' _-'")
	.if (%_First%)
		%.L:CurrentPart%
		.set_value(_First, false, update)
	.else
		%.FU:CurrentPart%
	.endif
.next