Mirrors/lodash
1
0
Fork 0
mirror of https://github.com/whoisclebs/lodash.git synced 2026-02-13 04:17:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

getting ready for 0.1

Browse Source
This commit is contained in:
Jeremy Ashkenas
2009-10-27 13:26:36 -04:00
parent 5e3f783a23
commit ef10906b5f
6 changed files with 115 additions and 55 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
LICENSE Normal file
View File

@@ -0,0 +1,22 @@
Copyright (c) 2009 Jeremy Ashkenas, DocumentCloud
Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

10
README Normal file
View File

@@ -0,0 +1,10 @@
__
/\_\ ____
\/\ \ /',__\
__ \ \ \/\__, `\
/\_\_\ \ \/\____/
_______\/_/\ \_\ \/___/
/\______\ \ \____/
\/______/ \/___/
See: documentcloud.github.com/underscore

102
index.html
View File

@@ -12,8 +12,7 @@
} }
div.container { div.container {
width: 720px; width: 720px;
margin: 0 auto; margin: 50px 0 50px 50px;
margin-top: 50px;
} }
p { p {
width: 550px; width: 550px;
@@ -32,7 +31,10 @@
background: #f0c095; background: #f0c095;
} }
h1, h2, h3, h4, h5, h6 { h1, h2, h3, h4, h5, h6 {
margin-top: 35px; margin-top: 40px;
}
b.method_name {
font-size: 18px;
} }
code, pre, tt { code, pre, tt {
font-family: Monaco, Consolas, "Lucida Console", monospace; font-family: Monaco, Consolas, "Lucida Console", monospace;
@@ -47,7 +49,7 @@
font-size: 12px; font-size: 12px;
padding: 2px 0 2px 12px; padding: 2px 0 2px 12px;
border-left: 6px solid #aaaa99; border-left: 6px solid #aaaa99;
margin: 0px 0 35px; margin: 0px 0 30px;
} }
</style> </style>
</head> </head>
@@ -131,7 +133,7 @@
<h2>Collection Functions (Arrays or Objects)</h2> <h2>Collection Functions (Arrays or Objects)</h2>
<p id="each"> <p id="each">
<b>each</b><code>_.each(list, iterator, [context])</code> <b class="method_name">each</b><code>_.each(list, iterator, [context])</code>
<br /> <br />
Iterates over a <b>list</b> of elements, yielding each in turn to an <b>iterator</b> Iterates over a <b>list</b> of elements, yielding each in turn to an <b>iterator</b>
function. The <b>iterator</b> is bound to the <b>context</b> object, if one is function. The <b>iterator</b> is bound to the <b>context</b> object, if one is
@@ -145,7 +147,7 @@ _.each([1, 2, 3], function(num){ alert(num); });
=&gt; alerts each number in turn...</pre> =&gt; alerts each number in turn...</pre>
<p id="map"> <p id="map">
<b>map</b><code>_.map(list, iterator, [context])</code> <b class="method_name">map</b><code>_.map(list, iterator, [context])</code>
<br /> <br />
Produces a new array of values by mapping each value in <b>list</b> Produces a new array of values by mapping each value in <b>list</b>
through a transformation function (<b>iterator</b>). If the native through a transformation function (<b>iterator</b>). If the native
@@ -156,7 +158,7 @@ _.map([1, 2, 3], function(num){ return num * 3 });
=&gt; [3, 6, 9]</pre> =&gt; [3, 6, 9]</pre>
<p id="inject"> <p id="inject">
<b>inject</b><code>_.inject(list, memo, iterator, [context])</code> <b class="method_name">inject</b><code>_.inject(list, memo, iterator, [context])</code>
<br /> <br />
Also known as <b>reduce</b> and <b>foldl</b>, <b>inject</b> reduces a Also known as <b>reduce</b> and <b>foldl</b>, <b>inject</b> reduces a
<b>list</b> of values into a single value. <b>Memo</b> is the initial state <b>list</b> of values into a single value. <b>Memo</b> is the initial state
@@ -169,7 +171,7 @@ var sum = _.inject([1, 2, 3], 0, function(memo, num){ return memo + num });
</pre> </pre>
<p id="detect"> <p id="detect">
<b>detect</b><code>_.detect(list, iterator, [context])</code> <b class="method_name">detect</b><code>_.detect(list, iterator, [context])</code>
<br /> <br />
Looks through each value in the <b>list</b>, returning the first one that Looks through each value in the <b>list</b>, returning the first one that
passes a truth test (<b>iterator</b>). The function returns as passes a truth test (<b>iterator</b>). The function returns as
@@ -182,7 +184,7 @@ var even = _.detect([1, 2, 3, 4, 5, 6], function(num){ return num % 2 == 0; });
</pre> </pre>
<p id="select"> <p id="select">
<b>select</b><code>_.select(list, iterator, [context])</code> <b class="method_name">select</b><code>_.select(list, iterator, [context])</code>
<br /> <br />
Looks through each value in the <b>list</b>, returning an array of all Looks through each value in the <b>list</b>, returning an array of all
the values that pass a truth test (<b>iterator</b>). Delegates to the the values that pass a truth test (<b>iterator</b>). Delegates to the
@@ -194,7 +196,7 @@ var evens = _.select([1, 2, 3, 4, 5, 6], function(num){ return num % 2 == 0; });
</pre> </pre>
<p id="reject"> <p id="reject">
<b>reject</b><code>_.reject(list, iterator, [context])</code> <b class="method_name">reject</b><code>_.reject(list, iterator, [context])</code>
<br /> <br />
Returns the values in <b>list</b> without the elements that the truth Returns the values in <b>list</b> without the elements that the truth
test (<b>iterator</b>) passes. The opposite of <b>select</b>. test (<b>iterator</b>) passes. The opposite of <b>select</b>.
@@ -205,7 +207,7 @@ var odds = _.reject([1, 2, 3, 4, 5, 6], function(num){ return num % 2 == 0; });
</pre> </pre>
<p id="all"> <p id="all">
<b>all</b><code>_.all(list, [iterator], [context])</code> <b class="method_name">all</b><code>_.all(list, [iterator], [context])</code>
<br /> <br />
Returns <i>true</i> if all of the values in the <b>list</b> pass the <b>iterator</b> Returns <i>true</i> if all of the values in the <b>list</b> pass the <b>iterator</b>
truth test. If an <b>iterator</b> is not provided, the truthy value of truth test. If an <b>iterator</b> is not provided, the truthy value of
@@ -218,7 +220,7 @@ _.all([true, 1, null, 'yes']);
</pre> </pre>
<p id="any"> <p id="any">
<b>any</b><code>_.any(list, [iterator], [context])</code> <b class="method_name">any</b><code>_.any(list, [iterator], [context])</code>
<br /> <br />
Returns <i>true</i> if any of the values in the <b>list</b> pass the Returns <i>true</i> if any of the values in the <b>list</b> pass the
<b>iterator</b> truth test. Short-circuits and stops traversing the list <b>iterator</b> truth test. Short-circuits and stops traversing the list
@@ -231,7 +233,7 @@ _.any([null, 0, 'yes', false]);
</pre> </pre>
<p id="include"> <p id="include">
<b>include</b><code>_.include(list, value)</code> <b class="method_name">include</b><code>_.include(list, value)</code>
<br /> <br />
Returns <i>true</i> if the <b>value</b> is present in the <b>list</b>, using Returns <i>true</i> if the <b>value</b> is present in the <b>list</b>, using
<i>==</i> to test equality. Uses <b>indexOf</b> internally, if <b>list</b> <i>==</i> to test equality. Uses <b>indexOf</b> internally, if <b>list</b>
@@ -243,7 +245,7 @@ _.include([1, 2, 3], 3);
</pre> </pre>
<p id="invoke"> <p id="invoke">
<b>invoke</b><code>_.invoke(list, methodName, [*arguments])</code> <b class="method_name">invoke</b><code>_.invoke(list, methodName, [*arguments])</code>
<br /> <br />
Calls the method named by <b>methodName</b> on each value in the <b>list</b>. Calls the method named by <b>methodName</b> on each value in the <b>list</b>.
Any extra arguments passed to <b>invoke</b> will be forwarded on to the Any extra arguments passed to <b>invoke</b> will be forwarded on to the
@@ -255,7 +257,7 @@ _.invoke([[5, 1, 7], [3, 2, 1]], 'sort');
</pre> </pre>
<p id="pluck"> <p id="pluck">
<b>pluck</b><code>_.pluck(list, propertyName)</code> <b class="method_name">pluck</b><code>_.pluck(list, propertyName)</code>
<br /> <br />
An optimized version of what is perhaps the most common use-case for An optimized version of what is perhaps the most common use-case for
<b>map</b>: returning a list of property values. <b>map</b>: returning a list of property values.
@@ -267,7 +269,7 @@ _.pluck(stooges, 'name');
</pre> </pre>
<p id="max"> <p id="max">
<b>max</b><code>_.max(list, [iterator], [context])</code> <b class="method_name">max</b><code>_.max(list, [iterator], [context])</code>
<br /> <br />
Returns the maximum value in <b>list</b>. If <b>iterator</b> is passed, Returns the maximum value in <b>list</b>. If <b>iterator</b> is passed,
it will be used on each value to generate the criterion by which the it will be used on each value to generate the criterion by which the
@@ -280,7 +282,7 @@ _.max(stooges, function(stooge){ return stooge.age; });
</pre> </pre>
<p id="min"> <p id="min">
<b>min</b><code>_.min(list, [iterator], [context])</code> <b class="method_name">min</b><code>_.min(list, [iterator], [context])</code>
<br /> <br />
Returns the minimum value in <b>list</b>. If <b>iterator</b> is passed, Returns the minimum value in <b>list</b>. If <b>iterator</b> is passed,
it will be used on each value to generate the criterion by which the it will be used on each value to generate the criterion by which the
@@ -293,7 +295,7 @@ _.min(numbers);
</pre> </pre>
<p id="sortBy"> <p id="sortBy">
<b>sortBy</b><code>_.sortBy(list, iterator, [context])</code> <b class="method_name">sortBy</b><code>_.sortBy(list, iterator, [context])</code>
<br /> <br />
Returns a sorted <b>list</b>, ranked by the results of running each Returns a sorted <b>list</b>, ranked by the results of running each
value through <b>iterator</b>. value through <b>iterator</b>.
@@ -304,7 +306,7 @@ _.sortBy([1, 2, 3, 4, 5, 6], function(num){ return Math.sin(num); });
</pre> </pre>
<p id="sortedIndex"> <p id="sortedIndex">
<b>sortedIndex</b><code>_.sortedIndex(list, value, [iterator])</code> <b class="method_name">sortedIndex</b><code>_.sortedIndex(list, value, [iterator])</code>
<br /> <br />
Uses a binary search to determine the index at which the <b>value</b> Uses a binary search to determine the index at which the <b>value</b>
should be inserted into the <b>list</b> in order to maintain the <b>list</b>'s should be inserted into the <b>list</b> in order to maintain the <b>list</b>'s
@@ -317,7 +319,7 @@ _.sortedIndex([10, 20, 30, 40, 50], 35);
</pre> </pre>
<p id="toArray"> <p id="toArray">
<b>toArray</b><code>_.toArray(list)</code> <b class="method_name">toArray</b><code>_.toArray(list)</code>
<br /> <br />
Converts the <b>list</b> (anything that can be iterated over), into a Converts the <b>list</b> (anything that can be iterated over), into a
real Array. Useful for transmuting the <b>arguments</b> object. real Array. Useful for transmuting the <b>arguments</b> object.
@@ -328,7 +330,7 @@ _.sortedIndex([10, 20, 30, 40, 50], 35);
</pre> </pre>
<p id="size"> <p id="size">
<b>size</b><code>_.size(list)</code> <b class="method_name">size</b><code>_.size(list)</code>
<br /> <br />
Return the number of values in the <b>list</b>. Return the number of values in the <b>list</b>.
</p> </p>
@@ -340,7 +342,7 @@ _.size({one : 1, two : 2, three : 3});
<h2>Array Functions</h2> <h2>Array Functions</h2>
<p id="first"> <p id="first">
<b>first</b><code>_.first(array)</code> <b class="method_name">first</b><code>_.first(array)</code>
<br /> <br />
Convenience to return the first element of an <b>array</b> (identical to <tt>array[0]</tt>). Convenience to return the first element of an <b>array</b> (identical to <tt>array[0]</tt>).
</p> </p>
@@ -350,7 +352,7 @@ _.first([3, 2, 1]);
</pre> </pre>
<p id="last"> <p id="last">
<b>last</b><code>_.last(array)</code> <b class="method_name">last</b><code>_.last(array)</code>
<br /> <br />
Returns the last element of an <b>array</b>. Returns the last element of an <b>array</b>.
</p> </p>
@@ -360,7 +362,7 @@ _.last([3, 2, 1]);
</pre> </pre>
<p id="compact"> <p id="compact">
<b>compact</b><code>_.compact(array)</code> <b class="method_name">compact</b><code>_.compact(array)</code>
<br /> <br />
Returns a copy of the <b>array</b> with all falsy values removed. Returns a copy of the <b>array</b> with all falsy values removed.
In Javascript, <i>false</i>, <i>null</i>, <i>0</i>, <i>""</i>, In Javascript, <i>false</i>, <i>null</i>, <i>0</i>, <i>""</i>,
@@ -372,7 +374,7 @@ _.compact([0, 1, false, 2, '', 3]);
</pre> </pre>
<p id="flatten"> <p id="flatten">
<b>flatten</b><code>_.flatten(array)</code> <b class="method_name">flatten</b><code>_.flatten(array)</code>
<br /> <br />
Flattens a nested <b>array</b> (the nesting can be to any depth). Flattens a nested <b>array</b> (the nesting can be to any depth).
</p> </p>
@@ -382,7 +384,7 @@ _.flatten([1, [2], [3, [[[4]]]]]);
</pre> </pre>
<p id="without"> <p id="without">
<b>without</b><code>_.without(array, [*values])</code> <b class="method_name">without</b><code>_.without(array, [*values])</code>
<br /> <br />
Returns a copy of the <b>array</b> with all instances of the <b>values</b> Returns a copy of the <b>array</b> with all instances of the <b>values</b>
removed. <i>==</i> is used for the equality test. removed. <i>==</i> is used for the equality test.
@@ -393,7 +395,7 @@ _.without([1, 2, 1, 0, 3, 1, 4], 0, 1);
</pre> </pre>
<p id="uniq"> <p id="uniq">
<b>uniq</b><code>_.uniq(array, [isSorted])</code> <b class="method_name">uniq</b><code>_.uniq(array, [isSorted])</code>
<br /> <br />
Produces a duplicate-free version of the <b>array</b>, using <i>==</i> to test Produces a duplicate-free version of the <b>array</b>, using <i>==</i> to test
object equality. If you know in advance that the <b>array</b> is sorted, object equality. If you know in advance that the <b>array</b> is sorted,
@@ -405,7 +407,7 @@ _.uniq([1, 2, 1, 3, 1, 4]);
</pre> </pre>
<p id="intersect"> <p id="intersect">
<b>intersect</b><code>_.intersect(*arrays)</code> <b class="method_name">intersect</b><code>_.intersect(*arrays)</code>
<br /> <br />
Computes the list of values that are the intersection of all the <b>arrays</b>. Computes the list of values that are the intersection of all the <b>arrays</b>.
Each value in the result is present in each of the <b>arrays</b>. Each value in the result is present in each of the <b>arrays</b>.
@@ -416,7 +418,7 @@ _.intersect([1, 2, 3], [101, 2, 1, 10], [2, 1]);
</pre> </pre>
<p id="zip"> <p id="zip">
<b>zip</b><code>_.zip(*arrays)</code> <b class="method_name">zip</b><code>_.zip(*arrays)</code>
<br /> <br />
Merges together the values of each of the <b>arrays</b> with the Merges together the values of each of the <b>arrays</b> with the
values at the corresponding position. Useful when you have separate values at the corresponding position. Useful when you have separate
@@ -428,7 +430,7 @@ _.zip(['moe', 'larry', 'curly'], [30, 40, 50], [true, false, false]);
</pre> </pre>
<p id="indexOf"> <p id="indexOf">
<b>indexOf</b><code>_.indexOf(array, value)</code> <b class="method_name">indexOf</b><code>_.indexOf(array, value)</code>
<br /> <br />
Returns the index at which <b>value</b> can be found in the <b>array</b>, Returns the index at which <b>value</b> can be found in the <b>array</b>,
or <i>-1</i> if value is not present in the <b>array</b>. Uses the native or <i>-1</i> if value is not present in the <b>array</b>. Uses the native
@@ -442,7 +444,7 @@ _.indexOf([1, 2, 3], 2);
<h2>Function (uh, ahem) Functions</h2> <h2>Function (uh, ahem) Functions</h2>
<p id="bind"> <p id="bind">
<b>bind</b><code>_.bind(function, context, [*arguments])</code> <b class="method_name">bind</b><code>_.bind(function, context, [*arguments])</code>
<br /> <br />
Bind a <b>function</b> to a <b>context</b> object, meaning that whenever Bind a <b>function</b> to a <b>context</b> object, meaning that whenever
the function is called, the value of <i>this</i> will be the <b>context</b>. the function is called, the value of <i>this</i> will be the <b>context</b>.
@@ -457,7 +459,7 @@ func();
</pre> </pre>
<p id="bindAll"> <p id="bindAll">
<b>bindAll</b><code>_.bindAll(*methodNames, context)</code> <b class="method_name">bindAll</b><code>_.bindAll(*methodNames, context)</code>
<br /> <br />
Binds a number of methods on the <b>context</b> object, specified by Binds a number of methods on the <b>context</b> object, specified by
<b>methodNames</b>, to be run in the context of that object whenever they <b>methodNames</b>, to be run in the context of that object whenever they
@@ -477,7 +479,7 @@ jQuery('#underscore_button').bind('click', buttonView.onClick);
</pre> </pre>
<p id="delay"> <p id="delay">
<b>delay</b><code>_.delay(function, wait, [*arguments])</code> <b class="method_name">delay</b><code>_.delay(function, wait, [*arguments])</code>
<br /> <br />
Much like <b>setTimeout</b>, invokes <b>function</b> after <b>wait</b> Much like <b>setTimeout</b>, invokes <b>function</b> after <b>wait</b>
milliseconds. If you pass the optional <b>arguments</b>, they will be milliseconds. If you pass the optional <b>arguments</b>, they will be
@@ -490,7 +492,7 @@ _.delay(log, 1000, 'logged later');
</pre> </pre>
<p id="defer"> <p id="defer">
<b>defer</b><code>_.defer(function)</code> <b class="method_name">defer</b><code>_.defer(function)</code>
<br /> <br />
Defers invoking the <b>function</b> until the current call stack has cleared, Defers invoking the <b>function</b> until the current call stack has cleared,
similar to using <b>setTimeout</b> with a delay of 0. Useful for performing similar to using <b>setTimeout</b> with a delay of 0. Useful for performing
@@ -503,7 +505,7 @@ _.defer(function(){ alert('deferred'); });
</pre> </pre>
<p id="wrap"> <p id="wrap">
<b>wrap</b><code>_.wrap(function, wrapper)</code> <b class="method_name">wrap</b><code>_.wrap(function, wrapper)</code>
<br /> <br />
Wraps the first <b>function</b> inside of the <b>wrapper</b> function, Wraps the first <b>function</b> inside of the <b>wrapper</b> function,
passing it as the first argument. This allows the <b>wrapper</b> to passing it as the first argument. This allows the <b>wrapper</b> to
@@ -522,7 +524,7 @@ hello();
<h2>Object Functions</h2> <h2>Object Functions</h2>
<p id="keys"> <p id="keys">
<b>keys</b><code>_.keys(object)</code> <b class="method_name">keys</b><code>_.keys(object)</code>
<br /> <br />
Retrieve all the names of the <b>object</b>'s properties. Retrieve all the names of the <b>object</b>'s properties.
</p> </p>
@@ -532,7 +534,7 @@ _.keys({one : 1, two : 2, three : 3});
</pre> </pre>
<p id="values"> <p id="values">
<b>values</b><code>_.values(object)</code> <b class="method_name">values</b><code>_.values(object)</code>
<br /> <br />
Return all of the values of the <b>object</b>'s properties. Return all of the values of the <b>object</b>'s properties.
</p> </p>
@@ -542,7 +544,7 @@ _.values({one : 1, two : 2, three : 3});
</pre> </pre>
<p id="extend"> <p id="extend">
<b>extend</b><code>_.extend(destination, source)</code> <b class="method_name">extend</b><code>_.extend(destination, source)</code>
<br /> <br />
Copy all of the properties in the <b>source</b> object over to the Copy all of the properties in the <b>source</b> object over to the
<b>destination</b> object. <b>destination</b> object.
@@ -553,7 +555,7 @@ _.extend({name : 'moe'}, {age : 50});
</pre> </pre>
<p id="clone"> <p id="clone">
<b>clone</b><code>_.clone(object)</code> <b class="method_name">clone</b><code>_.clone(object)</code>
<br /> <br />
Create a shallow-copied clone of the <b>object</b>. Any nested objects Create a shallow-copied clone of the <b>object</b>. Any nested objects
or arrays will be copied by reference, not duplicated. or arrays will be copied by reference, not duplicated.
@@ -564,7 +566,7 @@ _.clone({name : 'moe'});
</pre> </pre>
<p id="isEqual"> <p id="isEqual">
<b>isEqual</b><code>_.isEqual(object, other)</code> <b class="method_name">isEqual</b><code>_.isEqual(object, other)</code>
<br /> <br />
Performs an optimized deep comparison between the two objects, to determine Performs an optimized deep comparison between the two objects, to determine
if they should be considered equal. if they should be considered equal.
@@ -579,7 +581,7 @@ _.isEqual(moe, clone);
</pre> </pre>
<p id="isElement"> <p id="isElement">
<b>isElement</b><code>_.isElement(object)</code> <b class="method_name">isElement</b><code>_.isElement(object)</code>
<br /> <br />
Returns <i>true</i> if <b>object</b> is a DOM element. Returns <i>true</i> if <b>object</b> is a DOM element.
</p> </p>
@@ -589,7 +591,7 @@ _.isElement(jQuery('body')[0]);
</pre> </pre>
<p id="isArray"> <p id="isArray">
<b>isArray</b><code>_.isArray(object)</code> <b class="method_name">isArray</b><code>_.isArray(object)</code>
<br /> <br />
Returns <i>true</i> if <b>object</b> is an Array. Returns <i>true</i> if <b>object</b> is an Array.
</p> </p>
@@ -601,7 +603,7 @@ _.isArray([1,2,3]);
</pre> </pre>
<p id="isFunction"> <p id="isFunction">
<b>isFunction</b><code>_.isFunction(object)</code> <b class="method_name">isFunction</b><code>_.isFunction(object)</code>
<br /> <br />
Returns <i>true</i> if <b>object</b> is a Function. Returns <i>true</i> if <b>object</b> is a Function.
</p> </p>
@@ -611,7 +613,7 @@ _.isFunction(alert);
</pre> </pre>
<p id="isUndefined"> <p id="isUndefined">
<b>isUndefined</b><code>_.isUndefined(variable)</code> <b class="method_name">isUndefined</b><code>_.isUndefined(variable)</code>
<br /> <br />
Returns <i>true</i> if <b>variable</b> is <i>undefined</i>. Returns <i>true</i> if <b>variable</b> is <i>undefined</i>.
</p> </p>
@@ -623,7 +625,7 @@ _.isUndefined(window.missingVariable);
<h2>Utility Functions</h2> <h2>Utility Functions</h2>
<p id="uniqueId"> <p id="uniqueId">
<b>uniqueId</b><code>_.uniqueId([prefix])</code> <b class="method_name">uniqueId</b><code>_.uniqueId([prefix])</code>
<br /> <br />
Generate a globally-unique id for client-side models or DOM elements Generate a globally-unique id for client-side models or DOM elements
that need one. If <b>prefix</b> is passed, the id will be appended to it. that need one. If <b>prefix</b> is passed, the id will be appended to it.
@@ -634,15 +636,17 @@ _.uniqueId('contact_');
</pre> </pre>
<p id="template"> <p id="template">
<b>template</b><code>_.template(templateString)</code> <b class="method_name">template</b><code>_.template(templateString, [context])</code>
<br /> <br />
Compiles Javascript templates into functions that can be evaluated Compiles Javascript templates into functions that can be evaluated
for rendering. Useful for rendering complicated bits of HTML from JSON for rendering. Useful for rendering complicated bits of HTML from JSON
data sources. Template functions can both interpolate variables, using<br /> data sources. Template functions can both interpolate variables, using<br />
<i>&lt;%= &hellip; %&gt;</i>, as well as execute arbitrary Javascript code, with <i>&lt;%= &hellip; %&gt;</i>, as well as execute arbitrary Javascript code, with
<i>&lt;% &hellip; %&gt;</i>. When you evaluate a template, pass in a <i>&lt;% &hellip; %&gt;</i>. When you evaluate a template function, pass in a
context object that has properties corresponding to the template's free <b>context</b> object that has properties corresponding to the template's free
variables. variables. If you're writing a one-off, you can pass the <b>context</b>
object as the second parameter to <b>template</b> in order to render
immediately instead of returning a template function.
</p> </p>
<pre> <pre>
var compiled = _.template("hello: &lt;%= name %&gt;"); var compiled = _.template("hello: &lt;%= name %&gt;");

16
test/speed.js
View File

@@ -27,8 +27,24 @@
return _.uniq(numbers, true); return _.uniq(numbers, true);
}); });
JSLitmus.test('_.sortBy()', function() {
return _.sortBy(numbers, function(num){ return -num; });
});
JSLitmus.test('_.isEqual()', function() { JSLitmus.test('_.isEqual()', function() {
return _.isEqual(numbers, randomized); return _.isEqual(numbers, randomized);
}); });
JSLitmus.test('_.keys()', function() {
return _.keys(objects);
});
JSLitmus.test('_.values()', function() {
return _.values(objects);
});
JSLitmus.test('_.intersect()', function() {
return _.intersect(numbers, randomized);
});
})(); })();

10
test/test.html
View File

@@ -20,8 +20,14 @@
<h2 id="qunit-userAgent"></h2> <h2 id="qunit-userAgent"></h2>
<ol id="qunit-tests"></ol> <ol id="qunit-tests"></ol>
<br /> <br />
<h1 class="qunit-header">JSLitmus Speed Suite</h1> <h1 class="qunit-header">Underscore Speed Suite</h1>
<h2 class="qunit-userAgent">Each iteration runs on an array of 1000 elements.</h2> <h2 class="qunit-userAgent">
A representative sample of the functions are benchmarked here, to provide
a sense of how fast they might run in different browsers.
Each iteration runs on an array of 1000 elements.<br /><br />
For example, the 'intersect' test measures the number of times you can
find the intersection of two thousand-element arrays in one second.
</h2>
<br /> <br />
</body> </body>
</html> </html>

10
underscore.js
View File

@@ -1,12 +1,14 @@
// Underscore.js // Underscore.js
// (c) 2009 Jeremy Ashkenas, DocumentCloud Inc. // (c) 2009 Jeremy Ashkenas, DocumentCloud Inc.
// Underscore is freely distributable under the terms of the MIT license. // Underscore is freely distributable under the terms of the MIT license.
// Portions of Underscore are inspired by or borrowed from Prototype.js,
// Oliver Steele's Functional, And John Resig's Micro-Templating.
// For all details and documentation: // For all details and documentation:
// http://fdjklsafjsdalk // http://documentcloud.github.com/underscore/
window._ = { window._ = {
VERSION : '0.1.0', VERSION : '0.1.0',
// The cornerstone, an each implementation. // The cornerstone, an each implementation.
// Handles objects implementing forEach, _each, arrays, and raw objects. // Handles objects implementing forEach, _each, arrays, and raw objects.
each : function(obj, iterator, context) { each : function(obj, iterator, context) {
@@ -243,9 +245,9 @@ window._ = {
// passed-in arrays. // passed-in arrays.
intersect : function(array) { intersect : function(array) {
var rest = _.toArray(arguments).slice(1); var rest = _.toArray(arguments).slice(1);
return _.select(_.uniq(array), function(item1) { return _.select(_.uniq(array), function(item) {
return _.all(rest, function(other) { return _.all(rest, function(other) {
return _.detect(other, function(item2){ return item1 === item2; }); return _.indexOf(other, item) >= 0;
}); });
}); });
}, },