Purpose:
Gives the user the ability to print out the contents of an array.  Adds the ability to see the brackets at the beginning and end of the array and any sub-arrays.

Parameters:

Returns:
A string displaying the contents of the array.  If showBrackets is set to true, the string will contain brackets denoting the start and end of of the array and any sub-arrays.

Example #1:
The code below will show you how to display the contents of the array in the traditional sense (without brackets):

var arr = [10, [5, [2, 3]], [1], [4, [1, -2, 5]]]; var arr2 = [10, 5, 2, 3, 1, 4, 1, -2, 5]; alert('The variable "arr" contains the following:\n' + arr.toString() + '\n\nThe variable "arr2" contains the following:\n' + arr2.toString() + "\n\nUnfortunately, though this is what JavaScript ordina" + "rily returns when displaying an array as a string, it is obvious that it d" + "oesn't make it clear that \"arr\" and \"arr2\" aren't the same.");

Example #2:
The code below will show you how to display the contents of the array with brackets:

var arr = [10, [5, [2, 3]], [1], [4, [1, -2, 5]]]; var arr2 = [10, 5, 2, 3, 1, 4, 1, -2, 5]; alert('The variable "arr" contains the following:\n' + arr.toString(true) + '\n\nThe variable "arr2" contains the following:\n' + arr2.toString(true) + '\n\nNow you see that "arr" and "arr2" are definitely' + ' not the same. This small feature is one of the many reasons why JXtensio' + 'n is helpful.');

Example #3 (only works for version 1.1 or higher):
This example shows what will happen if an array is a descendant of itself:

var arr1 = [1,2,3]; var arr2 = [4,3,2,arr1]; arr1.push(arr2); alert('This is the value of "arr1":\n' + arr1.toString(true) + '\n\nThis is the value of "arr2":\n' + arr2.toString(true))