ENH: add foamListRegions utility

- list all regions from constant/regionProperties:
     * foamListRegions

- list specific region type from constant/regionProperties:
     * foamListRegions fluid
     * foamListRegions solid

applications/utilities/miscellaneous/foamListRegions/Make/files

@@ -0,0 +1,3 @@
+foamListRegions.C
+
+EXE = $(FOAM_APPBIN)/foamListRegions

applications/utilities/miscellaneous/foamListRegions/Make/options

@@ -0,0 +1,5 @@
+EXE_INC = \
+    -I$(LIB_SRC)/regionModels/regionModel/lnInclude
+
+EXE_LIBS = \
+    -lregionModels

applications/utilities/miscellaneous/foamListRegions/foamListRegions.C

@@ -0,0 +1,113 @@
+/*---------------------------------------------------------------------------*\
+  =========                 |
+  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
+   \\    /   O peration     |
+    \\  /    A nd           | Copyright (C) 2017 OpenCFD Ltd.
+     \\/     M anipulation  |
+-------------------------------------------------------------------------------
+License
+    This file is part of OpenFOAM.
+
+    OpenFOAM is free software: you can redistribute it and/or modify it
+    under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
+    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+    for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
+
+Application
+    foamListRegions
+
+Group
+    grpPostProcessingUtilities
+
+Description
+    List regions from constant/regionProperties.
+
+    To simplify parsing of the output, the normal banner information
+    is suppressed.
+
+Usage
+    \b foamListRegions [OPTION]
+
+\*---------------------------------------------------------------------------*/
+
+#include "argList.H"
+#include "Time.H"
+#include "regionProperties.H"
+
+using namespace Foam;
+
+// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * //
+
+int main(int argc, char *argv[])
+{
+    argList::addNote("List regions from constant/regionProperties");
+
+    argList::noBanner();
+    argList::noParallel();
+    argList::noJobInfo();
+    argList::noFunctionObjects();
+    // No profiling since there is no time loop
+
+    // Non-mandatory arguments
+    argList::addArgument("regionType ... regionType");
+
+    #include "setRootCaseNonMandatoryArgs.H"
+
+    // As per "createTime.H", but quieter.
+    Time runTime(Time::controlDictName, args);
+
+    regionProperties rp(runTime);
+
+    // We now handle checking args and general sanity etc.
+    wordList regionTypes;
+
+    if (args.size() > 1)
+    {
+        regionTypes.setSize(args.size()-1);
+
+        label nTypes = 0;
+        for (label argi = 1; argi < args.size(); ++argi)
+        {
+            regionTypes[nTypes] = args[argi];
+
+            if (rp.found(regionTypes[nTypes]))
+            {
+                ++nTypes;
+            }
+            else
+            {
+                std::cerr<< "No region-type: " << regionTypes[nTypes] << nl;
+            }
+        }
+
+        regionTypes.setSize(nTypes);
+    }
+    else
+    {
+        regionTypes = rp.sortedToc();
+    }
+
+
+    for (const word& regionType : regionTypes)
+    {
+        const wordList& regionNames = rp[regionType];
+
+        for (const word& regionName : regionNames)
+        {
+            Info<< regionName << nl;
+        }
+    }
+
+    return 0;
+}
+
+
+// ************************************************************************* //

tutorials/heatTransfer/chtMultiRegionFoam/multiRegionHeater/Allmesh

@@ -7,12 +7,12 @@ runApplication topoSet
 runApplication splitMeshRegions -cellZones -overwrite
 
 # Remove fluid fields from solid regions (important for post-processing)
-for i in heater leftSolid rightSolid
+for i in $(foamListRegions solid)
 do
    rm -f 0*/$i/{nut,alphat,epsilon,k,U,p_rgh}
 done
 
-for i in bottomWater topAir heater leftSolid rightSolid
+for i in $(foamListRegions)
 do
    runApplication -s $i changeDictionary -region $i
 done

tutorials/heatTransfer/chtMultiRegionFoam/snappyMultiRegionHeater/Allrun

@@ -11,15 +11,15 @@ runApplication snappyHexMesh -overwrite
 runApplication splitMeshRegions -cellZones -overwrite
 
 # remove fluid fields from solid regions (important for post-processing)
-for i in heater leftSolid rightSolid
+for i in $(foamListRegions solid)
 do
    rm -f 0*/$i/{nut,alphat,epsilon,k,U,p_rgh}
 done
 
 
-for i in bottomAir topAir heater leftSolid rightSolid
+for i in $(foamListRegions)
 do
-   runApplication -s $i  changeDictionary -region $i
+   runApplication -s $i changeDictionary -region $i
 done