/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ /* * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * This file incorporates work covered by the following license notice: * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed * with this work for additional information regarding copyright * ownership. The ASF licenses this file to you under the Apache * License, Version 2.0 (the "License"); you may not use this file * except in compliance with the License. You may obtain a copy of * the License at http://www.apache.org/licenses/LICENSE-2.0 . */ #ifndef INCLUDED_RTL_ALLOC_H #define INCLUDED_RTL_ALLOC_H #include #include #include #ifdef __cplusplus extern "C" { #endif /** Allocate memory. A call to this function will return NULL upon the requested memory size being either zero or larger than currently allocatable. @param Bytes [in] memory size. @return pointer to allocated memory. */ SAL_DLLPUBLIC void * SAL_CALL rtl_allocateMemory ( sal_Size Bytes ) SAL_THROW_EXTERN_C(); /** Reallocate memory. A call to this function with parameter 'Ptr' being NULL is equivalent to a rtl_allocateMemory() call. A call to this function with parameter 'Bytes' being 0 is equivalent to a rtl_freeMemory() call. @see rtl_allocateMemory() @see rtl_freeMemory() @param Ptr [in] pointer to previously allocated memory. @param Bytes [in] new memory size. @return pointer to reallocated memory. May differ from Ptr. */ SAL_DLLPUBLIC void * SAL_CALL rtl_reallocateMemory ( void * Ptr, sal_Size Bytes ) SAL_THROW_EXTERN_C(); /** Free memory. @param Ptr [in] pointer to previously allocated memory. @return none. Memory is released. Ptr is invalid. */ SAL_DLLPUBLIC void SAL_CALL rtl_freeMemory ( void * Ptr ) SAL_THROW_EXTERN_C(); /** Allocate and zero memory. A call to this function will return NULL upon the requested memory size being either zero or larger than currently allocatable. @param Bytes [in] memory size. @return pointer to allocated and zero'ed memory. */ SAL_DLLPUBLIC void * SAL_CALL rtl_allocateZeroMemory ( sal_Size Bytes ) SAL_THROW_EXTERN_C(); /** Zero memory Fills a block of memory with zeros in a way that is guaranteed to be secure @param Ptr [in] pointer to previously allocated memory. @param Bytes [in] memory size. @since LibreOffice 5.0 */ SAL_DLLPUBLIC void SAL_CALL rtl_secureZeroMemory ( void * Ptr, sal_Size Bytes ) SAL_THROW_EXTERN_C(); /** Zero and free memory. @param Ptr [in] pointer to previously allocated memory. @param Bytes [in] memory size. @return none. Memory is zero'ed with rtl_secureZeroMemory and released. Ptr is invalid. */ SAL_DLLPUBLIC void SAL_CALL rtl_freeZeroMemory ( void * Ptr, sal_Size Bytes ) SAL_THROW_EXTERN_C(); /** Allocate aligned memory. A call to this function will return NULL upon the requested memory size being either zero or larger than currently allocatable. Memory obtained through this function must be freed with rtl_freeAlignedMemory. @param Alignment [in] alignment in bytes, must be a power of two multiple of sizeof(void*). @param Bytes [in] memory size. @return pointer to allocated memory. @since LibreOffice 4.3 */ SAL_DLLPUBLIC void* SAL_CALL rtl_allocateAlignedMemory ( sal_Size Alignment, sal_Size Bytes ) SAL_THROW_EXTERN_C(); /** Free memory allocated with rtl_allocateAlignedMemory. @param Ptr [in] pointer to previously allocated memory. @return none. Memory is released. Ptr is invalid. @since LibreOffice 4.3 */ SAL_DLLPUBLIC void SAL_CALL rtl_freeAlignedMemory ( void * Ptr ) SAL_THROW_EXTERN_C(); /** Opaque rtl_arena_type. */ typedef struct SAL_DLLPUBLIC_RTTI rtl_arena_st rtl_arena_type; #define RTL_ARENA_NAME_LENGTH 31 /** rtl_arena_create() * * @param pName [in] descriptive name; for debugging purposes. * @param quantum [in] resource allocation unit / granularity; rounded up to next power of 2. * @param quantum_cache_max [in] max resources to cache; rounded up to next multiple of quantum; usually 0. * @param source_arena [in] passed as argument to source_alloc, source_free; usually NULL. * @param source_alloc [in] function to allocate resources; usually rtl_arena_alloc. * @param source_free [in] function to free resources; usually rtl_arena_free. * @param nFlags [in] flags; usually 0. * * @return pointer to rtl_arena_type, or NULL upon failure. * * @see rtl_arena_destroy() */ SAL_DLLPUBLIC rtl_arena_type * SAL_CALL rtl_arena_create ( const char * pName, sal_Size quantum, sal_Size quantum_cache_max, rtl_arena_type * source_arena, void * (SAL_CALL * source_alloc)(rtl_arena_type *, sal_Size *), void (SAL_CALL * source_free) (rtl_arena_type *, void *, sal_Size), int nFlags ) SAL_THROW_EXTERN_C(); /** rtl_arena_destroy() * * @param pArena [in] the arena to destroy. * @return None * * @see rtl_arena_create() */ SAL_DLLPUBLIC void SAL_CALL rtl_arena_destroy ( rtl_arena_type * pArena ) SAL_THROW_EXTERN_C(); /** rtl_arena_alloc() * * @param pArena [in] arena from which resource is allocated. * @param pBytes [inout] size of resource to allocate. * * @return allocated resource, or NULL upon failure. * * @see rtl_arena_free() */ SAL_DLLPUBLIC void * SAL_CALL rtl_arena_alloc ( rtl_arena_type * pArena, sal_Size * pBytes ) SAL_THROW_EXTERN_C(); /** rtl_arena_free() * * @param pArena [in] arena from which resource was allocated. * @param pAddr [in] resource to free. * @param nBytes [in] size of resource. * * @return None. * * @see rtl_arena_alloc() */ SAL_DLLPUBLIC void SAL_CALL rtl_arena_free ( rtl_arena_type * pArena, void * pAddr, sal_Size nBytes ) SAL_THROW_EXTERN_C(); /** Opaque rtl_cache_type. */ typedef struct rtl_cache_st rtl_cache_type; #define RTL_CACHE_NAME_LENGTH 31 #define RTL_CACHE_FLAG_BULKDESTROY 1 /** rtl_cache_create() * * @param pName [in] descriptive name; for debugging purposes. * @param nObjSize [in] object size. * @param nObjAlign [in] object alignment; usually 0 for suitable default. * @param constructor [in] object constructor callback function; returning 1 for success or 0 for failure. * @param destructor [in] object destructor callback function. * @param reclaim [in] reclaim callback function. * @param pUserArg [in] opaque argument passed to callback functions. * @param pSource [in] opaque argument passed to callback functions. * @param nFlags [in] flags. * * @return pointer to rtl_cache_type, or NULL upon failure. * * @see rtl_cache_destroy() */ SAL_DLLPUBLIC rtl_cache_type * SAL_CALL rtl_cache_create ( const char * pName, sal_Size nObjSize, sal_Size nObjAlign, int (SAL_CALL * constructor)(void * pObj, void * pUserArg), void (SAL_CALL * destructor) (void * pObj, void * pUserArg), void (SAL_CALL * reclaim) (void * pUserArg), void * pUserArg, rtl_arena_type * pSource, int nFlags ) SAL_THROW_EXTERN_C(); /** rtl_cache_destroy() * * @param pCache [in] the cache to destroy. * * @return None. * * @see rtl_cache_create() */ SAL_DLLPUBLIC void SAL_CALL rtl_cache_destroy ( rtl_cache_type * pCache ) SAL_THROW_EXTERN_C(); /** rtl_cache_alloc() * * @param pCache [in] cache from which object is allocated. * * @return pointer to allocated object, or NULL upon failure. */ SAL_DLLPUBLIC void * SAL_CALL rtl_cache_alloc ( rtl_cache_type * pCache ) SAL_THROW_EXTERN_C(); /** rtl_cache_free() * * @param pCache [in] cache from which object was allocated. * @param pObj [in] object to free. * * @return None. * * @see rtl_cache_alloc() */ SAL_DLLPUBLIC void SAL_CALL rtl_cache_free ( rtl_cache_type * pCache, void * pObj ) SAL_THROW_EXTERN_C(); #ifdef __cplusplus } #endif #endif // INCLUDED_RTL_ALLOC_H /* vim:set shiftwidth=4 softtabstop=4 expandtab: */ e='distro/nisz/libreoffice-6-4'>distro/nisz/libreoffice-6-4 LibreOffice 核心代码仓库文档基金会
summaryrefslogtreecommitdiff
AgeCommit message (Collapse)Author
2017-01-26Remove dynamic exception specificationsStephan Bergmann
...(for now, from LIBO_INTERNAL_CODE only). See the mail thread starting at <https://lists.freedesktop.org/archives/libreoffice/2017-January/076665.html> "Dynamic Exception Specifications" for details. Most changes have been done automatically by the rewriting loplugin:dynexcspec (after enabling the rewriting mode, to be committed shortly). The way it only removes exception specs from declarations if it also sees a definition, it identified some dead declarations-w/o-definitions (that have been removed manually) and some cases where a definition appeared in multiple include files (which have also been cleaned up manually). There's also been cases of macro paramters (that were used to abstract over exception specs) that have become unused now (and been removed). Furthermore, some code needed to be cleaned up manually (avmedia/source/quicktime/ and connectivity/source/drivers/kab/), as I had no configurations available that would actually build that code. Missing @throws documentation has not been applied in such manual clean-up. Change-Id: I3408691256c9b0c12bc5332de976743626e13960 Reviewed-on: https://gerrit.libreoffice.org/33574 Tested-by: Jenkins <ci@libreoffice.org> Reviewed-by: Stephan Bergmann <sbergman@redhat.com>
2015-11-24com::sun::star->css in winaccessibility/Noel Grandin
Change-Id: I644364fc6d8fc334044a3e53fcde24a6ef86c021 Reviewed-on: https://gerrit.libreoffice.org/20142 Tested-by: Jenkins <ci@libreoffice.org> Reviewed-by: Noel Grandin <noelgrandin@gmail.com>
2013-11-28winaccessibility: use uno::Reference in AccEventListenerMichael Stahl
... and clear it in disposing(). Change-Id: I69cfe3cdcf6549a0471453960d1f935d9c3b7a0d
2013-11-28winaccessibility: actually the member is unused, remove itMichael Stahl
Change-Id: I68e5c1785b73520cb59ca54a602ea176f8146f6f
2013-11-28winaccessibility: don't store XAccessible* in AccDescendant...ListenerMichael Stahl
Seems safer to store a Reference Change-Id: I86ef9d18c03b2a58058d38e2ae43553ecd2c7be6
2013-11-20winaccessibility: replace mysterious and inexplicable locking strategyMichael Stahl
Do the conservative thing and lock the SolarMutex at every UNO API entry point. Change-Id: I51afffada975df7ee3435784aa050a2c19cd0ac8
2013-11-20winaccessibility: make listener methods a bit more obviousMichael Stahl
- disambiguate overloading - only use SAL_CALL for UNO methods, and non-UNO methods start uppercase - use SAL_OVERRIDE Change-Id: Ib57adad65b2b8e8246b103ff77ce162b0b540422
2013-11-19Move to MPLv2 license headers, add modelines.Michael Meeks
Change-Id: I895bab038eda82b80e1a223ad877a9674fe561ee
2013-11-19Integrate branch of IAccessible2Steve Yin
Just the winaccessibility directory initially. Change-Id: Ia21abb8d7088646ad6c1f83b3a03e7add716b0c0