version 1.11, 2001/12/24 03:11:31
|
version 1.89, 2007/06/06 05:24:49
|
|
|
//%///-*-c++-*-///////////////////////////////////////////////////////////////// |
//%2006//////////////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001 BMC Software, Hewlett-Packard Company, IBM, |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
// The Open Group, Tivoli Systems |
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
|
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; |
|
// IBM Corp.; EMC Corporation, The Open Group. |
|
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; |
|
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; Symantec Corporation; The Open Group. |
// | // |
// Permission is hereby granted, free of charge, to any person obtaining a copy | // Permission is hereby granted, free of charge, to any person obtaining a copy |
// of this software and associated documentation files (the "Software"), to | // of this software and associated documentation files (the "Software"), to |
|
|
// | // |
//============================================================================== | //============================================================================== |
// | // |
// Author: Mike Brasher (mbrasher@bmc.com) |
|
// |
|
// Modified By: Nitin Upasani, Hewlett-Packard Company (Nitin_Upasani@hp.com) |
|
// Modified By: Carol Ann Krug Graves, Hewlett-Packard Company |
|
// (carolann_graves@hp.com) |
|
// Modified By: Mike Day (mdday@us.ibm.com) |
|
// |
|
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
#ifndef Pegasus_Message_h | #ifndef Pegasus_Message_h |
|
|
#include <Pegasus/Common/Config.h> | #include <Pegasus/Common/Config.h> |
#include <iostream> | #include <iostream> |
#include <cstring> | #include <cstring> |
#include <Pegasus/Common/Exception.h> |
#include <Pegasus/Common/InternalException.h> |
#include <Pegasus/Common/IPC.h> |
#include <Pegasus/Common/Linkage.h> |
|
#include <Pegasus/Common/TimeValue.h> |
|
#include <Pegasus/Common/CIMOperationType.h> |
|
#include <Pegasus/Common/Threads.h> |
|
#include <Pegasus/Common/Linkable.h> |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
// REVIEW: could class be renamed to MessageMask (coding standard)? |
class PEGASUS_COMMON_LINKAGE MessageMask |
|
|
class PEGASUS_COMMON_LINKAGE message_mask |
|
{ | { |
public: | public: |
|
// Message handling is indicated by the high order 12 bits. For example: |
// REVIEW: could these be renamed (e.g., type_legacy to just LEGACY)? |
// Uint32 messageHandling = flags & 0xfff00000; |
// REVIEW: see coding standard. |
|
|
|
static Uint32 type_legacy; |
|
static Uint32 type_CIMOperation; |
|
static Uint32 type_CIMAsyncOperation; |
|
static Uint32 type_export; |
|
static Uint32 type_lifetime; |
|
static Uint32 type_socket; |
|
static Uint32 type_connection; |
|
static Uint32 type_http; |
|
static Uint32 type_cimom; |
|
static Uint32 type_control; |
|
static Uint32 type_service; |
|
static Uint32 type_broadcast; |
|
|
|
static Uint32 ha_no_delete; |
|
static Uint32 ha_request; | static Uint32 ha_request; |
static Uint32 ha_reply; | static Uint32 ha_reply; |
static Uint32 ha_synchronous; |
static Uint32 ha_async; |
|
}; |
// more for documentation than for use |
|
|
|
inline Uint32 get_type(Uint32 flags) |
|
{ |
|
return (flags & 0x000fffff); |
|
} |
|
| |
inline Uint32 get_handling(Uint32 flags) |
enum HttpMethod |
{ | { |
return( flags & 0xfff00000); |
HTTP_METHOD__POST, |
} |
HTTP_METHOD_M_POST |
}; | }; |
| |
class MessageQueue; |
|
|
|
/** The Message class and derived classes are used to pass messages between | /** The Message class and derived classes are used to pass messages between |
modules. Messages are passed between modules using the message queues | modules. Messages are passed between modules using the message queues |
(see MessageQueue class). Derived classes may add their own fields. | (see MessageQueue class). Derived classes may add their own fields. |
This base class defines two common fields: type, which is the type of |
This base class defines a common type field, which is the type of |
the message, and key which is a key value whose meaning is defined by |
the message. |
the derived class. The MessageQueue class provides methods for finding |
|
messages by both type and key. |
|
|
|
The Message class also provides previous and next pointers which are |
|
used to place the messages on a queue by the MessageQueue class. |
|
*/ | */ |
class PEGASUS_COMMON_LINKAGE Message |
class PEGASUS_COMMON_LINKAGE Message : public Linkable |
{ | { |
public: | public: |
| |
Message( | Message( |
Uint32 type, | Uint32 type, |
Uint32 key = getNextKey(), |
Uint32 destination = 0, |
Uint32 routing_code = 0, |
Uint32 mask = 0) |
Uint32 mask = message_mask::type_legacy) |
|
: | : |
_type(type), | _type(type), |
_key(key), |
|
_routing_code(routing_code), |
|
_mask(mask), | _mask(mask), |
_next(0), |
_httpMethod (HTTP_METHOD__POST), |
_prev(0) |
#ifndef PEGASUS_DISABLE_PERFINST |
|
_serverStartTimeMicroseconds(0), |
|
_providerTimeMicroseconds(0), |
|
_totalServerTimeMicroseconds(0), |
|
#endif |
|
_close_connect(false), |
|
_last_thread_id(Threads::self()), |
|
_async(0), |
|
dest(destination), |
|
_isComplete(true), |
|
_index(0) |
{ | { |
|
|
} | } |
| |
virtual ~Message(); | virtual ~Message(); |
| |
|
// NOTE: The compiler default implementation of the copy constructor |
|
// is used for this class. |
|
|
|
Boolean getCloseConnect() const { return _close_connect; } |
|
void setCloseConnect(Boolean close_connect) |
|
{ |
|
_close_connect = close_connect; |
|
} |
|
|
Uint32 getType() const { return _type; } | Uint32 getType() const { return _type; } |
| |
void setType(Uint32 type) { _type = type; } | void setType(Uint32 type) { _type = type; } |
| |
Uint32 getKey() const { return _key; } |
Uint32 getMask() const { return _mask; } |
| |
void setKey(Uint32 key) { _key = key; } |
void setMask(Uint32 mask) { _mask = mask; } |
| |
Uint32 getRouting() const { return _routing_code; } |
HttpMethod getHttpMethod() const { return _httpMethod; } |
void setRouting(Uint32 routing) { _routing_code = routing; } |
|
| |
Uint32 getMask() const { return _mask; } |
void setHttpMethod(HttpMethod httpMethod) {_httpMethod = httpMethod;} |
| |
void setMask(Uint32 mask) { _mask = mask; } |
#ifndef PEGASUS_DISABLE_PERFINST |
|
// |
|
// Needed for performance measurement |
|
// |
|
|
|
Uint64 getServerStartTime() const |
|
{ |
|
return _serverStartTimeMicroseconds; |
|
} |
|
|
|
void setServerStartTime(Uint64 serverStartTimeMicroseconds) |
|
{ |
|
_serverStartTimeMicroseconds = serverStartTimeMicroseconds; |
|
} |
| |
Message* getNext() { return _next; } |
void endServer(); |
| |
const Message* getNext() const { return _next; } |
Uint64 getProviderTime() const |
|
{ |
|
return _providerTimeMicroseconds; |
|
} |
| |
Message* getPrevious() { return _prev; } |
void setProviderTime(Uint64 providerTimeMicroseconds) |
|
{ |
|
_providerTimeMicroseconds = providerTimeMicroseconds; |
|
} |
| |
const Message* getPrevious() const { return _prev; } |
Uint64 getTotalServerTime() const |
|
{ |
|
return _totalServerTimeMicroseconds; |
|
} |
| |
static Uint32 getNextKey() |
void setTotalServerTime(Uint64 totalServerTimeMicroseconds) |
{ | { |
|
_totalServerTimeMicroseconds = totalServerTimeMicroseconds; |
|
} |
|
|
|
#endif |
| |
_mut.lock( pegasus_thread_self() ) ; |
static CIMOperationType convertMessageTypetoCIMOpType(Uint32 type); |
Uint32 ret = _nextKey++; |
|
_mut.unlock(); |
#ifdef PEGASUS_DEBUG |
|
virtual void print( |
|
PEGASUS_STD(ostream)& os, |
|
Boolean printHeader = true) const; |
|
#endif |
|
|
|
Message* get_async() |
|
{ |
|
Message *ret = _async; |
|
_async = 0; |
return ret; | return ret; |
} | } |
| |
virtual void print(PEGASUS_STD(ostream)& os) const; |
void put_async(Message* msg) |
|
{ |
|
_async = msg; |
|
} |
|
|
|
// << Tue Jul 1 11:02:49 2003 mdd >> pep_88 and helper for i18n and l10n |
|
Boolean thread_changed() |
|
{ |
|
if (!Threads::equal(_last_thread_id, Threads::self())) |
|
{ |
|
_last_thread_id = Threads::self(); |
|
return true; |
|
} |
|
|
|
return false; |
|
} |
|
|
|
// set the message index indicating what piece (or sequence) this is |
|
// message indexes start at zero |
|
void setIndex(Uint32 index) { _index = index; } |
|
|
|
// increment the message index |
|
void incrementIndex() { _index++; } |
|
|
|
// set the complete flag indicating if this message piece is the |
|
// last or not |
|
void setComplete(Boolean isComplete) |
|
{ |
|
_isComplete = isComplete ? true:false; |
|
} |
|
|
|
// get the message index (or sequence number) |
|
Uint32 getIndex() const { return _index; } |
|
|
|
// is this the first piece of the message ? |
|
Boolean isFirst() const { return _index == 0 ? true : false; } |
|
|
|
// is this message complete? (i.e the last in a one or more sequence) |
|
Boolean isComplete() const { return _isComplete; } |
| |
private: | private: |
Uint32 _type; | Uint32 _type; |
Uint32 _key; |
|
Uint32 _routing_code; |
|
Uint32 _mask; | Uint32 _mask; |
Message* _next; |
HttpMethod _httpMethod; |
Message* _prev; |
|
MessageQueue* _owner; |
|
static Uint32 _nextKey; |
|
static Mutex _mut; |
|
friend class MessageQueue; |
|
}; |
|
| |
|
#ifndef PEGASUS_DISABLE_PERFINST |
|
// Needed for performance measurement |
|
Uint64 _serverStartTimeMicroseconds; |
|
Uint64 _providerTimeMicroseconds; |
|
Uint64 _totalServerTimeMicroseconds; |
|
#endif |
|
Boolean _close_connect; |
| |
// each component needs to support a set of these messgaes and pass that array |
// << Tue Jul 1 11:02:35 2003 mdd >> pep_88 and helper for i18n and l10n |
// to the dispatcher so the dispatcher can route messages at the first level |
ThreadType _last_thread_id; |
// i.e., client will not accept request messages. |
|
// every message should have a response |
|
| |
// dispatcher supports full cim api set (as below) |
public: |
// repository needs to be a peer to the provider manager |
Message *_async; |
// |
Uint32 dest; |
|
|
|
private: |
|
Message& operator=(const Message& msg); |
|
|
|
Boolean _isComplete; |
|
Uint32 _index; |
|
}; |
| |
// mkdir _dispatcher |
|
// mkdir _providermanager |
|
// mkdir _server (http incoming, front end) |
|
// mkdir _repositorymanager |
|
// _subscriptionprocessor |
|
// _indicationprocessor |
|
// _configurationmanager |
|
// _cimom (loads and links everyone, hooks up queues) |
|
|
|
// fundamental messages: |
|
|
|
// start, stop, pause, resume |
|
// handshaking: interrogate (as in windows service api) |
|
// message class support |
|
// message namespace support ??? |
|
| |
enum MessageType | enum MessageType |
{ | { |
|
|
CIM_CREATE_INSTANCE_REQUEST_MESSAGE, | CIM_CREATE_INSTANCE_REQUEST_MESSAGE, |
CIM_MODIFY_CLASS_REQUEST_MESSAGE, | CIM_MODIFY_CLASS_REQUEST_MESSAGE, |
CIM_MODIFY_INSTANCE_REQUEST_MESSAGE, | CIM_MODIFY_INSTANCE_REQUEST_MESSAGE, |
CIM_ENUMERATE_CLASSES_REQUEST_MESSAGE, |
CIM_ENUMERATE_CLASSES_REQUEST_MESSAGE, //10 |
CIM_ENUMERATE_CLASS_NAMES_REQUEST_MESSAGE, | CIM_ENUMERATE_CLASS_NAMES_REQUEST_MESSAGE, |
CIM_ENUMERATE_INSTANCES_REQUEST_MESSAGE, | CIM_ENUMERATE_INSTANCES_REQUEST_MESSAGE, |
CIM_ENUMERATE_INSTANCE_NAMES_REQUEST_MESSAGE, | CIM_ENUMERATE_INSTANCE_NAMES_REQUEST_MESSAGE, |
|
|
CIM_REFERENCES_REQUEST_MESSAGE, | CIM_REFERENCES_REQUEST_MESSAGE, |
CIM_REFERENCE_NAMES_REQUEST_MESSAGE, | CIM_REFERENCE_NAMES_REQUEST_MESSAGE, |
CIM_GET_PROPERTY_REQUEST_MESSAGE, | CIM_GET_PROPERTY_REQUEST_MESSAGE, |
CIM_SET_PROPERTY_REQUEST_MESSAGE, |
CIM_SET_PROPERTY_REQUEST_MESSAGE, //20 |
CIM_GET_QUALIFIER_REQUEST_MESSAGE, | CIM_GET_QUALIFIER_REQUEST_MESSAGE, |
CIM_SET_QUALIFIER_REQUEST_MESSAGE, | CIM_SET_QUALIFIER_REQUEST_MESSAGE, |
CIM_DELETE_QUALIFIER_REQUEST_MESSAGE, | CIM_DELETE_QUALIFIER_REQUEST_MESSAGE, |
CIM_ENUMERATE_QUALIFIERS_REQUEST_MESSAGE, | CIM_ENUMERATE_QUALIFIERS_REQUEST_MESSAGE, |
CIM_INVOKE_METHOD_REQUEST_MESSAGE, | CIM_INVOKE_METHOD_REQUEST_MESSAGE, |
CIM_ENABLE_INDICATION_SUBSCRIPTION_REQUEST_MESSAGE, |
CIM_PROCESS_INDICATION_REQUEST_MESSAGE, |
CIM_MODIFY_INDICATION_SUBSCRIPTION_REQUEST_MESSAGE, |
CIM_HANDLE_INDICATION_REQUEST_MESSAGE, |
CIM_DISABLE_INDICATION_SUBSCRIPTION_REQUEST_MESSAGE, |
CIM_NOTIFY_PROVIDER_REGISTRATION_REQUEST_MESSAGE, |
|
CIM_NOTIFY_PROVIDER_TERMINATION_REQUEST_MESSAGE, |
|
CIM_CREATE_SUBSCRIPTION_REQUEST_MESSAGE, // 30 |
|
CIM_MODIFY_SUBSCRIPTION_REQUEST_MESSAGE, |
|
CIM_DELETE_SUBSCRIPTION_REQUEST_MESSAGE, |
|
CIM_DISABLE_MODULE_REQUEST_MESSAGE, |
|
CIM_ENABLE_MODULE_REQUEST_MESSAGE, |
|
CIM_STOP_ALL_PROVIDERS_REQUEST_MESSAGE, |
|
|
CIM_GET_CLASS_RESPONSE_MESSAGE, | CIM_GET_CLASS_RESPONSE_MESSAGE, |
CIM_GET_INSTANCE_RESPONSE_MESSAGE, | CIM_GET_INSTANCE_RESPONSE_MESSAGE, |
CIM_EXPORT_INDICATION_RESPONSE_MESSAGE, | CIM_EXPORT_INDICATION_RESPONSE_MESSAGE, |
CIM_DELETE_CLASS_RESPONSE_MESSAGE, | CIM_DELETE_CLASS_RESPONSE_MESSAGE, |
CIM_DELETE_INSTANCE_RESPONSE_MESSAGE, |
CIM_DELETE_INSTANCE_RESPONSE_MESSAGE, // 40 |
CIM_CREATE_CLASS_RESPONSE_MESSAGE, | CIM_CREATE_CLASS_RESPONSE_MESSAGE, |
CIM_CREATE_INSTANCE_RESPONSE_MESSAGE, | CIM_CREATE_INSTANCE_RESPONSE_MESSAGE, |
CIM_MODIFY_CLASS_RESPONSE_MESSAGE, | CIM_MODIFY_CLASS_RESPONSE_MESSAGE, |
|
|
CIM_ENUMERATE_INSTANCES_RESPONSE_MESSAGE, | CIM_ENUMERATE_INSTANCES_RESPONSE_MESSAGE, |
CIM_ENUMERATE_INSTANCE_NAMES_RESPONSE_MESSAGE, | CIM_ENUMERATE_INSTANCE_NAMES_RESPONSE_MESSAGE, |
CIM_EXEC_QUERY_RESPONSE_MESSAGE, | CIM_EXEC_QUERY_RESPONSE_MESSAGE, |
CIM_ASSOCIATORS_RESPONSE_MESSAGE, |
CIM_ASSOCIATORS_RESPONSE_MESSAGE, // 50 |
CIM_ASSOCIATOR_NAMES_RESPONSE_MESSAGE, | CIM_ASSOCIATOR_NAMES_RESPONSE_MESSAGE, |
CIM_REFERENCES_RESPONSE_MESSAGE, | CIM_REFERENCES_RESPONSE_MESSAGE, |
CIM_REFERENCE_NAMES_RESPONSE_MESSAGE, | CIM_REFERENCE_NAMES_RESPONSE_MESSAGE, |
|
|
CIM_SET_QUALIFIER_RESPONSE_MESSAGE, | CIM_SET_QUALIFIER_RESPONSE_MESSAGE, |
CIM_DELETE_QUALIFIER_RESPONSE_MESSAGE, | CIM_DELETE_QUALIFIER_RESPONSE_MESSAGE, |
CIM_ENUMERATE_QUALIFIERS_RESPONSE_MESSAGE, | CIM_ENUMERATE_QUALIFIERS_RESPONSE_MESSAGE, |
CIM_INVOKE_METHOD_RESPONSE_MESSAGE, |
CIM_INVOKE_METHOD_RESPONSE_MESSAGE, // 60 |
CIM_ENABLE_INDICATION_SUBSCRIPTION_RESPONSE_MESSAGE, |
CIM_PROCESS_INDICATION_RESPONSE_MESSAGE, |
CIM_MODIFY_INDICATION_SUBSCRIPTION_RESPONSE_MESSAGE, |
CIM_NOTIFY_PROVIDER_REGISTRATION_RESPONSE_MESSAGE, |
CIM_DISABLE_INDICATION_SUBSCRIPTION_RESPONSE_MESSAGE, |
CIM_NOTIFY_PROVIDER_TERMINATION_RESPONSE_MESSAGE, |
|
CIM_HANDLE_INDICATION_RESPONSE_MESSAGE, |
|
CIM_CREATE_SUBSCRIPTION_RESPONSE_MESSAGE, |
|
CIM_MODIFY_SUBSCRIPTION_RESPONSE_MESSAGE, |
|
CIM_DELETE_SUBSCRIPTION_RESPONSE_MESSAGE, |
|
CIM_DISABLE_MODULE_RESPONSE_MESSAGE, |
|
CIM_ENABLE_MODULE_RESPONSE_MESSAGE, |
|
CIM_STOP_ALL_PROVIDERS_RESPONSE_MESSAGE, // 70 |
| |
// Monitor-related messages: | // Monitor-related messages: |
| |
|
|
// HTTP messages: | // HTTP messages: |
| |
HTTP_MESSAGE, | HTTP_MESSAGE, |
|
HTTP_ERROR_MESSAGE, |
|
|
|
// Exception messages to be passed to a CIM client application: |
|
|
|
CLIENT_EXCEPTION_MESSAGE, |
|
|
|
ASYNC_REGISTER_CIM_SERVICE, |
|
ASYNC_DEREGISTER_CIM_SERVICE, |
|
ASYNC_UPDATE_CIM_SERVICE, |
|
ASYNC_IOCTL, |
|
ASYNC_CIMSERVICE_START, // 80 |
|
ASYNC_CIMSERVICE_STOP, |
|
ASYNC_CIMSERVICE_PAUSE, |
|
ASYNC_CIMSERVICE_RESUME, |
|
|
|
ASYNC_ASYNC_OP_START, |
|
ASYNC_ASYNC_OP_RESULT, |
|
ASYNC_ASYNC_LEGACY_OP_START, |
|
ASYNC_ASYNC_LEGACY_OP_RESULT, |
|
|
|
ASYNC_FIND_SERVICE_Q, |
|
ASYNC_FIND_SERVICE_Q_RESULT, |
|
ASYNC_ENUMERATE_SERVICE, // 90 |
|
ASYNC_ENUMERATE_SERVICE_RESULT, |
|
|
|
ASYNC_REGISTERED_MODULE, |
|
ASYNC_DEREGISTERED_MODULE, |
|
ASYNC_FIND_MODULE_IN_SERVICE, |
|
ASYNC_FIND_MODULE_IN_SERVICE_RESPONSE, |
|
|
|
ASYNC_ASYNC_MODULE_OP_START, |
|
ASYNC_ASYNC_MODULE_OP_RESULT, |
|
|
|
CIM_NOTIFY_PROVIDER_ENABLE_REQUEST_MESSAGE, |
|
CIM_NOTIFY_PROVIDER_ENABLE_RESPONSE_MESSAGE, |
|
|
|
CIM_NOTIFY_PROVIDER_FAIL_REQUEST_MESSAGE, // 100 |
|
CIM_NOTIFY_PROVIDER_FAIL_RESPONSE_MESSAGE, |
|
|
|
CIM_INITIALIZE_PROVIDER_REQUEST_MESSAGE, |
|
CIM_INITIALIZE_PROVIDER_RESPONSE_MESSAGE, |
|
|
|
CIM_INITIALIZE_PROVIDER_AGENT_REQUEST_MESSAGE, |
|
CIM_INITIALIZE_PROVIDER_AGENT_RESPONSE_MESSAGE, |
|
|
|
CIM_NOTIFY_CONFIG_CHANGE_REQUEST_MESSAGE, |
|
CIM_NOTIFY_CONFIG_CHANGE_RESPONSE_MESSAGE, |
|
|
|
CIM_SUBSCRIPTION_INIT_COMPLETE_REQUEST_MESSAGE, |
|
CIM_SUBSCRIPTION_INIT_COMPLETE_RESPONSE_MESSAGE, |
| |
NUMBER_OF_MESSAGES | NUMBER_OF_MESSAGES |
}; | }; |
|
|
stack of queue-ids of queues which they must be returned to. This provides | stack of queue-ids of queues which they must be returned to. This provides |
a light efficient stack for this purpose. | a light efficient stack for this purpose. |
*/ | */ |
class QueueIdStack |
class PEGASUS_COMMON_LINKAGE QueueIdStack |
{ | { |
public: | public: |
| |
|
|
{ | { |
} | } |
| |
QueueIdStack(const QueueIdStack& x) : _size(x._size) |
QueueIdStack(const QueueIdStack& x); |
{ |
|
memcpy(_items, x._items, sizeof(_items)); |
|
} |
|
| |
PEGASUS_EXPLICIT QueueIdStack(Uint32 x) : _size(0) |
explicit QueueIdStack(Uint32 x); |
{ |
|
push(x); |
|
} |
|
| |
PEGASUS_EXPLICIT QueueIdStack(Uint32 x1, Uint32 x2) : _size(0) |
explicit QueueIdStack(Uint32 x1, Uint32 x2); |
{ |
|
push(x1); |
|
push(x2); |
|
} |
|
| |
~QueueIdStack() | ~QueueIdStack() |
{ | { |
} | } |
| |
QueueIdStack& operator=(const QueueIdStack& x) |
QueueIdStack& operator=(const QueueIdStack& x); |
{ |
|
if (this != &x) |
|
{ |
|
memcpy(_items, x._items, sizeof(_items)); |
|
_size = x._size; |
|
} |
|
return *this; |
|
} |
|
| |
Uint32 size() const | Uint32 size() const |
{ | { |
|
|
| |
void push(Uint32 x) | void push(Uint32 x) |
{ | { |
|
#ifdef PEGASUS_DEBUG |
if (_size == MAX_SIZE) | if (_size == MAX_SIZE) |
throw StackOverflow(); | throw StackOverflow(); |
|
#endif |
_items[_size++] = x; | _items[_size++] = x; |
} | } |
| |
Uint32& top() | Uint32& top() |
{ | { |
|
#ifdef PEGASUS_DEBUG |
if (_size == 0) | if (_size == 0) |
throw StackUnderflow(); | throw StackUnderflow(); |
|
#endif |
return _items[_size-1]; | return _items[_size-1]; |
} | } |
| |
|
|
| |
void pop() | void pop() |
{ | { |
|
#ifdef PEGASUS_DEBUG |
if (_size == 0) | if (_size == 0) |
throw StackUnderflow(); | throw StackUnderflow(); |
|
#endif |
_size--; | _size--; |
} | } |
| |
/** Make a copy of this stack and then pop the top element. */ | /** Make a copy of this stack and then pop the top element. */ |
QueueIdStack copyAndPop() const |
QueueIdStack copyAndPop() const; |
{ |
|
return QueueIdStack(*this, 0); |
|
} |
|
| |
private: | private: |
| |
// Copy the given stack but then pop the top element: | // Copy the given stack but then pop the top element: |
QueueIdStack(const QueueIdStack& x, int) : _size(x._size) |
QueueIdStack(const QueueIdStack& x, int); |
{ |
|
memcpy(_items, x._items, sizeof(_items)); |
|
pop(); |
|
} |
|
| |
enum { MAX_SIZE = 5 }; | enum { MAX_SIZE = 5 }; |
Uint32 _items[MAX_SIZE]; | Uint32 _items[MAX_SIZE]; |