/usr/include/yacas/lispcleanupstack.h is in yacas 1.3.6-2+b1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 | /** \file lispcleanupstack.h
* Implementation of a cleanup stack for exception handling on platforms
* that don't clean up the stack automatically after an exception
* occurs. The macro's SAFEPUSH and SAFEPOP as defined in
* plat/<plat>/lisptype.h define which cleanup handler
* to use, so it can be configured differently for different platforms.
*
*/
#ifndef YACAS_LISPCLEANUPSTACK_H
#define YACAS_LISPCLEANUPSTACK_H
#include "yacasbase.h"
#include <vector>
/** Base class that specifies one pure abstract method Delete.
* Only classes derived from this one can be pushed onto
* a cleanup stack. This in order to assure the cleanup code
* knows where to find the destructor.
*
* Typical candidates for cleanup include places in the code that
* have temporal global side effects that need to be finalized on,
* Like opening a file for reading, reading and then closing. If
* reading prematurely finishes through an exception, the file
* should be closed.
*/
class LispBase : public YacasBase
{
public:
virtual void Delete() = 0;
virtual ~LispBase() = default;
};
/** Clean up stack that doesn't actually delete objects itself.
* Use this clean up stack if the compiler generates
* cleanup code itself (particularly for newer c++ compilers).
* Alternatively SAFEPUSH and SAFEPOP can then be defined to do nothing.
*/
class LispCleanup : public YacasBase
{
public:
inline LispCleanup() : iObjects() {}
virtual ~LispCleanup() = default;
/// Push an object onto the cleanup stack for guarding
virtual void Push(LispBase& aObject);
/// Pop an object from the cleanup stack (the system is finished using it)
virtual void Pop();
/// Exception occurred: delete all objects on the stack, back to front.
virtual void Delete();
/** For testing purposes, verify that all places that pushed an object
* popped it too.
*/
void CheckStackEmpty();
protected:
std::vector<LispBase*> iObjects;
};
/** Clean up stack that deletes objects itself when needed.
* Use this clean up stack if the compiler doesn't generate
* cleanup code itself (particularly for older c++ compilers).
*/
class DeletingLispCleanup : public LispCleanup
{
public:
virtual ~DeletingLispCleanup() = default;
virtual void Push(LispBase& aObject);
virtual void Pop();
virtual void Delete();
};
#endif
|