OpenSTA/include/sta/NetworkCmp.hh

// OpenSTA, Static Timing Analyzer
// Copyright (c) 2026, Parallax Software, Inc.
// 
// This program 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.
// 
// This program 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 this program. If not, see <https://www.gnu.org/licenses/>.
// 
// The origin of this software must not be misrepresented; you must not
// claim that you wrote the original software.
// 
// Altered source versions must be plainly marked as such, and must not be
// misrepresented as being the original software.
// 
// This notice may not be removed or altered from any source distribution.

#pragma once

#include "LibertyClass.hh"
#include "NetworkClass.hh"

namespace sta {

// Comparison operators for network objects.

class PortNameLess
{
public:
  PortNameLess(const Network *network);
  bool operator()(const Port *port1,
                  const Port *port2) const;

private:
  const Network *network_;
};

class PinPathNameLess
{
public:
  PinPathNameLess(const Network *network);
  bool operator()(const Pin *pin1,
                  const Pin *pin2) const;

private:
  const Network *network_;
};

class InstancePathNameLess
{
public:
  InstancePathNameLess(const Network *network);
  bool operator()(const Instance *inst1,
                  const Instance *inst2) const;

private:
  const Network *network_;
};

class NetPathNameLess
{
public:
  NetPathNameLess(const Network *network);
  bool operator()(const Net *net1,
                  const Net *net2) const;

private:
  const Network *network_;
};

PinSeq
sortByPathName(const PinSet *set,
               const Network *network);
PinSeq
sortByPathName(const PinUnorderedSet *set,
               const Network *network);
PortSeq
sortByName(const PortSet *set,
           const Network *network);
InstanceSeq
sortByPathName(InstanceSet *set,
               const Network *network);
NetSeq
sortByPathName(NetSet *set,
               const Network *network);

} // namespace sta