From 93987da1f5e4733e0eb0ba944f06809b4e4d52cb Mon Sep 17 00:00:00 2001
From: Matthew Barnes <mbarnes@redhat.com>
Date: Thu, 27 Jun 2013 18:30:21 -0400
Subject: Add e_table_header_get_column_by_spec().

Will eventually replace e_table_header_get_column_by_col_idx().
---
 .../evolution-util/evolution-util-sections.txt     |  1 +
 e-util/e-table-header.c                            | 32 ++++++++++++++++++++++
 e-util/e-table-header.h                            |  3 ++
 3 files changed, 36 insertions(+)

diff --git a/doc/reference/evolution-util/evolution-util-sections.txt b/doc/reference/evolution-util/evolution-util-sections.txt
index 6555f5b1dd..6ef68b07b0 100644
--- a/doc/reference/evolution-util/evolution-util-sections.txt
+++ b/doc/reference/evolution-util/evolution-util-sections.txt
@@ -3586,6 +3586,7 @@ ETableHeader
 e_table_header_new
 e_table_header_add_column
 e_table_header_get_column
+e_table_header_get_column_by_spec
 e_table_header_get_column_by_col_idx
 e_table_header_count
 e_table_header_index
diff --git a/e-util/e-table-header.c b/e-util/e-table-header.c
index 546c8d1d3b..0b8d527883 100644
--- a/e-util/e-table-header.c
+++ b/e-util/e-table-header.c
@@ -467,6 +467,38 @@ e_table_header_get_column (ETableHeader *eth,
 	return eth->columns[column];
 }
 
+/**
+ * e_table_header_get_column_by_spec:
+ * @eth: the ETableHeader to query
+ * @spec: an #ETableColumnSpecification
+ *
+ * Returns the #ETableCol having @spec as the column specification, or
+ * %NULL if there is no matching #ETableCol.
+ *
+ * Returns: an #ETableCol, or %NULL
+ **/
+ETableCol *
+e_table_header_get_column_by_spec (ETableHeader *eth,
+                                   ETableColumnSpecification *spec)
+{
+	gint ii;
+
+	g_return_val_if_fail (E_IS_TABLE_HEADER (eth), NULL);
+	g_return_val_if_fail (E_IS_TABLE_COLUMN_SPECIFICATION (spec), NULL);
+
+	for (ii = 0; ii < eth->col_count; ii++) {
+		gboolean column_specs_equal;
+
+		column_specs_equal = e_table_column_specification_equal (
+			spec, eth->columns[ii]->spec);
+
+		if (column_specs_equal)
+			return eth->columns[ii];
+	}
+
+	return NULL;
+}
+
 /**
  * e_table_header_get_column_by_col_id:
  * @eth: the ETableHeader to query
diff --git a/e-util/e-table-header.h b/e-util/e-table-header.h
index 298131eeed..e5762c6eed 100644
--- a/e-util/e-table-header.h
+++ b/e-util/e-table-header.h
@@ -99,6 +99,9 @@ void		e_table_header_add_column	(ETableHeader *eth,
 						 gint pos);
 ETableCol *	e_table_header_get_column	(ETableHeader *eth,
 						 gint column);
+ETableCol *	e_table_header_get_column_by_spec
+						(ETableHeader *eth,
+						 ETableColumnSpecification *spec);
 ETableCol *	e_table_header_get_column_by_col_idx
 						(ETableHeader *eth,
 						 gint col_idx);
-- 
cgit v1.2.3