Your Search Results


    This article is in need of an editorial review.

    « XPCOM API Reference

    already_AddRefed cooperates with nsCOMPtr to allow you to assign in a pointer without AddRefing it.

    You might want to use this as a return type from a function that produces an already AddRefed pointer as a result. In fact it is preferred to use already_AddRefed in this case over returning a raw pointer or nsCOMPtr (see the nsCOMPtr user manual).

    Defined in: xpcom/glue/nsCOMPtr.h.


    already_AddRefed<nsIFoo> GetFoo() {
      nsIFoo* foo = mFoo;
      return foo;
    // or
    already_AddRefed<nsIFoo> GetFoo() {
      nsCOMPtr<nsIFoo> foo = mFoo; 
      // ...
      return foo.forget();
    // The following assignment doesn't perform an additional AddRef,
    // as it would do if GetFoo() returned a raw pointer.
    nsCOMPtr<nsIFoo> foo = GetFoo();

    See also

    nsCOMPtr, getterAddRefs(), dont_AddRef().

    Document Tags and Contributors

    Contributors to this page: trevorh, Ms2ger, Nickolay, sheralwooden, gsvelto, gkeeley
    Last updated by: gkeeley,