/usr/include/sipxtapi/utl/UtlVoidPtr.h is in libsipxtapi-dev 3.3.0~test17-1.
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 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 | //
// Copyright (C) 2004-2006 SIPfoundry Inc.
// Licensed by SIPfoundry under the LGPL license.
//
// Copyright (C) 2004-2006 Pingtel Corp. All rights reserved.
// Licensed to SIPfoundry under a Contributor Agreement.
//
// $$
///////////////////////////////////////////////////////////////////////////////
#ifndef _UtlVoidPtr_h_
#define _UtlVoidPtr_h_
// SYSTEM INCLUDES
#include "os/OsDefs.h"
// APPLICATION INCLUDES
#include "utl/UtlDefs.h"
#include "utl/UtlContainable.h"
// DEFINES
// MACROS
// EXTERNAL FUNCTIONS
// EXTERNAL VARIABLES
// CONSTANTS
// STRUCTS
// TYPEDEFS
// FORWARD DECLARATIONS
/// UtlVoidPtr is a UtlContainable wrapper for a void ptr.
/**
* This class has serious potential to create memory leaks and type casting
* errors. Please consider just making the class you want to put into a
* container a UtlContainable - it just requires implementing a couple of
* methods, and can often be done by just inheriting from one of the existing
* UtlContainable classes. In the simplest case, you can use UtlContainableAtomic;
* it requires only that you define a new UtlContainableType constant and the
* method to read it.
*/
class UtlVoidPtr : public UtlContainable
{
/* //////////////////////////// PUBLIC //////////////////////////////////// */
public:
static const UtlContainableType TYPE ; /** < Class type used for runtime checking */
/* ============================ CREATORS ================================== */
/**
* Constructor accepting an optional default value.
*/
UtlVoidPtr(void * pPtr = NULL) ;
/**
* Destructor
*/
virtual ~UtlVoidPtr() ;
/* ============================ MANIPULATORS ============================== */
/**
* Set a new void ptr value for this object.
*
* @returns the old value
*/
void* setValue(void *) ;
/* ============================ ACCESSORS ================================= */
/**
* Get the void ptr wrapped by this object.
*/
void* getValue() const ;
/**
* Calculate a unique hash code for this object. If the equals
* operator returns true for another object, then both of those
* objects must return the same hashcode.
*/
virtual unsigned hash() const ;
/**
* Get the ContainableType for a UtlContainable derived class.
*/
virtual UtlContainableType getContainableType() const;
/* ============================ INQUIRY =================================== */
/**
* Compare the this object to another like-objects. Results for
* designating a non-like object are undefined.
*
* @returns 0 if equal, < 0 if less then and >0 if greater.
*/
virtual int compareTo(UtlContainable const *) const ;
/* //////////////////////////// PROTECTED ///////////////////////////////// */
protected:
/* //////////////////////////// PRIVATE /////////////////////////////////// */
private:
void* mpValue ; /** < The void ptr wrapped by this object */
} ;
/* ============================ INLINE METHODS ============================ */
#endif // _UtlVoidPtr_h_
|