% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/RcppExports.R
\name{rcpp_hdf5_close_at_paths}
\alias{rcpp_hdf5_close_at_paths}
\title{Close all live HDF5Matrix handles pointing to specific dataset paths.}
\usage{
rcpp_hdf5_close_at_paths(filename, paths)
}
\arguments{
\item{filename}{Canonical filesystem path to the HDF5 file.}

\item{paths}{Character vector of HDF5-internal paths
(e.g. \code{c("EIGEN/sym/values", "EIGEN/sym/vectors")}).}
}
\value{
\code{NULL} invisibly.
}
\description{
Scans the live-pointer registry for any open \code{hdf5Dataset} objects
that match the given \code{filename} and any of the \code{paths}.
Each matching object is closed and its external pointer cleared, so
that any R6 \code{HDF5Matrix} objects holding those pointers will
return \code{FALSE} from \code{is_valid()} immediately.

This is called automatically by R6 methods that use
\code{overwrite = TRUE} (e.g. \code{$eigen()}, \code{$svd()},
\code{$qr()}, \code{$chol()}, \code{$prcomp()}) to ensure that
previous result objects are safely invalidated before the HDF5 datasets
they reference are deleted and recreated.
}
\keyword{internal}
