Method release

inst/include/Rcpp/XPtr.h:183–193

* Release the external pointer (if any) immediately. This will cause * the pointer to be deleted and it's storage to be set to NULL. * After this call the get() method returns NULL and the checked_get() * method throws an exception. * * See the discussion here for the basic logic behind release: * https://stat.ethz.ch/pipermail/r-help/2007-August/137871.html */

     * https://stat.ethz.ch/pipermail/r-help/2007-August/137871.html
     */
    void release() {

        if (get() != NULL) {
            // Call the finalizer -- note that this implies that finalizers
            // need to be ready for a NULL external pointer value (our
            // default C++ finalizer is since delete NULL is a no-op).
            // This clears the external pointer just before calling the finalizer,
            // to avoid interesting behavior with co-dependent finalizers.
            finalizer_wrapper<T,Finalizer>(Storage::get__());
        }
    }

    inline operator T*() {
        return checked_get();