/* * Copyright (C) 2012 Intel Corporation. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF * THE POSSIBILITY OF SUCH DAMAGE. */ /** * @file ewk_object.h * @brief Describes the Ewk Ref Counted API. */ #ifndef ewk_object_h #define ewk_object_h #include <Eina.h> #ifdef __cplusplus extern "C" { #endif /** Creates a type name for Ewk_Object */ typedef struct EwkObject Ewk_Object; /** * Increases the reference count of the given Ewk_Object. * * @param object the Ewk_Object instance to increase the reference count * * @return a pointer to the object on success, @c NULL otherwise. */ EAPI Ewk_Object *ewk_object_ref(Ewk_Object *object); /** * Decreases the reference count of the given Ewk_Object, possibly freeing it. * * When the reference count reaches 0, the item is freed. * * @param object the Ewk_Object instance to decrease the reference count */ EAPI void ewk_object_unref(Ewk_Object *object); #ifdef __cplusplus } #endif #endif // ewk_object_h