substring Method

Microsoft Office JScript

Microsoft® JScript® substring Method  Language Reference 
Version 1 

See Also                  Applies To


Description
Returns the substring at the specified location within a String object.
Syntax
strVariable.substring(start, end)
"String Literal".substring(start, end)

The substring method syntax has these arguments:

Part Description
start The zero-based index indicating the beginning of the substring.
end The zero-based index indicating the end of the substring.

Remarks
The substring method returns a String object containing the substring derived from the original object.

The substring method uses the lower of start and end as the beginning point of the substring. For example, strvar.substring(0, 3) and strvar.substring(3, 0) return the same substring.

The only exception to this is for negative parameters. If the first parameter is less than zero, it is treated as zero. If the second parameter is negative, it is set to the value of the first parameter.

The length of the substring is equal to the absolute value of the difference between start and end. For example, the length of the substring returned in strvar.substring(0, 3) and strvar.substring(3, 0) is three.

Finally, start and end can be strings. If so, these strings are coerced into integers if possible. If not, the value of the parameter is treated as zero.

The following example illustrates the use of the substring method:

function SubstringDemo()
{
  var s, ss;
  var s = "The quick brown fox jumped over the lazy yellow dog.";
  ss = s.substring(16, 19);
  return(ss);
}