subarray Method (Uint8ClampedArray)

Gets a new Uint8ClampedArray view of the ArrayBuffer store for this array, specifying the first and last members of the subarray.

Syntax

var newUint8ClampedArray = uint8ClampedArray.subarray(begin, end);  

Parameters

newUint8ClampedArray
Required. The subarray returned by this method.

begin
Optional. The index of the beginning of the array.

end
Optional. The index of the end of the array. This is non-inclusive.

Remarks

If either begin or end is negative, it refers to an index from the end of the array, as opposed to from the beginning. If end is unspecified, the subarray contains all elements from begin to the end of the typed array. The range specified by the begin and end values is clamped to the valid index range for the current array. If the computed length of the new typed array would be negative, it is clamped to zero. The returned array has the same type as the array on which this method is invoked.

Example

The following example shows how to get a subarray that is two elements long, starting with the first element of the array.

var req = new XMLHttpRequest();  
    req.open('GET', "http://www.example.com");  
    req.responseType = "arraybuffer";  
    req.send();  

    req.onreadystatechange = function () {  
        if (req.readyState === 4) {  
            var buffer = req.response;  
            var intArr = new Uint8ClampedArray(buffer.byteLength);  
            var subArr = intArr.subarray(0, 2);  
        }  
    }  

Requirements

Supported in the Internet Explorer 11 standards document mode. Also supported in Windows Store apps (Windows 8.1). See Version Information.
Not supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards, Internet Explorer 10 standards. Not supported in Windows 8 or Windows Phone 8.1.

See Also

Uint8Array Object
ArrayBuffer Object
Uint8ClampedArray Object