1
0
mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-04-10 18:51:21 +03:00
occt/src/NCollection/NCollection_BaseAllocator.hxx
dpasukhi 1103eb60af 0033370: Foundation Classes - Moving into STL and Boost functionality
NCollection containers update:
  - NCollection_Array1 - updated functionality
  - NCollection_Array2 - NCollection_Array1 as a wrapper for 2array
  - NCollection_Vector -> NCollection_DynamicArray was renamed and reworked.
TCollection:
  - Use static empty string to avoid allocations on empty string
 NCollection allocators update:
  - NCollection_Allocator - allocator that used Standard::Allocate
  - NCollection_OccAllocator - allocator-wrapper that used OCC BaseAllocator objects
  - NCollection_IncAllocator - rework to increase performance
Standard:
  - Rework functionality to use different allocation libs
  - Implement basic of new way to wrap allocations tools
  - Define 4 ways to allocation (defines in configure stage)
 Additional changes:
  - Hash function uses std::hash functionality
   - size_t as a hash value
  - New HashUtils with Murmur and FVN hash algo for x32 and x64
  - Deprecated _0.cxx and .gxx DE classes reorganized
  - Create own utility for std memory
  - Update Standard_Transient to be more platform-independent
 Math TK changes:
  - math_Vector -> match_BaseVector<>
    - Buffer decreased to cash 32 elements instead of 512
2023-12-04 13:37:09 +00:00

75 lines
3.2 KiB
C++

// Created on: 2002-04-12
// Created by: Alexander KARTOMIN (akm)
// Copyright (c) 2002-2023 OPEN CASCADE SAS
//
// This file is part of Open CASCADE Technology software library.
//
// This library is free software; you can redistribute it and/or modify it under
// the terms of the GNU Lesser General Public License version 2.1 as published
// by the Free Software Foundation, with special exception defined in the file
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
// distribution for complete text of the license and disclaimer of any warranty.
//
// Alternatively, this file may be used under the terms of Open CASCADE
// commercial license or contractual agreement.
// Purpose: Basic class for memory allocation wizards.
// Defines the interface for devising different allocators
// firstly to be used by collections of NCollection, though it
// it is not deferred. It allocates/frees the memory through
// Standard procedures, thus it is unnecessary (and sometimes
// injurious) to have more than one such allocator. To avoid
// creation of multiple objects the constructors were maid
// inaccessible. To create the BaseAllocator use the method
// CommonBaseAllocator.
// Note that this object is managed by Handle.
#ifndef NCollection_BaseAllocator_HeaderFile
#define NCollection_BaseAllocator_HeaderFile
#include <Standard_DefineHandle.hxx>
#include <Standard_Transient.hxx>
/**
* Purpose: Basic class for memory allocation wizards.
* Defines the interface for devising different allocators
* firstly to be used by collections of NCollection, though it
* it is not deferred. It allocates/frees the memory through
* Standard procedures, thus it is unnecessary (and sometimes
* injurious) to have more than one such allocator. To avoid
* creation of multiple objects the constructors were maid
* inaccessible. To create the BaseAllocator use the method
* CommonBaseAllocator.
* Note that this object is managed by Handle.
*/
class NCollection_BaseAllocator : public Standard_Transient
{
public:
// ---------- PUBLIC METHODS ------------
Standard_EXPORT virtual void* Allocate (const size_t theSize);
Standard_EXPORT virtual void* AllocateOptimal(const size_t theSize);
Standard_EXPORT virtual void Free (void* theAddress);
//! CommonBaseAllocator
//! This method is designed to have the only one BaseAllocator (to avoid
//! useless copying of collections). However one can use operator new to
//! create more BaseAllocators, but it is injurious.
Standard_EXPORT static const Handle(NCollection_BaseAllocator)&
CommonBaseAllocator(void);
protected:
//! Constructor - prohibited
NCollection_BaseAllocator() {}
private:
//! Copy constructor - prohibited
NCollection_BaseAllocator(const NCollection_BaseAllocator&) = delete;
public:
// ---------- CasCade RunTime Type Information
DEFINE_STANDARD_RTTIEXT(NCollection_BaseAllocator,Standard_Transient)
};
DEFINE_STANDARD_HANDLE(NCollection_BaseAllocator,Standard_Transient)
#endif