office-gobmx/include/codemaker/exceptiontree.hxx
Noel Grandin e2080e70fe new compilerplugin returnbyref
Find places where we are returning a pointer to something, where we can
be returning a reference.
e.g.
   class A {
     struct X x;
     public X* getX() { return &x; }
   }
which can be:
     public X& getX() { return x; }

Change-Id: I796fd23fd36a18aedf6e36bc28f8fab4f518c6c7
2014-06-24 11:34:21 +02:00

120 lines
4 KiB
C++

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/
#ifndef INCLUDED_CODEMAKER_EXCEPTIONTREE_HXX
#define INCLUDED_CODEMAKER_EXCEPTIONTREE_HXX
#include <codemaker/global.hxx>
#include <rtl/ref.hxx>
#include <rtl/string.hxx>
#include <vector>
class TypeManager;
namespace codemaker {
/**
Represents a node of the hierarchy from the ExceptionTree class.
*/
struct ExceptionTreeNode {
typedef std::vector< ExceptionTreeNode * > Children;
// Internally used by ExceptionTree:
ExceptionTreeNode(rtl::OString const & theName):
name(theName), present(false) {}
// Internally used by ExceptionTree:
~ExceptionTreeNode() { clearChildren(); }
// Internally used by ExceptionTree:
void setPresent() { present = true; clearChildren(); }
// Internally used by ExceptionTree:
ExceptionTreeNode * add(rtl::OString const & theName);
rtl::OString name;
bool present;
Children children;
private:
ExceptionTreeNode(ExceptionTreeNode &); // not implemented
void operator =(ExceptionTreeNode); // not implemented
void clearChildren();
};
/**
Represents the hierarchy formed by a set of UNO exception types.
The hierarchy is rooted at com.sun.star.uno.Exception. For each exception E
from the given set S, the hierarchy from com.sun.star.uno.Exception to the
first supertype E' of E which is itself a member of S is represented (i.e.,
subtypes that are hidden by supertypes are pruned from the hierarchy). The
exception com.sun.star.uno.RuntimeException and its subtypes are pruned
completely from the hierarchy. Each node of the hierarchy is represented by
an instance of ExceptionTreeNode, where name gives the name of the UNO
exception type, present is true iff the given exception type is a member of
the set S, and children contains all the relevant direct subtypes of the
given exception type, in no particular order (for nodes other than the root
node it holds that children is non-empty iff present is false).
*/
class ExceptionTree {
public:
ExceptionTree(): m_root("com.sun.star.uno.Exception") {}
~ExceptionTree() {}
/**
Builds the exception hierarchy, by adding one exception type at a time.
This function can be called more than once for the same exception name.
@param name the name of a UNO exception type; it is an error if the given
name does not represent a UNO exception type
@param manager a type manager, used to resolve type names; it is an error
if different calls to this member function use different, incompatible
type managers
*/
void add(
rtl::OString const & name,
rtl::Reference< TypeManager > const & manager);
/**
Gives access to the resultant exception hierarchy.
@return a reference to the root of the exception hierarchy, as
formed by all previous calls to add; it is an error if any calls to add
follow the first call to getRoot
*/
ExceptionTreeNode const & getRoot() const { return m_root; }
private:
ExceptionTree(ExceptionTree &); // not implemented
void operator =(const ExceptionTree&); // not implemented
ExceptionTreeNode m_root;
};
}
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */