IBM Books

Reference

DTW_WORD


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X X

Purpose

Returns the nthe word in a string.

Format

@DTW_WORD(stringIn, n, stringOut)

@DTW_rWORD(stringIn, n)

Parameters

Table 108. DTW_WORD Parameters

Data Type Parameter Use Description
string stringIn IN A variable or literal string.
integer n IN The word position of the word to return. If this value is greater than the number of words in stringIn, a null is returned.
string stringOut OUT A variable that contains the word at word position n.

Return Codes

Table 109. DTW_WORD Return Codes

Return Code Explanation
-1001 The server could not process a Net.Data request to allocate memory.
1001 An input parameter contained a NULL value.
1003 The number of parameters passed on a function call either exceeded the maximum number allowed, or was less than the minimum number required by the function.
1005 A parameter passed on a function call, required to be a string variable, was of a different variable type.
1006 A literal string was passed on a function call for a parameter which was required to be an output parameter.
1007 A parameter contains a value which is not valid.

Examples

Example 1:

@DTW_WORD("Now is the time", "3", result)

Example 2:

@DTW_WORD("Now is the time", "5", result)

Example 3:

@DTW_rWORD("Now is the time", "4")


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]