android/android-emu/android/base/files/ScopedFileHandle.h

// Copyright 2014 The Android Open Source Project
//
// This software is licensed under the terms of the GNU General Public
// License version 2, as published by the Free Software Foundation, and
// may be copied, distributed, and modified under those terms.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

#pragma once

#ifndef _WIN32
// nothing here
#else  // _WIN32

#include "android/base/Compiler.h"

#define WIN32_LEAN_AND_MEAN 1
#include <windows.h>

namespace android {
namespace base {

// Helper class used to wrap a Win32  file HANDLE that will be closed when
// the instance is destroyed, unless the release() method was called
// before that.
class ScopedFileHandle {
public:
    // Constructor takes ownership of |handle|.
    explicit ScopedFileHandle(HANDLE handle = INVALID_HANDLE_VALUE)
        : handle_(handle) {}

    // Destructor calls close() method.
    ~ScopedFileHandle() { close(); }

    // Returns true iff the wrapped HANDLE value is valid.
    bool valid() const { return handle_ != INVALID_HANDLE_VALUE; }

    // Return current HANDLE value. Does _not_ transfer ownership.
    HANDLE get() const { return handle_; }

    // Return current HANDLE value, transferring ownership to the caller.
    HANDLE release() {
        HANDLE h = handle_;
        handle_ = INVALID_HANDLE_VALUE;
        return h;
    }

    // Close handle if it is not invalid.
    void close() {
        if (handle_ != INVALID_HANDLE_VALUE) {
            ::CloseHandle(handle_);
            handle_ = INVALID_HANDLE_VALUE;
        }
    }

    // Swap the content of two ScopedFileHandle instances.
    void swap(ScopedFileHandle* other) {
        HANDLE handle = handle_;
        handle_ = other->handle_;
        other->handle_ = handle;
    }

private:
    DISALLOW_COPY_AND_ASSIGN(ScopedFileHandle);

    HANDLE handle_;
};

}  // namespace base
}  // namespace android

#endif  // _WIN32