/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* 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/. */ #include #include #include "nsCOMPtr.h" #include "nsISupports.h" #include "mozilla/unused.h" #define NS_IFOO_IID \ { 0x6f7652e0, 0xee43, 0x11d1, \ { 0x9c, 0xc3, 0x00, 0x60, 0x08, 0x8c, 0xa6, 0xb3 } } class IFoo : public nsISupports { public: NS_DECLARE_STATIC_IID_ACCESSOR(NS_IFOO_IID) public: IFoo(); // virtual dtor because IBar uses our Release() virtual ~IFoo(); NS_IMETHOD_(MozExternalRefCountType) AddRef(); NS_IMETHOD_(MozExternalRefCountType) Release(); NS_IMETHOD QueryInterface( const nsIID&, void** ); static void print_totals(); private: unsigned int refcount_; static unsigned int total_constructions_; static unsigned int total_destructions_; }; NS_DEFINE_STATIC_IID_ACCESSOR(IFoo, NS_IFOO_IID) class IBar; // some types I'll need typedef unsigned long NS_RESULT; // some functions I'll need (and define below) nsresult CreateIFoo( void** ); nsresult CreateIBar( void** result ); void AnIFooPtrPtrContext( IFoo** ); void AnISupportsPtrPtrContext( nsISupports** ); void AVoidPtrPtrContext( void** ); void set_a_IFoo( nsCOMPtr* result ); nsCOMPtr return_a_IFoo(); unsigned int IFoo::total_constructions_; unsigned int IFoo::total_destructions_; class test_message { public: test_message() { printf("BEGIN unit tests for |nsCOMPtr|, compiled " __DATE__ "\n"); } ~test_message() { IFoo::print_totals(); printf("END unit tests for |nsCOMPtr|.\n"); } }; test_message gTestMessage; /* ... */ void IFoo::print_totals() { printf("total constructions/destructions --> %d/%d\n", total_constructions_, total_destructions_); } IFoo::IFoo() : refcount_(0) { ++total_constructions_; printf(" new IFoo@%p [#%d]\n", static_cast(this), total_constructions_); } IFoo::~IFoo() { ++total_destructions_; printf("IFoo@%p::~IFoo() [#%d]\n", static_cast(this), total_destructions_); } MozExternalRefCountType IFoo::AddRef() { ++refcount_; printf("IFoo@%p::AddRef(), refcount --> %d\n", static_cast(this), refcount_); return refcount_; } MozExternalRefCountType IFoo::Release() { int newcount = --refcount_; if ( newcount == 0 ) printf(">>"); printf("IFoo@%p::Release(), refcount --> %d\n", static_cast(this), refcount_); if ( newcount == 0 ) { printf(" delete IFoo@%p\n", static_cast(this)); printf("<(this)); delete this; } return newcount; } nsresult IFoo::QueryInterface( const nsIID& aIID, void** aResult ) { printf("IFoo@%p::QueryInterface()\n", static_cast(this)); nsISupports* rawPtr = 0; nsresult status = NS_OK; if ( aIID.Equals(NS_GET_IID(IFoo)) ) rawPtr = this; else { nsID iid_of_ISupports = NS_ISUPPORTS_IID; if ( aIID.Equals(iid_of_ISupports) ) rawPtr = static_cast(this); else status = NS_ERROR_NO_INTERFACE; } NS_IF_ADDREF(rawPtr); *aResult = rawPtr; return status; } nsresult CreateIFoo( void** result ) // a typical factory function (that calls AddRef) { printf(">>CreateIFoo() --> "); IFoo* foop = new IFoo; printf("IFoo@%p\n", static_cast(foop)); foop->AddRef(); *result = foop; printf("<* result ) { printf(">>set_a_IFoo()\n"); assert(result); nsCOMPtr foop( do_QueryInterface(new IFoo) ); *result = foop; printf("< return_a_IFoo() { printf(">>return_a_IFoo()\n"); nsCOMPtr foop( do_QueryInterface(new IFoo) ); printf("<(this)); } IBar::~IBar() { printf("IBar@%p::~IBar()\n", static_cast(this)); } nsresult IBar::QueryInterface( const nsID& aIID, void** aResult ) { printf("IBar@%p::QueryInterface()\n", static_cast(this)); nsISupports* rawPtr = 0; nsresult status = NS_OK; if ( aIID.Equals(NS_GET_IID(IBar)) ) rawPtr = this; else if ( aIID.Equals(NS_GET_IID(IFoo)) ) rawPtr = static_cast(this); else { nsID iid_of_ISupports = NS_ISUPPORTS_IID; if ( aIID.Equals(iid_of_ISupports) ) rawPtr = static_cast(this); else status = NS_ERROR_NO_INTERFACE; } NS_IF_ADDREF(rawPtr); *aResult = rawPtr; return status; } nsresult CreateIBar( void** result ) // a typical factory function (that calls AddRef) { printf(">>CreateIBar() --> "); IBar* barp = new IBar; printf("IBar@%p\n", static_cast(barp)); barp->AddRef(); *result = barp; printf("<(&barP)); if ( barP ) { IFoo* fooP = 0; if ( NS_SUCCEEDED( result = barP->QueryInterface(NS_GET_IID(IFoo), reinterpret_cast(&fooP)) ) ) { fooP->print_totals(); NS_RELEASE(fooP); } NS_RELEASE(barP); } return result; } static nsresult TestBloat_Smart() { nsCOMPtr barP; nsresult result = CreateIBar( getter_AddRefs(barP) ); nsCOMPtr fooP( do_QueryInterface(barP, &result) ); if ( fooP ) fooP->print_totals(); return result; } nsCOMPtr gFoop; int main() { printf(">>main()\n"); printf("sizeof(nsCOMPtr) --> %u\n", unsigned(sizeof(nsCOMPtr))); TestBloat_Raw_Unsafe(); TestBloat_Smart(); { printf("\n### Test 1: will a |nsCOMPtr| call |AddRef| on a pointer assigned into it?\n"); nsCOMPtr foop( do_QueryInterface(new IFoo) ); printf("\n### Test 2: will a |nsCOMPtr| |Release| its old pointer when a new one is assigned in?\n"); foop = do_QueryInterface(new IFoo); // [Shouldn't compile] Is it a compile time error to try to |AddRef| by hand? //foop->AddRef(); // [Shouldn't compile] Is it a compile time error to try to |Release| be hand? //foop->Release(); // [Shouldn't compile] Is it a compile time error to try to |delete| an |nsCOMPtr|? //delete foop; printf("\n### Test 3: can you |AddRef| if you must?\n"); static_cast(foop)->AddRef(); printf("\n### Test 4: can you |Release| if you must?\n"); static_cast(foop)->Release(); printf("\n### Test 5: will a |nsCOMPtr| |Release| when it goes out of scope?\n"); } { printf("\n### Test 6: will a |nsCOMPtr| call the correct destructor?\n"); nsCOMPtr foop( do_QueryInterface(new IBar) ); mozilla::Unused << foop; } { printf("\n### Test 7: can you compare one |nsCOMPtr| with another [!=]?\n"); nsCOMPtr foo1p( do_QueryInterface(new IFoo) ); // [Shouldn't compile] Is it a compile time error to omit |getter_[doesnt_]AddRef[s]|? //AnIFooPtrPtrContext(&foo1p); // [Shouldn't compile] Is it a compile time error to omit |getter_[doesnt_]AddRef[s]|? //AVoidPtrPtrContext(&foo1p); nsCOMPtr foo2p( do_QueryInterface(new IFoo) ); if ( foo1p != foo2p ) printf("foo1p != foo2p\n"); else printf("foo1p == foo2p\n"); printf("\n### Test 7.5: can you compare a |nsCOMPtr| with NULL, 0, nullptr [!=]?\n"); if ( foo1p != 0 ) printf("foo1p != 0\n"); if ( 0 != foo1p ) printf("0 != foo1p\n"); if ( foo1p == 0 ) printf("foo1p == 0\n"); if ( 0 == foo1p ) printf("0 == foo1p\n"); IFoo* raw_foo2p = foo2p.get(); printf("\n### Test 8: can you compare a |nsCOMPtr| with a raw interface pointer [!=]?\n"); if ( foo1p.get() != raw_foo2p ) printf("foo1p != raw_foo2p\n"); else printf("foo1p == raw_foo2p\n"); printf("\n### Test 9: can you assign one |nsCOMPtr| into another?\n"); foo1p = foo2p; printf("\n### Test 10: can you compare one |nsCOMPtr| with another [==]?\n"); if ( foo1p == foo2p ) printf("foo1p == foo2p\n"); else printf("foo1p != foo2p\n"); printf("\n### Test 11: can you compare a |nsCOMPtr| with a raw interface pointer [==]?\n"); if ( raw_foo2p == foo2p.get() ) printf("raw_foo2p == foo2p\n"); else printf("raw_foo2p != foo2p\n"); #if 1 printf("\n### Test 11.5: can you compare a |nsCOMPtr| with a raw interface pointer [==]?\n"); if ( nsCOMPtr( raw_foo2p ) == foo2p ) printf("raw_foo2p == foo2p\n"); else printf("raw_foo2p != foo2p\n"); #endif printf("\n### Test 12: bare pointer test?\n"); if ( foo1p ) printf("foo1p is not NULL\n"); else printf("foo1p is NULL\n"); printf("\n### Test 13: numeric pointer test?\n"); if ( foo1p == 0 ) printf("foo1p is NULL\n"); else printf("foo1p is not NULL\n"); #if 0 if ( foo1p == 1 ) printf("foo1p allowed compare with in\n"); #endif printf("\n### Test 14: how about when two |nsCOMPtr|s referring to the same object go out of scope?\n"); } { printf("\n### Test 15,16 ...setup...\n"); IFoo* raw_foo1p = new IFoo; raw_foo1p->AddRef(); IFoo* raw_foo2p = new IFoo; raw_foo2p->AddRef(); printf("\n### Test 15: what if I don't want to |AddRef| when I construct?\n"); nsCOMPtr foo1p( dont_AddRef(raw_foo1p) ); //nsCOMPtr foo1p = dont_AddRef(raw_foo1p); printf("\n### Test 16: what if I don't want to |AddRef| when I assign in?\n"); nsCOMPtr foo2p; foo2p = dont_AddRef(raw_foo2p); } { printf("\n### setup for Test 17\n"); nsCOMPtr foop; printf("### Test 17: basic parameter behavior?\n"); CreateIFoo( nsGetterAddRefs(foop) ); } printf("### End Test 17\n"); { printf("\n### setup for Test 18\n"); nsCOMPtr foop; printf("### Test 18: basic parameter behavior, using the short form?\n"); CreateIFoo( getter_AddRefs(foop) ); } printf("### End Test 18\n"); { printf("\n### setup for Test 19, 20\n"); nsCOMPtr foop; printf("### Test 19: reference parameter behavior?\n"); set_a_IFoo(address_of(foop)); printf("### Test 20: return value behavior?\n"); foop = return_a_IFoo(); } printf("### End Test 19, 20\n"); { printf("\n### setup for Test 21\n"); nsCOMPtr fooP; printf("### Test 21: is |QueryInterface| called on assigning in a raw pointer?\n"); fooP = do_QueryInterface(new IFoo); } printf("### End Test 21\n"); { printf("\n### setup for Test 22\n"); nsCOMPtr fooP; fooP = do_QueryInterface(new IFoo); nsCOMPtr foo2P; printf("### Test 22: is |QueryInterface| _not_ called when assigning in a smart-pointer of the same type?\n"); foo2P = fooP; } printf("### End Test 22\n"); { printf("\n### setup for Test 23\n"); nsCOMPtr barP( do_QueryInterface(new IBar) ); printf("### Test 23: is |QueryInterface| called when assigning in a smart-pointer of a different type?\n"); nsCOMPtr fooP( do_QueryInterface(barP) ); if ( fooP ) printf("an IBar* is an IFoo*\n"); } printf("### End Test 23\n"); { printf("\n### setup for Test 24\n"); nsCOMPtr fooP( do_QueryInterface(new IFoo) ); printf("### Test 24: does |forget| avoid an AddRef/Release when assigning to another nsCOMPtr?\n"); nsCOMPtr fooP2( fooP.forget() ); } printf("### End Test 24\n"); { nsCOMPtr fooP; AnIFooPtrPtrContext( getter_AddRefs(fooP) ); AVoidPtrPtrContext( getter_AddRefs(fooP) ); } { nsCOMPtr supportsP; AVoidPtrPtrContext( getter_AddRefs(supportsP) ); AnISupportsPtrPtrContext( getter_AddRefs(supportsP) ); } printf("\n### Test 25: will a static |nsCOMPtr| |Release| before program termination?\n"); gFoop = do_QueryInterface(new IFoo); printf("<