nthElement() | Decadis App Help Center

Number list

This function returns the nth element of the given number list. N specifies the position of an element in a list.

Bash

nthElement(numberList, position) #Output: Number

Examples

Parser expression	Description
Bash `%{nthElement([5, 6, 7, 8], 3)}`	This example returns: 7

Parser expression

Description

Bash

%{nthElement([5, 6, 7, 8], 3)}

This example returns:

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`numberList`	number list	Any given number list.
`position`	number	A number satisfying the following condition: `1 <= position <= count(list)`

Output

This function returns a number

If the position is out of bounds (position > count(list)), the function returns null . In case the position is less than 1, an error is returned.

If the number list is empty, the function returns null

Text list

This function returns the nth element of the given text list. N specifies the position of an element in a list.

Syntax

Bash

nthElement(textList, position) #Output: Text

Examples

Parser expression	Description
Bash `%{nthElement(["blue", "red", "green"], 2)}`	This example returns: red

Parser expression

Description

Bash

%{nthElement(["blue", "red", "green"], 2)}

This example returns:

red

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`textList`	text list	Any given text list.
`position`	number	A number satisfying the following condition: `1 <= position <= count(list)`

Output

This function returns a text

If the position is out of bounds (position > count(list)), the function returns null . In case the position is less than 1, an error is returned.

If the text list is empty, the function returns null

Issue list

This function returns an issue list with the nth element of the given issue list. N specifies the position of an element in a list.

Bash

nthElement(issueList, position) #Output: Issue list

Examples

Parser expression	Description
Bash `%{nthElement(subtasks(), 2)}`	This example returns the second sub-task of the current issue, e.g.: IT-9289 To achieve this, the following functions are used: subtasks()

Parser expression

Description

Bash

%{nthElement(subtasks(), 2)}

This example returns the second sub-task of the current issue, e.g.:

IT-9289

To achieve this, the following functions are used:

subtasks()

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`issueList`	issue list	Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
`position`	number	A number satisfying the following condition: `1 <= position <= count(list)`

Output

This function returns an issue list

If the position is out of bounds (position > count(list)), the function returns an empty issue list . In case the position is less than 1, an error is returned.

If the issue list is empty, the function returns an empty issue list

(books) Use cases and examples

Use case
No content found.