Reference

ACE_Null_Token(3)

No op class for nonthreaded platform protocols.

NAME

ACE_Null_Token - No op class for nonthreaded platform protocols.

SYNOPSIS

#include <ace/Local_Tokens.h>
class ACE_Null_Token : public ACE_Token_Proxy
{
  public:
    ACE_Null_Token (void);
    ~ACE_Null_Token (void);
    inline virtual int acquire (int = 0, void (* )(
        void *) = 0,
        ACE_Synch_Options & = ACE_Synch_Options::defaults
        );
    inline virtual int renew (
        int = -1,
        ACE_Synch_Options & = ACE_Synch_Options::defaults
        );
    inline virtual int tryacquire (void (* /* sleep_hook */)(
        void *) = 0
        );
    inline ACE_Synch_Options::defaults);
    inline ACE_Synch_Options::defaults);
    inline virtual ACE_Token_Proxy *clone (void) const;
    void dump (void) const;
    inline virtual ACE_Tokens *create_token (const ASYS_TCHAR *);
};

DESCRIPTION

This file contains definitions for the following classes:

public:
7. ACE_Token_Proxy
8. ACE_Null_Token : public ACE_Token_Proxy
9. ACE_Local_Mutex : public ACE_Token_Proxy
*. ACE_Local_RLock : public ACE_Local_Mutex
&. ACE_Local_WLock : public ACE_Local_Mutex private:
1. ACE_TOKEN_CONST
3. ACE_TPQ_Entry
b. ACE_TSS_TPQ_Entry
c. ACE_TPQ_Iterator
4. ACE_Token_Proxy_Queue
5. ACE_Tokens
6. ACE_Mutex_Token : public ACE_Tokens
12. ACE_RW_Token : public ACE_Tokens
a. ACE_Token_Name

Note that the locking classes defined in this file are *not*
intended to be used as general-purpose synchronization
mechanisms, such as mutexes or semaphores. Instead, you should
use the ACE_Recursive_Thread_Mutex, ACE_Thread_Mutex,
ACE_Thread_Semaphore, etc., that are defined in
$ACE_ROOT/ace/Synch.h and $ACE_ROOT/ace/Synch_T.h or the
ACE_Token that's defined in $ACE_ROOT/ace/Token.h.

PUBLIC MEMBERS

ACE_Null_Token (void);

Construction.

~ACE_Null_Token (void);

Destructor

inline virtual int acquire (int = 0, void (* )(
    void *) = 0,
    ACE_Synch_Options & = ACE_Synch_Options::defaults
    );

Acquire.

inline virtual int renew (
    int = -1,
    ACE_Synch_Options & = ACE_Synch_Options::defaults
    );

Renew.

inline virtual int tryacquire (void (* /* sleep_hook */)(void *) = 0);

Try acquire.

inline ACE_Synch_Options::defaults);

Release.

inline ACE_Synch_Options::defaults);

Remove.

inline virtual ACE_Token_Proxy *clone (void) const;

Return a dynamically allocated clone of the derived class.

void dump (void) const;

Dump the state of the class.

inline virtual ACE_Tokens *create_token (const ASYS_TCHAR *);

Do not allow the Token Manager to create us.

AUTHOR

Karl-Heinz Dorn [email protected], Douglas C. Schmidt [email protected], and Tim Harrison [email protected]

LIBRARY

ace