control-freak-ide/misc/pocs/GoJS/api/symbols/List.html
plastic-hub-dev-node-saturn 538369cff7 latest
2021-05-12 18:35:18 +02:00

2264 lines
75 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>GoJS&reg; List Class</title>
<script src="../../assets/js/jquery.min.js"></script>
<script src="../../assets/js/bootstrap.min.js"></script>
<script src="../../assets/js/highlight.js"></script>
<script src="../../assets/js/api.js"></script>
<link href="../../assets/css/bootstrap.min.css" rel="stylesheet" >
<!-- custom CSS after bootstrap -->
<link href="../../assets/css/main.css" rel="stylesheet" type="text/css"/>
<link href="../../assets/css/api.css" rel="stylesheet" type="text/css"/>
<!--<link rel="stylesheet" href="../../assets/css/api.css" type="text/css" media="all" />-->
<link rel="stylesheet" href="../../assets/css/highlight.css" type="text/css" media="all" />
</head>
<body>
<!-- non-fixed navbar -->
<nav id="non-fixed-nav" class="navbar navbar-inverse navbar-top">
<div class="container-fluid">
<div class="navbar-header">
<div class="navheader-container">
<div class="navheader-collapse" data-toggle="collapse" data-target="#navbar">
<a id="toplogo" class="navbar-brand" href="../../index.html">GoJS</a>
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#navbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
</div>
</div>
<div id="navbar" class="navbar-collapse collapse">
<ul class="nav navbar-nav navbar-right">
<li><a href="../../index.html">Home</a></li>
<li><a href="../../learn/index.html">Learn</a></li>
<li><a href="../../samples/index.html">Samples</a></li>
<li><a href="../../intro/index.html">Intro</a></li>
<li><a href="../../api/index.html">API</a></li>
<li><a href="https://www.nwoods.com/components/evalform.htm">Register</a></li>
<li><a href="../../doc/download.html">Download</a></li>
<li><a href="https://forum.nwoods.com/c/gojs">Forum</a></li>
<li><a href="https://www.nwoods.com/contact.html" onclick="ga('send','event','Outbound Link','click','contact');">Contact</a></li>
<li class="buy"><a href="https://www.nwoods.com/sales/index.html" onclick="ga('send','event','Outbound Link','click','buy');">Buy</a></li>
<li class="activate"><a href="https://www.nwoods.com/app/activate.aspx?sku=gojs">Activate</a></li>
</ul>
</div><!--/.nav-collapse -->
</div>
</nav>
<div class="container-fluid">
<!-- ============================== classes index ============================ -->
<div id="navindex" class="col-md-2">
<!-- begin publish.classesIndex -->
<!-- <div><a href="../index.html">GoJS Class Index</a></div> -->
<div class="sidebar-nav">
<div class="navbar navbar-default" role="navigation">
<div class="navbar-header">
<div class="navheader-container">
<div class="navheader-collapse" data-toggle="collapse" data-target="#DiagramNavbar">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#DiagramNavbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
<span class="navbar-brand">Diagram Classes</span>
</div>
</div>
<div id="DiagramNavbar" class="navbar-collapse collapse sidebar-navbar-collapse">
<ul class="classList nav navbar-nav">
<li><a href="../symbols/Adornment.html" class="linkConstructor">Adornment</a></li>
<li><a href="../symbols/AnimationManager.html" class="linkConstructor">AnimationManager</a></li>
<li><a href="../symbols/CommandHandler.html" class="linkConstructor">CommandHandler</a></li>
<li><a href="../symbols/Diagram.html" class="linkConstructor">Diagram</a></li>
<li><a href="../symbols/DiagramEvent.html" class="linkConstructor">DiagramEvent</a></li>
<li><a href="../symbols/GraphObject.html" class="linkConstructor">GraphObject</a></li>
<li><a href="../symbols/Group.html" class="linkConstructor">Group</a></li>
<li><a href="../symbols/InputEvent.html" class="linkConstructor">InputEvent</a></li>
<li><a href="../symbols/Layer.html" class="linkConstructor">Layer</a></li>
<li><a href="../symbols/Link.html" class="linkConstructor">Link</a></li>
<li><a href="../symbols/Node.html" class="linkConstructor">Node</a></li>
<li><a href="../symbols/Overview.html" class="linkConstructor">Overview</a></li>
<li><a href="../symbols/Palette.html" class="linkConstructor">Palette</a></li>
<li><a href="../symbols/Panel.html" class="linkConstructor">Panel</a></li>
<li><a href="../symbols/Part.html" class="linkConstructor">Part</a></li>
<li><a href="../symbols/Picture.html" class="linkConstructor">Picture</a></li>
<li><a href="../symbols/Placeholder.html" class="linkConstructor">Placeholder</a></li>
<li><a href="../symbols/RowColumnDefinition.html" class="linkConstructor">RowColumnDefinition</a></li>
<li><a href="../symbols/Shape.html" class="linkConstructor">Shape</a></li>
<li><a href="../symbols/TextBlock.html" class="linkConstructor">TextBlock</a></li>
</ul>
</div>
</div>
<div class="navbar navbar-default" role="navigation">
<div class="navbar-header">
<div class="navheader-container">
<div class="navheader-collapse" data-toggle="collapse" data-target="#GeometryNavbar">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#GeometryNavbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
<span class="navbar-brand">Geometry Classes</span>
</div>
</div>
<div id="GeometryNavbar" class="navbar-collapse collapse sidebar-navbar-collapse">
<ul class="classList nav navbar-nav">
<li><a href="../symbols/Brush.html" class="linkConstructor">Brush</a></li>
<li><a href="../symbols/Geometry.html" class="linkConstructor">Geometry</a></li>
<li><a href="../symbols/Margin.html" class="linkConstructor">Margin</a></li>
<li><a href="../symbols/PathFigure.html" class="linkConstructor">PathFigure</a></li>
<li><a href="../symbols/PathSegment.html" class="linkConstructor">PathSegment</a></li>
<li><a href="../symbols/Point.html" class="linkConstructor">Point</a></li>
<li><a href="../symbols/Rect.html" class="linkConstructor">Rect</a></li>
<li><a href="../symbols/Size.html" class="linkConstructor">Size</a></li>
<li><a href="../symbols/Spot.html" class="linkConstructor">Spot</a></li>
</ul>
</div>
</div>
<div class="navbar navbar-default" role="navigation">
<div class="navbar-header">
<div class="navheader-container">
<div class="navheader-collapse" data-toggle="collapse" data-target="#ModelNavbar">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#ModelNavbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
<span class="navbar-brand">Model Classes</span>
</div>
</div>
<div id="ModelNavbar" class="navbar-collapse collapse sidebar-navbar-collapse">
<ul class="classList nav navbar-nav">
<li><a href="../symbols/Binding.html" class="linkConstructor">Binding</a></li>
<li><a href="../symbols/ChangedEvent.html" class="linkConstructor">ChangedEvent</a></li>
<li><a href="../symbols/GraphLinksModel.html" class="linkConstructor">GraphLinksModel</a></li>
<li><a href="../symbols/Model.html" class="linkConstructor">Model</a></li>
<li><a href="../symbols/Transaction.html" class="linkConstructor">Transaction</a></li>
<li><a href="../symbols/TreeModel.html" class="linkConstructor">TreeModel</a></li>
<li><a href="../symbols/UndoManager.html" class="linkConstructor">UndoManager</a></li>
</ul>
</div>
</div>
<div class="navbar navbar-default" role="navigation">
<div class="navbar-header">
<div class="navheader-container">
<div class="navheader-collapse" data-toggle="collapse" data-target="#LayoutNavbar">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#LayoutNavbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
<span class="navbar-brand">Layout Classes</span>
</div>
</div>
<div id="LayoutNavbar" class="navbar-collapse collapse sidebar-navbar-collapse">
<ul class="classList nav navbar-nav">
<li><a href="../symbols/CircularLayout.html" class="linkConstructor">CircularLayout</a></li>
<li><a href="../symbols/ForceDirectedLayout.html" class="linkConstructor">ForceDirectedLayout</a></li>
<li><a href="../symbols/GridLayout.html" class="linkConstructor">GridLayout</a></li>
<li><a href="../symbols/LayeredDigraphLayout.html" class="linkConstructor">LayeredDigraphLayout</a></li>
<li><a href="../symbols/Layout.html" class="linkConstructor">Layout</a></li>
<li><a href="../symbols/LayoutNetwork.html" class="linkConstructor">LayoutNetwork</a></li>
<li><a href="../symbols/TreeLayout.html" class="linkConstructor">TreeLayout</a></li>
</ul>
</div>
</div>
<div class="navbar navbar-default" role="navigation">
<div class="navbar-header">
<div class="navheader-container">
<div class="navheader-collapse" data-toggle="collapse" data-target="#ToolNavbar">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#ToolNavbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
<span class="navbar-brand">Tool Classes</span>
</div>
</div>
<div id="ToolNavbar" class="navbar-collapse collapse sidebar-navbar-collapse">
<ul class="classList nav navbar-nav">
<li><a href="../symbols/ActionTool.html" class="linkConstructor">ActionTool</a></li>
<li><a href="../symbols/ClickCreatingTool.html" class="linkConstructor">ClickCreatingTool</a></li>
<li><a href="../symbols/ClickSelectingTool.html" class="linkConstructor">ClickSelectingTool</a></li>
<li><a href="../symbols/ContextMenuTool.html" class="linkConstructor">ContextMenuTool</a></li>
<li><a href="../symbols/DraggingTool.html" class="linkConstructor">DraggingTool</a></li>
<li><a href="../symbols/DragSelectingTool.html" class="linkConstructor">DragSelectingTool</a></li>
<li><a href="../symbols/HTMLInfo.html" class="linkConstructor">HTMLInfo</a></li>
<li><a href="../symbols/LinkingBaseTool.html" class="linkConstructor">LinkingBaseTool</a></li>
<li><a href="../symbols/LinkingTool.html" class="linkConstructor">LinkingTool</a></li>
<li><a href="../symbols/LinkReshapingTool.html" class="linkConstructor">LinkReshapingTool</a></li>
<li><a href="../symbols/PanningTool.html" class="linkConstructor">PanningTool</a></li>
<li><a href="../symbols/RelinkingTool.html" class="linkConstructor">RelinkingTool</a></li>
<li><a href="../symbols/ResizingTool.html" class="linkConstructor">ResizingTool</a></li>
<li><a href="../symbols/RotatingTool.html" class="linkConstructor">RotatingTool</a></li>
<li><a href="../symbols/TextEditingTool.html" class="linkConstructor">TextEditingTool</a></li>
<li><a href="../symbols/Tool.html" class="linkConstructor">Tool</a></li>
<li><a href="../symbols/ToolManager.html" class="linkConstructor">ToolManager</a></li>
</ul>
</div>
</div>
<div class="navbar navbar-default" role="navigation">
<div class="navbar-header">
<div class="navheader-container">
<div class="navheader-collapse" data-toggle="collapse" data-target="#CollectionNavbar">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#CollectionNavbar">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
</div>
<span class="navbar-brand">Collection Classes</span>
</div>
</div>
<div id="CollectionNavbar" class="navbar-collapse collapse sidebar-navbar-collapse">
<ul class="classList nav navbar-nav">
<li><a href="../symbols/Iterable.html" class="linkConstructor">Iterable</a></li>
<li><a href="../symbols/Iterator.html" class="linkConstructor">Iterator</a></li>
<li><a href="../symbols/List.html" class="linkConstructor">List</a></li>
<li><a href="../symbols/Map.html" class="linkConstructor">Map</a></li>
<li><a href="../symbols/Set.html" class="linkConstructor">Set</a></li>
</ul>
</div>
</div>
</div> <!-- /class="sidebar-nav -->
<!-- end publish.classesIndex -->
</div>
<div id="contentBody" class="col-md-10">
<!-- ============================== header ================================= -->
<div id="header" class="fineprint mt30">
<b>GoJS</b>&reg; Diagramming Components<br/>version 1.8.5 for JavaScript/HTML<br/>by <a href="https://www.nwoods.com/">Northwoods Software&reg;</a>
</div>
<!-- ============================== class title ============================ -->
<h2 class="classTitle mt30">
Class List
</h2>
<!-- ============================== class summary ========================== -->
<span class="hideshowall">
<span class="nodetails"><button id="buttonShow">Show Details</button></span>
<span class="details"><button id="buttonHide">Show Summaries</button></span>
</span>
<p class="classsummary">
An ordered iterable collection.
It optionally enforces the type of elements that may be added to the List.
<p>
An example usage:
<pre>
var list = new go.List(go.Point); // make a list of Points
list.add(new go.Point(0, 0));
list.add(new go.Point(20, 10));
list.add(new go.Point(10, 20));
// now list.length === 3
// and list.elt(1) instanceof go.Point
</pre>
<p>
You can iterate over the items in a List:
<pre>
var it = aList.iterator;
while (it.next()) {
window.console.log("#" + it.key + " is " + it.value);
}
</pre>
Or:
<pre>
aList.each(function(val) {
window.console.log(val);
});
</pre>
The key will range from zero to <a href="../symbols/List.html#count" class="linkProperty">count</a>-1.
<p>
For convenience this <b>GoJS</b> List class has synonyms for the following methods and property:
<ul>
<li><b>get(idx)</b>: <a href="../symbols/List.html#elt" class="linkMethod">elt</a></li>
<li><b>set(idx,val)</b>: <a href="../symbols/List.html#setElt" class="linkMethod">setElt</a></li>
<li><b>has(val)</b>: <a href="../symbols/List.html#contains" class="linkMethod">contains</a></li>
<li><b>delete(val)</b>: <a href="../symbols/List.html#remove" class="linkMethod">remove</a></li>
<li><b>clear()</b>: <a href="../symbols/List.html#clear" class="linkMethod">clear</a></li>
<li><b>size</b>: <a href="../symbols/List.html#count" class="linkProperty">count</a></li>
</ul>
</p>
<!-- ============================== constructor summary ==================== -->
<h2 id="constructor" class="summaryCaption"> Constructor <span class="nodetails"> Summary</span><span class="details"> Details</span></h2>
<div class="table-responsive">
<table class="summaryTable table table-bordered table-condensed" summary="A summary of the constructor documented in the class List.">
<thead>
<tr>
<th scope="col" class="name">Name</th>
<th scope="col" class="description">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td class="name" >
<div class="name">
List(type)
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>There are three possible constructors:
List(),
List(string) where string is a primitive type ('number', 'string', 'boolean', or 'function'), or
List(func) where func is a class function/constructor, such as <a href="../symbols/GraphObject.html" class="linkConstructor">GraphObject</a>.<span class="nodetails" id="xconList"><a class="morelink" onclick="hst('conList')">More...</a></span> <span class="details" id="conList">
</span><div class="details" id="dconList"><p>
Typical usage would be something like:
<pre>
var list = new go.List(go.GraphObject); // keep a list of GraphObjects
</pre></div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{Function|string|null=}</span> <b>type</b>
</dt>
<dd>Optional class type (constructor) or a string
describing a primitive type.
'string', 'number', 'boolean', and 'function' are accepted primitive types.</dd>
</dl>
</div>
</td>
</tr>
</tbody>
</table>
</div><!-- class="table-responsive">-->
<!-- ============================== properties summary ===================== -->
<h2 class="summaryCaption">Properties<span class="nodetails"> Summary</span><span class="details"> Details</span></h2>
<div class="table-responsive">
<table class="summaryTable table table-bordered table-condensed" summary="A summary of the properties documented in the class List.">
<thead>
<tr>
<th scope="col" class="name">Name, Value Type</th>
<th scope="col" class="description">Description</th>
</tr>
</thead>
<tbody>
<tr id="count" >
<td class="name">
<div class="name">
count
</div>
<div class="attributes">
<span class="light">{number}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp <p> -->
<p>This read-only property is the length of the List.
</div>
</td>
</tr>
<tr id="iterator" >
<td class="name">
<div class="name">
iterator
</div>
<div class="attributes">
<span class="light">{Iterator.<T>}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp <p> -->
<p>Gets an object that you can use for iterating over the List.<span class="nodetails" id="xpropiterator"><a class="morelink" onclick="hst('propiterator')">More...</a></span> <span class="details" id="propiterator">
The key will be an integer from zero to the count-1.
The value will be the item at that index in the list.
Typical usage:
<pre>
var it = aList.iterator;
while (it.next()) {
. . . "index: " + it.key + " value: " + it.value . . .
}
</pre></span>
</div>
</td>
</tr>
<tr id="iteratorBackwards" >
<td class="name">
<div class="name">
iteratorBackwards
</div>
<div class="attributes">
<span class="light">{Iterator.<T>}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp <p> -->
<p>Gets an object that you can use for iterating over the List in backwards order.<span class="nodetails" id="xpropiteratorBackwards"><a class="morelink" onclick="hst('propiteratorBackwards')">More...</a></span> <span class="details" id="propiteratorBackwards">
The key will be an integer from count-1 to zero.
The value will be the item at that index in the list.
The list is not modified by traversing in reverse order.
Typical usage:
<pre>
var it = aList.iteratorBackwards;
while (it.next()) {
. . . 'key: ' + it.key + ' value: ' + it.value . . .
}
</pre></span>
</div>
</td>
</tr>
<tr id="length" >
<td class="name">
<div class="name">
length
</div>
<div class="attributes">
<span class="light">{number}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp <p> -->
<p>This read-only property is the length of the List, a synonym for the <a href="../symbols/List.html#count" class="linkProperty">count</a> property.
</div>
</td>
</tr>
</tbody>
</table>
</div><!-- class="table-responsive">-->
<!-- ============================== methods summary ======================== -->
<h2 class="summaryCaption">Method <span class="nodetails"> Summary</span><span class="details"> Details</span></h2>
<div class="table-responsive">
<table class="summaryTable table table-bordered table-condensed" summary="A summary of the methods documented in the class List.">
<thead>
<tr>
<th scope="col" class="name">Name, Return Type</th>
<th scope="col" class="description">Description</th>
</tr>
</thead>
<tbody>
<tr id="add">
<td class="name">
<div class="name">
add(val)
</div>
<div class="attributes">
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Adds a given value to the end of the List.<span class="nodetails" id="xmethadd"><a class="morelink" onclick="hst('methadd')">More...</a></span> <span class="details" id="methadd">
</span><div class="details" id="dmethadd"><p>
Be careful not to call this method while iterating over the collection.</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{*}</span> <b>val</b>
</dt>
<dd></dd>
</dl>
</div>
</td>
</tr>
<tr id="addAll">
<td class="name">
<div class="name">
addAll(coll)
</div>
<div class="attributes">
<span class="light">{List.<T>}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Adds all of the values of a collection to the end of this List.<span class="nodetails" id="xmethaddAll"><a class="morelink" onclick="hst('methaddAll')">More...</a></span> <span class="details" id="methaddAll">
</span><div class="details" id="dmethaddAll"><p>
Be careful not to call this method while iterating over the collection.</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{Iterable.<T>|Array.<*>}</span> <b>coll</b>
</dt>
<dd>the collection of items to add.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{List.<T>}</span> this List.</dt>
</dl>
</div>
</td>
</tr>
<tr id="all">
<td class="name">
<div class="name">
all(pred)
</div>
<div class="attributes">
<span class="light">{boolean}</span>
<span class="since" title="since">1.4</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>This is true if all invocations of the given predicate on items in the collection are true.<span class="nodetails" id="xmethall"><a class="morelink" onclick="hst('methall')">More...</a></span> <span class="details" id="methall">
</span><div class="details" id="dmethall"><p>
Call the given predicate on each item in the collection.
As soon as a call returns false, this returns false.
Otherwise this returns true.
For an empty collection this returns true.</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{function(T):boolean}</span> <b>pred</b>
</dt>
<dd>This function must not have any side-effects.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{boolean}</span> True if all predicate calls are true; false otherwise.</dt>
</dl>
</div>
</td>
</tr>
<tr id="any">
<td class="name">
<div class="name">
any(pred)
</div>
<div class="attributes">
<span class="light">{boolean}</span>
<span class="since" title="since">1.4</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>This is true if any invocation of the given predicate on items in the collection is true.<span class="nodetails" id="xmethany"><a class="morelink" onclick="hst('methany')">More...</a></span> <span class="details" id="methany">
</span><div class="details" id="dmethany"><p>
Call the given predicate on each item in the collection.
As soon as a call returns true, this returns true.
Otherwise this returns false.
For an empty collection this returns false.</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{function(T):boolean}</span> <b>pred</b>
</dt>
<dd>This function must not have any side-effects.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{boolean}</span> True if any predicate call is true; false otherwise.</dt>
</dl>
</div>
</td>
</tr>
<tr id="clear">
<td class="name">
<div class="name">
clear()
</div>
<div class="attributes">
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Clears the List.<span class="nodetails" id="xmethclear"><a class="morelink" onclick="hst('methclear')">More...</a></span> <span class="details" id="methclear">
This sets the <a href="../symbols/List.html#count" class="linkProperty">count</a> to zero.
</span><div class="details" id="dmethclear"><p>
Be careful not to call this method while iterating over the collection.</div>
</div>
</td>
</tr>
<tr id="contains">
<td class="name">
<div class="name">
contains(val)
</div>
<div class="attributes">
<span class="light">{boolean}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Returns whether the given value is in this List.<span class="nodetails" id="xmethcontains"><a class="morelink" onclick="hst('methcontains')">More...</a></span> <span class="details" id="methcontains"></span>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{T}</span> <b>val</b>
</dt>
<dd>The value to check.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{boolean}</span> Whether or not the value is contained within the List.</dt>
</dl>
</div>
</td>
</tr>
<tr id="copy">
<td class="name">
<div class="name">
copy()
</div>
<div class="attributes">
<span class="light">{List.<T>}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Makes a shallow copy of this List.<span class="nodetails" id="xmethcopy"><a class="morelink" onclick="hst('methcopy')">More...</a></span> <span class="details" id="methcopy">
The values are not copied,
so if they are objects they may continue to be shared with the original List.</span>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{List.<T>}</span> The new list.</dt>
</dl>
</div>
</td>
</tr>
<tr id="each">
<td class="name">
<div class="name">
each(func)
</div>
<div class="attributes">
<span class="light">{List.<T>}</span>
<span class="since" title="since">1.4</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Call the given function on each item in the collection.<span class="nodetails" id="xmetheach"><a class="morelink" onclick="hst('metheach')">More...</a></span> <span class="details" id="metheach"></span>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{function(T)}</span> <b>func</b>
</dt>
<dd>This function must not modify the collection.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{List.<T>}</span> this list itself</dt>
</dl>
</div>
</td>
</tr>
<tr id="elt">
<td class="name">
<div class="name">
elt(i)
</div>
<div class="attributes">
<span class="light">{T}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Returns the element at the given index.<span class="nodetails" id="xmethelt"><a class="morelink" onclick="hst('methelt')">More...</a></span> <span class="details" id="methelt"></span>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{number}</span> <b>i</b>
</dt>
<dd>int The index of the element to return.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{T}</span> the value at the given index.</dt>
</dl>
</div>
</td>
</tr>
<tr id="first">
<td class="name">
<div class="name">
first()
</div>
<div class="attributes">
<span class="light">{T|null}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Returns the first item in the list, or null if there is none.
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{T|null}</span> This returns null if there are no items in the list.</dt>
</dl>
</div>
</td>
</tr>
<tr id="get">
<td class="name">
<div class="name">
get(i)
</div>
<div class="attributes">
<span class="light">{T}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Returns the element at the given index.<span class="nodetails" id="xmethget"><a class="morelink" onclick="hst('methget')">More...</a></span> <span class="details" id="methget"></span>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{number}</span> <b>i</b>
</dt>
<dd>int The index of the element to return.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{T}</span> the value at the given index.</dt>
</dl>
</div>
</td>
</tr>
<tr id="has">
<td class="name">
<div class="name">
has(val)
</div>
<div class="attributes">
<span class="light">{boolean}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Returns whether the given value is in this List.<span class="nodetails" id="xmethhas"><a class="morelink" onclick="hst('methhas')">More...</a></span> <span class="details" id="methhas"></span>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{T}</span> <b>val</b>
</dt>
<dd>The value to check.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{boolean}</span> Whether or not the value is contained within the List.</dt>
</dl>
</div>
</td>
</tr>
<tr id="indexOf">
<td class="name">
<div class="name">
indexOf(val)
</div>
<div class="attributes">
<span class="light">{number}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Returns the index of the given value if it is in this List.<span class="nodetails" id="xmethindexOf"><a class="morelink" onclick="hst('methindexOf')">More...</a></span> <span class="details" id="methindexOf"></span>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{T}</span> <b>val</b>
</dt>
<dd>The value to check.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{number}</span> int returns -1 if the value is not in this list.</dt>
</dl>
</div>
</td>
</tr>
<tr id="insertAt">
<td class="name">
<div class="name">
insertAt(i, val)
</div>
<div class="attributes">
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Insert a value before the index i.<span class="nodetails" id="xmethinsertAt"><a class="morelink" onclick="hst('methinsertAt')">More...</a></span> <span class="details" id="methinsertAt">
</span><div class="details" id="dmethinsertAt"><p>
Be careful not to call this method while iterating over the collection.</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{number}</span> <b>i</b>
</dt>
<dd>int The index to insert before.</dd>
<dt>
<span class="light fixedFont">{T}</span> <b>val</b>
</dt>
<dd>The value to insert.</dd>
</dl>
</div>
</td>
</tr>
<tr id="last">
<td class="name">
<div class="name">
last()
</div>
<div class="attributes">
<span class="light">{T|null}</span>
<span class="since" title="since">1.5</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Returns the last item in the list, or null if these is none.
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{T|null}</span> This returns null if there are no items in the list.</dt>
</dl>
</div>
</td>
</tr>
<tr id="pop">
<td class="name">
<div class="name">
pop()
</div>
<div class="attributes">
<span class="light">{T|null}</span>
<span class="since" title="since">1.5</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Returns the last item in the list and removes it from the list, or just return null if these is none.<span class="nodetails" id="xmethpop"><a class="morelink" onclick="hst('methpop')">More...</a></span> <span class="details" id="methpop">
Use <a href="../symbols/List.html#add" class="linkMethod">add</a> to push an item onto the end of the list.
Use <a href="../symbols/List.html#last" class="linkMethod">last</a> to get the last item without reducing the length of the list.</span>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{T|null}</span> This returns null if there are no items in the list.</dt>
</dl>
</div>
</td>
</tr>
<tr id="push">
<td class="name">
<div class="name">
push(val)
</div>
<div class="attributes">
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Adds a given value to the end of the List.<span class="nodetails" id="xmethpush"><a class="morelink" onclick="hst('methpush')">More...</a></span> <span class="details" id="methpush">
</span><div class="details" id="dmethpush"><p>
Be careful not to call this method while iterating over the collection.</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{*}</span> <b>val</b>
</dt>
<dd></dd>
</dl>
</div>
</td>
</tr>
<tr id="remove">
<td class="name">
<div class="name">
remove(val)
</div>
<div class="attributes">
<span class="light">{boolean}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Removes a given value (if found) from the List.<span class="nodetails" id="xmethremove"><a class="morelink" onclick="hst('methremove')">More...</a></span> <span class="details" id="methremove">
</span><div class="details" id="dmethremove"><p>
Be careful not to call this method while iterating over the collection.</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{T}</span> <b>val</b>
</dt>
<dd>The value to remove.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{boolean}</span> true if the value was found and removed, false otherwise.</dt>
</dl>
</div>
</td>
</tr>
<tr id="removeAt">
<td class="name">
<div class="name">
removeAt(i)
</div>
<div class="attributes">
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Removes a value at a given index from the List.<span class="nodetails" id="xmethremoveAt"><a class="morelink" onclick="hst('methremoveAt')">More...</a></span> <span class="details" id="methremoveAt">
</span><div class="details" id="dmethremoveAt"><p>
Be careful not to call this method while iterating over the collection.</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{number}</span> <b>i</b>
</dt>
<dd>int The index to remove.</dd>
</dl>
</div>
</td>
</tr>
<tr id="removeRange">
<td class="name">
<div class="name">
removeRange(from, to)
</div>
<div class="attributes">
<span class="light">{List.<T>}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Removes a range of values from the List, given both the starting and the ending zero-based indexes.<span class="nodetails" id="xmethremoveRange"><a class="morelink" onclick="hst('methremoveRange')">More...</a></span> <span class="details" id="methremoveRange">
For example, <pre>list.removeRange(2, 4)</pre> will remove elements 2, 3, and 4 from the list.
If there were two or fewer elements in the list to begin with, the list is unchanged.
If <i>from</i> is greater than <i>to</i>, the list is unchanged.
If <i>from</i> is greater than or equal to the length, the list is unchanged.
If <i>to</i> is less than zero, the list is unchanged.
</span><div class="details" id="dmethremoveRange"><p>
Be careful not to call this method while iterating over the collection.</div>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{number}</span> <b>from</b>
</dt>
<dd>int The starting index of the range to remove, inclusive; negative values are treated as zero</dd>
<dt>
<span class="light fixedFont">{number}</span> <b>to</b>
</dt>
<dd>int The ending index of the range to remove, inclusive; values greater than the length of the list are treated as referring to the last element</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{List.<T>}</span> this modified List</dt>
</dl>
</div>
</td>
</tr>
<tr id="reverse">
<td class="name">
<div class="name">
reverse()
</div>
<div class="attributes">
<span class="light">{List.<T>}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Reverse the order of items in this List.
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{List.<T>}</span> this modified List.</dt>
</dl>
</div>
</td>
</tr>
<tr id="set">
<td class="name">
<div class="name">
set(i, val)
</div>
<div class="attributes">
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Set the element at the given index to a given value.<span class="nodetails" id="xmethset"><a class="morelink" onclick="hst('methset')">More...</a></span> <span class="details" id="methset"></span>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{number}</span> <b>i</b>
</dt>
<dd>int The index of the element to set.</dd>
<dt>
<span class="light fixedFont">{T}</span> <b>val</b>
</dt>
<dd>The value to set at the index.</dd>
</dl>
</div>
</td>
</tr>
<tr id="setElt">
<td class="name">
<div class="name">
setElt(i, val)
</div>
<div class="attributes">
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Set the element at the given index to a given value.<span class="nodetails" id="xmethsetElt"><a class="morelink" onclick="hst('methsetElt')">More...</a></span> <span class="details" id="methsetElt"></span>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{number}</span> <b>i</b>
</dt>
<dd>int The index of the element to set.</dd>
<dt>
<span class="light fixedFont">{T}</span> <b>val</b>
</dt>
<dd>The value to set at the index.</dd>
</dl>
</div>
</td>
</tr>
<tr id="sort">
<td class="name">
<div class="name">
sort(sortfunc)
</div>
<div class="attributes">
<span class="light">{List.<T>}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Sort the List according to a comparison function.<span class="nodetails" id="xmethsort"><a class="morelink" onclick="hst('methsort')">More...</a></span> <span class="details" id="methsort"></span>
<dl class="detailList">
<dt class="heading">Parameters:</dt>
<dt>
<span class="light fixedFont">{function(*,*):number}</span> <b>sortfunc</b>
</dt>
<dd>This function is passed two items in the list.
It should return zero if they are equal,
less than zero if the first value should come before the second value,
or greater than zero if the first value should come after the second value.</dd>
</dl>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{List.<T>}</span> this modified List.</dt>
</dl>
</div>
</td>
</tr>
<tr id="toArray">
<td class="name">
<div class="name">
toArray()
</div>
<div class="attributes">
<span class="light">{Array.<T>}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Produces a JavaScript Array from the contents of this List.
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{Array.<T>}</span> A copy of the List in Array form.</dt>
</dl>
</div>
</td>
</tr>
<tr id="toSet">
<td class="name">
<div class="name">
toSet()
</div>
<div class="attributes">
<span class="light">{Set.<T>}</span>
</div>
</td>
<td class="description">
<div class="description">
<!--newp--><p><p>Converts the List to a <a href="../symbols/Set.html" class="linkConstructor">Set</a>.<span class="nodetails" id="xmethtoSet"><a class="morelink" onclick="hst('methtoSet')">More...</a></span> <span class="details" id="methtoSet">
The count of the resulting Set may be less than the count of this List
if any duplicates were removed.</span>
<dl class="detailList">
<dt class="heading">Returns:</dt>
<dt><span class="light fixedFont">{Set.<T>}</span> A copy of the contents of this List,
but with duplicates removed and ordering lost.</dt>
</dl>
</div>
</td>
</tr>
</tbody>
</table>
</div><!-- class="table-responsive">-->
<!-- ============================== events summary ======================== -->
<!-- ============================== fields summary ===================== -->
<!-- ============================== constructor details ==================== -->
</div> <!-- end contentBody -->
</div> <!-- end container-fluid -->
<!-- ============================== footer ================================= -->
<div id="footer" class="fineprint" style="clear:both">
Copyright &copy; 1998-2017 by <a href="https://www.nwoods.com/">Northwoods Software Corporation.</a>
</div>
</body>
</html>