substringData Method

 

Retrieves a substring of the full string from the specified range.

strValue = oXMLDOMCharacterData.substringData(offset, count);  

Parameters

offset
A long integer value indicating the offset, in characters, from the beginning of the string. An offset of zero indicates copying from the start of the data.

count
A long integer value indicating the number of characters to retrieve from the specified offset.

Return Value

A string. Returns the substring.

Example

The following script example creates an IXMLDOMComment object (comment), and then uses the substringData method to retrieve the first five characters of the object.

System_CAPS_ICON_note.jpg Note

You can use books.xml to run this sample code.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.6.0");
var comment;
var MyStr;
xmlDoc.async = false;
xmlDoc.load("books.xml");
if (xmlDoc.parseError.errorCode != 0) {
   var myErr = xmlDoc.parseError;
   WScript.Echo("You have error " + myErr.reason);
} else {
   comment = xmlDoc.createComment("Hello World!");
   MyStr = comment.substringData(0, 5);
   WScript.Echo(MyStr);
}

Output

Hello

HRESULT substringData(  
    long offset,  
    long count,  
    BSTR *data);  

Parameters

offset[in]
The offset, in characters, from the beginning of the string. An offset of zero indicates copying from the start of the data.

count[in]
The number of characters to retrieve from the specified offset.

data[out, retval]
The substring to return.

Return Values

S_OK
The value returned if successful.

S_FALSE
The value when returning Null.

If the offset and count parameters indicate a range beyond the end of the string, the returned substring continues only until the end of the string data.

Implemented in: MSXML 3.0 and MSXML 6.0

IXMLDOMCDATASection
IXMLDOMCharacterData
IXMLDOMComment
IXMLDOMText

Show: