DTW_DELWORD

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

Purpose

Deletes words in a string, starting from word n for the number of words specified by length.

Format

@DTW_DELWORD(stringIn, n, length, stringOut)

@DTW_DELWORD(stringIn, n, stringOut)

@DTW_rDELWORD(stringIn, n, length)

@DTW_rDELWORD(stringIn, n)

Parameters

Table 106. DTW_DELWORD Parameters
Data Type Parameter Use Description
string stringIn IN A variable or literal string.
integer n IN The word position of the first word to be deleted.
integer length IN The number of words to delete. The default is to delete all words from n to the end of stringIn. Optional parameter.
string stringOut OUT A variable that contains the modified form of stringIn.

Return Codes

Table 107. DTW_DELWORD 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 An incorrect number of parameters were passed on a function call.
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_DELWORD("Now is the time", "5", result)

Example 2:

@DTW_DELWORD("Now is the time", "2", result)

Example 3:

@DTW_DELWORD("Now is the time", "2", "2", result)

Example 4:

@DTW_rDELWORD("Now is the time.", "3")


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