initial commit

2026-09-17 19:39:08 +09:00 · 2026-08-07 15:56:42 +09:00
commit 91ad25aca9
1012 changed files with 159314 additions and 0 deletions
@@ -0,0 +1,107 @@
+classdef onCleanup < handle
+%ONCLEANUP - modified MATLAB class
+% 
+% EXAMPLES:
+%   %% cleanup function with no arguments %%
+%   1.) define cleanup routine:
+%           function cleanexit()
+%               fprintf('Reconstruction stopped!')
+%           end
+%
+%   2.) get instance of onCleanup:
+%       finishup = utils.onCleanup(@() cleanexit());
+%
+%   %% cleanup function with one or more arguments
+%   1.) define cleanup routine:
+%           function cleanexit(p)
+%               if ~p.getReport.completed
+%                   fprintf('Reconstruction stopped!')
+%               end
+%           end
+%
+%   2.) get instance of onCleanup:
+%           finishup = utils.onCleanup(p, @(x) cleanexit(x));
+%
+%   3.) if needed, update parameters that are passed to your cleanup
+%   function:
+%           finishup.update(p);           
+%
+%
+%
+%
+%onCleanup - Specify cleanup work to be done on function completion.
+%   C = onCleanup(S), when called in function F, specifies any cleanup tasks
+%   that need to be performed when F completes.  S is a handle to a function
+%   that performs necessary cleanup work when F exits (e.g., closing files that
+%   have been opened by F).  S will be called whether F exits normally or
+%   because of an error.
+%
+%   onCleanup is a MATLAB class and C = onCleanup(S) constructs an instance C of
+%   that class.  Whenever an object of this class is explicitly or implicitly
+%   cleared from the workspace, it runs the cleanup function, S.  Objects that
+%   are local variables in a function are implicitly cleared at the termination
+%   of that function.
+%
+%   Example 1: Use onCleanup to close a file.
+%
+%       function fileOpenSafely(fileName)
+%           fid = fopen(fileName, 'w');
+%           c = onCleanup(@()fclose(fid));
+%
+%           functionThatMayError(fid);
+%       end   % c will execute fclose(fid) here
+%
+%
+%   Example 2: Use onCleanup to restore the current directory.
+%
+%       function changeDirectorySafely(fileName)
+%           currentDir = pwd;
+%           c = onCleanup(@()cd(currentDir));
+%
+%           functionThatMayError;
+%       end   % c will execute cd(currentDir) here
+%
+%   See also: CLEAR, CLEARVARS
+
+%   Copyright 2007-2012 The MathWorks, Inc.
+
+    properties(SetAccess = 'public', GetAccess = 'public', Transient)
+        task = @nop;
+        prop = [];
+    end
+
+    methods
+        function h = onCleanup(functionHandle, varargin)
+            % onCleanup - Create a ONCLEANUP object
+            %   C = ONCLEANUP(FUNC) creates C, a ONCLEANUP object.  There is no need to
+            %   further interact with the variable, C.  It will execute FUNC at the time it
+            %   is cleared.
+            %
+            %   See also: CLEAR, ONCLEANUP
+            if ~isempty(varargin)
+                h.prop = varargin;
+            end
+            h.task = functionHandle;
+        end
+        
+        function update(h, varargin)
+            h.prop = varargin;
+        end
+        
+        function delete(h)
+            % DELETE - Delete a ONCLEANUP object.
+            %   DELETE does not need to be called directly, as it is called when the
+            %   ONCLEANUP object is cleared.  DELETE is implicitly called for all ONCLEANUP
+            %   objects that are local variables in a function that terminates.
+            %
+            %   See also: CLEAR, ONCLEANUP, ONCLEANUP/ONCLEANUP
+            if ~isempty(h.prop)
+                h.task(h.prop{:});
+            else
+                h.task();
+            end
+        end
+    end
+end
+function nop
+end