Add complete_index_set().

git-svn-id: https://svn.dealii.org/trunk@29577 0785d39b-7218-0410-832d-ea1e28bc413d

diff --git a/deal.II/doc/news/changes.h b/deal.II/doc/news/changes.h
index 2366459758cad22fa9bcc7ff9a0efa69a0ec6b9c..366a4d36187928c4542bd91ff48cf9266ba4b0cb 100644 (file)
--- a/deal.II/doc/news/changes.h
+++ b/deal.II/doc/news/changes.h
@@ -121,6 +121,13 @@ this function.
 <h3>Specific improvements</h3>
 
 <ol>
+<li> New: The global function <code>complete_index_set()</code>
+creates and returns an index set of given size that contains
+every single index with this range.
+<br>
+(Wolfgang Bangerth, 2013/05/24)
+</li>
+
 <li> New: All vector classes now have a static member variable
 <code>supports_distributed_data</code> that indicates whether the
 vector class supports data that is distributed across multiple

diff --git a/deal.II/include/deal.II/base/index_set.h b/deal.II/include/deal.II/base/index_set.h
index c0cf5a1ddd3cc471d464501aa60cec30e0176bf2..3fed2dcc20c3790156d893ab1610efee9a0b2e44 100644 (file)
--- a/deal.II/include/deal.II/base/index_set.h
+++ b/deal.II/include/deal.II/base/index_set.h
@@ -571,6 +571,32 @@ private:
 };
 
 
+/**
+ * Create and return an index set of size $N$ that contains every
+ * single index within this range. In essence, this function
+ * returns an index set created by
+ * @code
+ *  IndexSet is (N);
+ *  is.add_range(0, N);
+ * @endcode
+ * This function exists so that one can create and initialize
+ * index sets that are complete in one step, or so one can write
+ * code like
+ * @code
+ *   if (my_index_set == complete_index_set(my_index_set.size())
+ *     ...
+ * @endcode
+ *
+ * @relates IndexSet
+ */
+inline
+IndexSet complete_index_set (const unsigned int N)
+{
+  IndexSet is (N);
+  is.add_range(0, N);
+  return is;
+}
+
 /* ------------------ inline functions ------------------ */
 
 inline