io.qt.core.QScopeGuard Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of qtjambi-jre8 Show documentation
There is a newer version: 6.3.0
/****************************************************************************
**
** Copyright (C) 2009-2021 Dr. Peter Droste, Omix Visualization GmbH & Co. KG. All rights reserved.
**
** This file is part of Qt Jambi.
**
** ** $BEGIN_LICENSE$
** GNU Lesser General Public License Usage
** This file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
** 
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
** $END_LICENSE$
**
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
**
****************************************************************************/
package io.qt.core;

/**
 * QScopeGuard is a class of which the sole purpose is to run the function f at the end of a try-with-resource block.
 * This is useful for guaranteeing your cleanup code is executed, whether the function is exited normally, 
 * exited early by a return statement, or exited by an exception.
 * 
 * See QScopeGuard.
 * Example:
 * 
 * QIODevice device = ...

 * try(var guard = new QScopeGuard(device::close)){

 *     if(!device.open())

 *         guard.dismiss();

 *     else

 *         device.write(...);

 * }
 * 
 */
public class QScopeGuard implements AutoCloseable{
	/**
	 * Create a scope guard that will execute function at the end of the scope.
	 * @param function runnable to be executed
	 */
	public QScopeGuard(Runnable function) {
		super();
		this.function = function;
	}

	@Override
	public void close() {
		if(function != null)
			function.run();
	}
	
	/**
	 * Disarms the scope guard, so that the function F will not be called at the end of the scope.
	 */
	public void dismiss()
    {
		function = null;
    }

	private Runnable function;
}