openfoam/src/OpenFOAM/include/getAllRegionOptions.H

/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     |
    \\  /    A nd           | www.openfoam.com
     \\/     M anipulation  |
-------------------------------------------------------------------------------
    Copyright (C) 2021-2025 OpenCFD Ltd.
-------------------------------------------------------------------------------
License
    This file is part of OpenFOAM, distributed under GPL-3.0-or-later.

Description
    Gets single or multiple region names based on command-line options:
    (-all-regions | -regions | -regions)

Priority
    1. -all-regions (-allRegions)
    2. -regions = specify multiple regions to select, or a single region
    3. -region = specify a single region

Note
    There is no semantical difference between "-regions name"
    and "-region name".
    If regionProperties is missing (or empty) and the "-regions"
    option is supplied with literal names, these will be used directly
    instead of being used to filter the regionProperties.

Required Classes
    - Foam::polyMesh
    - Foam::regionProperties
    - Foam::IOobjectOption

Required Variables
    - args [argList]
    - runTime [Time]

Provides Variables
    - regionNames [wordList]

See Also
    addAllRegionOptions.H

\*---------------------------------------------------------------------------*/

wordList regionNames;
{
    // Exit or fallback if nothing matches
    constexpr bool exitOnNoMatches = true;

    // Local aliases
    auto& names = regionNames;
    const auto& fallback = Foam::polyMesh::defaultRegion;

    if
    (
        // Handle both here (independent of which is an alias)
        args.found("all-regions")
     || args.found("allRegions")
    )
    {
        names =
        (
            Foam::regionProperties
            (
                runTime,
                IOobjectOption::READ_IF_PRESENT
            ).names()
        );

        if (names.empty())
        {
            InfoErr
                << "Warning: No regionProperties, "
                   "assume default region" << nl << endl;
        }
        else
        {
            Info<< "Using all regions: "
                << flatOutput(names) << nl;
        }
    }
    else if
    (
        wordRes select;
        args.readListIfPresent<wordRe>("regions", select)
    )
    {
        select.uniq();  // Normally a no-op

        if (select.size() == 1 && select[0].isLiteral())
        {
            // Identical to -region NAME
            names.resize(1);
            names[0] = select[0];
        }
        else if (select.size())
        {
            names =
            (
                Foam::regionProperties
                (
                    runTime,
                    IOobjectOption::READ_IF_PRESENT
                ).names()
            );

            if (!names.empty())
            {
                // Filter the region names
                const auto indices = select.matching(names);

                if (indices.empty())
                {
                    InfoErr
                        << "No match in regions: "
                        << flatOutput(names) << nl;

                    if constexpr (exitOnNoMatches)
                    {
                        InfoErr<< "... stopping" << nl << endl;
                        return 1;
                    }
                    else
                    {
                        InfoErr
                            << "... ignoring and using default region"
                            << nl << endl;

                        names.resize(1);
                        names[0] = fallback;
                    }
                }
                else
                {
                    names = wordList(names, indices);
                    Info<< "Using regions: "
                        << flatOutput(names) << nl;
                }
            }
            else
            {
                // No information from regionProperties:
                // - use literal names from select

                names.resize(select.size());

                label nGood(0);
                for (const auto& val : select)
                {
                    if (val.isLiteral())
                    {
                        names[nGood++] = val;
                    }
                }
                if (nGood)
                {
                    names.resize(nGood);

                    InfoErr
                        << "Warning: No regionProperties, "
                           "using specified regions" << nl;

                    Info<< "Using regions: "
                        << flatOutput(names) << nl;
                }
                else
                {
                    names.resize(1);
                    names[0] = fallback;

                    InfoErr
                        << "Warning: No regionProperties, "
                           "assume default region" << nl << endl;
                }
            }
        }
    }
    else
    {
        // Single region option or fallback
        names.resize(1);
        auto& name = names[0];

        if
        (
            !args.readIfPresent("region", name)
        )
        {
            name = fallback;
        }
    }

    // Final sanity checks and/or fallback
    if (names.empty())
    {
        names.resize(1);
        names[0] = fallback;
    }
    else if (names.size() == 1 && names[0].empty())
    {
        names[0] = fallback;
    }
}


// ************************************************************************* //