From a3b90fd0cc09d44cb47d20ff9a71b7b1cb4fb2be Mon Sep 17 00:00:00 2001
From: Allan Jardine <allan.jardine@sprymedia.co.uk>
Date: Tue, 23 Apr 2013 08:49:06 +0100
Subject: [PATCH] New: API methods rows().nodes(), rows().data() and
 columns().header()

- rows().nodes() - Get the TR nodes for the selected rows
- rows().data() - Get the data for the selected rows
- columns().header() - Get the header cells for the selected columns

- This also introduces the `iterator` method to the API instance, which
  can be used to loop over selected columns / rows, for the context
  (tables), returning a flat array / API instance.
---
 media/src/api/api._selectors.js | 14 +++++++-------
 media/src/api/api.columns.js    | 22 +++-------------------
 media/src/api/api.core.js       | 27 +++++++++++++++++++++++++++
 media/src/api/api.rows.js       | 15 +++++++++++++++
 4 files changed, 52 insertions(+), 26 deletions(-)

diff --git a/media/src/api/api._selectors.js b/media/src/api/api._selectors.js
index c08beafe..fbb4215a 100644
--- a/media/src/api/api._selectors.js
+++ b/media/src/api/api._selectors.js
@@ -19,20 +19,20 @@ var _intVal = function ( s ) {
 var _selector_run = function ( selector, select )
 {
 	var
-		out = [],
-		a, i, ien, res;
+		out = [], res,
+		a, i, ien, j, jen;
 	
 	if ( ! $.isArray( selector ) ) {
 		selector = [ selector ];
 	}
 
 	for ( i=0, ien=selector.length ; i<ien ; i++ ) {
-		a = sel.split ?
-			sel.split(',') :
-			[ sel ];
+		a = selector[i].split ?
+			selector[i].split(',') :
+			[ selector[i] ];
 
-		for ( i=0, ien=a.length ; i<ien ; i++ ) {
-			res = select( typeof a[i] === 'string' ? $.trim(a[i]) : a[i] );
+		for ( j=0, jen=a.length ; j<jen ; j++ ) {
+			res = select( typeof a[j] === 'string' ? $.trim(a[j]) : a[j] );
 
 			if ( res && res.length ) {
 				out.push.apply( out, res );
diff --git a/media/src/api/api.columns.js b/media/src/api/api.columns.js
index deeed99d..22102c41 100644
--- a/media/src/api/api.columns.js
+++ b/media/src/api/api.columns.js
@@ -18,25 +18,9 @@ _api.register( 'columns()', function ( selector ) {
 /**
  * 
  */
-_api.register( 'columns().cells()', function ( selector ) {
-	var that = this;
-
-	return this.tables( function ( settings, thatIdx ) {
-		var cols = that[thatIdx];
-		var a = [];
-
-		// cols is an array of columns for the table
-		for ( var i=0, ien=cols.length ; i<ien ; i++ ) {
-			var colIdx = cols[i];
-			var col = settings.aoColumns[ colIdx ];
-
-
-		}
-
-		return a;
-
-		// should the resulting API instance be flattened, otherwise it is an
-		// array item for each table. Thinking yes. How?
+_api.register( 'columns().header()', function ( selector, opts ) {
+	return this.iterator( function ( settings, el ) {
+		return settings.aoColumns[ el ].nTh;
 	} );
 } );
 
diff --git a/media/src/api/api.core.js b/media/src/api/api.core.js
index ec10c38e..27fa3db7 100644
--- a/media/src/api/api.core.js
+++ b/media/src/api/api.core.js
@@ -311,6 +311,33 @@ _Api.prototype = /** @lends DataTables.Api */{
 		return -1;
 	},
 
+	// Internal only at the moment - relax?
+	iterator: function ( fn ) {
+		var
+			a = [], ret,
+			i, ien, j, jen, k, ken,
+			context = this.context,
+			items;
+
+		for ( i=0, ien=context.length ; i<ien ; i++ ) {
+			for( j=0, jen=this.length ; j<jen ; j++ ) {
+				items = this[i];
+
+				for ( k=0, ken=items.length ; k<ken ; k++ ) {
+					ret = fn( context[i], items[k], i, j, k );
+
+					if ( ret !== undefined ) {
+						a.push( ret );
+					}
+				}
+			}
+		}
+
+		return a.length ?
+			new _Api( context, a ) :
+			this;
+	},
+
 
 	lastIndexOf: _arrayProto.lastIndexOf || function (obj, start)
 	{
diff --git a/media/src/api/api.rows.js b/media/src/api/api.rows.js
index f9260422..0016bff5 100644
--- a/media/src/api/api.rows.js
+++ b/media/src/api/api.rows.js
@@ -6,6 +6,8 @@ var _api = DataTable.Api;
 
 
 
+
+
 /**
  * 
  */
@@ -16,6 +18,19 @@ _api.register( 'rows()', function ( selector, opts ) {
 } );
 
 
+_api.register( 'rows().nodes()', function () {
+	return this.iterator( function ( settings, el ) {
+		return settings.aoData[ el ].nTr || undefined;
+	} );
+} );
+
+
+_api.register( 'rows().data()', function ( data ) {
+	return this.iterator( function ( settings, el ) {
+		return settings.aoData[ el ]._aData;
+	} );
+} );
+
 
 }());