Siebel eScript Language Reference > C Language Library Reference > Clib String Methods >

Clib Append String Method


The Clib Append String method copies characters from one string to the end of another string. It appends up to the value that you specify in the maxLen argument of the string that you specify in the sourceString argument. It does not copy any character that occurs after a null byte. It returns the appended string that the destString argument contains.

The length of the destString argument is the lesser of the maxLen argument or the length of the sourceString argument.

Format

Clib.strncat(destString, sourceString, maxLen)

Table 153 describes the arguments for the Clib Append String method.

Table 153. Arguments for the Clib Append String Method
Argument
Description

sourceString

The string that this method uses to get the characters that it adds.

destString

The string where this method adds characters.

maxLen

The maximum number of characters to add.

Example

The following example uses the Clib Append String method:

var string1 = "I love to ";
var string2 = "ride hang-gliders and motor scooters.";
Clib.strncat(string1, string2, 17);
TheApplication().RaiseErrorText(string1);

This example returns the following string:

"I love to ride hang-gliders"

Related Topics

For more information, see Clib Copy String Method.

Siebel eScript Language Reference Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.