_source_control_containers_8h

Wwise SDK 2024.1.9

 /*******************************************************************************
 The content of this file includes portions of the AUDIOKINETIC Wwise Technology
 released in source code form as part of the SDK installer package.
  
 Commercial License Usage
  
 Licensees holding valid commercial licenses to the AUDIOKINETIC Wwise Technology
 may use this file in accordance with the end user license agreement provided 
 with the software or, alternatively, in accordance with the terms contained in a
 written agreement between you and Audiokinetic Inc.
  
 Apache License Usage
  
 Alternatively, this file may be used under the Apache License, Version 2.0 (the 
 "Apache License"); you may not use this file except in compliance with the 
 Apache License. You may obtain a copy of the Apache License at 
 http://www.apache.org/licenses/LICENSE-2.0.
  
 Unless required by applicable law or agreed to in writing, software distributed
 under the Apache License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES
 OR CONDITIONS OF ANY KIND, either express or implied. See the Apache License for
 the specific language governing permissions and limitations under the License.
  
   Copyright (c) 2025 Audiokinetic Inc.
 *******************************************************************************/
  
 /// \file AK/Wwise/SourceControl/SourceControlContainers.h
 /// \brief Wwise source control containers interface that is used to pass data containers (list and map) in parameters.
  
 #ifndef _AK_WWISE_SOURCECONTROLCONTAINERS_H
 #define _AK_WWISE_SOURCECONTROLCONTAINERS_H
  
 // Audiokinetic namespace
 namespace AK
 {
     // Audiokinetic Wwise namespace
     namespace Wwise
     {
         /// Source Control Containers namespace
         namespace SourceControlContainers
         {
             /// Container position
             struct __AkPos{};
             /// Pointer to a container position
             typedef __AkPos* AkPos;
  
             // IAkList
             /// Template parameters:
             /// - Type: Class of object stored in the list.
             /// - Arg_Type: Type used to reference objects stored in the list. Can be a reference.  By default, this is a reference to the type.
             ///
             /// \akwarning
             /// The functions in this interface are not thread-safe, unless stated otherwise.
             /// \endakwarning
             ///
             /// \aknote The class implementing this interface is a wrapper around the MFC \b CList class.  Documentation can be found on MSDN.
             /// \endaknote
             template <class Type, class Arg_Type = const Type&>
             class IAkList
             {
             public:
                 virtual void Reserve(size_t in_capacity) {}
                 [[deprecated("Use GetSize() instead.")]]
                 unsigned int GetCount() const { return GetSize(); }
                 virtual unsigned int GetSize() const = 0;
                 virtual bool IsEmpty() const = 0;
  
                 /// \warning Invalidates previously obtained AkPos
                 [[deprecated("Use InsertBefore(GetHeadPosition(), in_newElement) instead.")]]
                 virtual void AddHead( Arg_Type in_newElement ) = 0;
                 /// \warning Invalidates previously obtained AkPos
                 virtual void AddTail( Arg_Type in_newElement ) = 0;
  
                 /// \warning Invalidates previously obtained AkPos
                 [[deprecated("Use RemoveAt(GetHeadPosition()) instead.")]]
                 virtual void RemoveHead() = 0;
                 /// \warning Invalidates previously obtained AkPos
                 virtual void RemoveTail() = 0;
                 /// \warning Invalidates previously obtained AkPos
                 virtual void RemoveAt( AkPos in_position ) = 0;
                 /// \warning Invalidates previously obtained AkPos
                 virtual void RemoveAll() = 0;
  
                 virtual Type& GetHead() = 0;
                 virtual const Type& GetHead() const = 0;
                 virtual Type& GetTail() = 0;
                 virtual const Type& GetTail() const = 0;
                 /// \warning Invalidates previously obtained AkPos (do not call while iterating)
                 virtual AkPos GetHeadPosition() const = 0;
                 /// \warning Invalidates previously obtained AkPos (do not call while iterating)
                 virtual AkPos GetTailPosition() const = 0;
                 /// \warning Must be called with a AkPos obtained from the same container instance
                 virtual Type& GetNext( AkPos& in_rPosition ) = 0;
                 /// \warning Must be called with a AkPos obtained from the same container instance
                 virtual const Type& GetNext( AkPos& in_rPosition ) const = 0;
                 /// \warning Must be called with a AkPos obtained from the same container instance
                 virtual Type& GetPrev( AkPos& in_rPosition ) = 0;
                 /// \warning Must be called with a AkPos obtained from the same container instance
                 virtual const Type& GetPrev( AkPos& in_rPosition ) const = 0;
                 virtual Type& GetAt( AkPos in_position ) = 0;
                 virtual const Type& GetAt( AkPos in_position ) const = 0;
                 virtual Type& GetAt( unsigned int in_index ) = 0;
                 virtual const Type& GetAt( unsigned int in_index ) const = 0;
  
                 virtual void SetAt( AkPos in_pos, Arg_Type in_newElement ) = 0;
                 /// \warning Invalidates previously obtained AkPos
                 virtual AkPos InsertBefore( AkPos in_position, Arg_Type in_newElement ) = 0;
                 /// \warning Invalidates previously obtained AkPos
                 virtual AkPos InsertAfter( AkPos in_position, Arg_Type in_newElement ) = 0;
             };
  
             // IAkMap
             /// Template parameters:
             /// - Key: Class of the object used as the map key.
             /// - Arg_Key: Data type used for Key arguments.
             /// - Value: Class of the object stored in the map.
             /// - Arg_Value: Data type used for Value arguments; usually a reference to Value.
             ///
             /// \akwarning
             /// The functions in this interface are not thread-safe, unless stated otherwise.
             /// \endakwarning
             ///
             /// \aknote The class implementing this interface is a wrapper around the MFC \b CMap class.  Documentation can be found on MSDN.
             /// \endaknote
             template <class Key, class Arg_Key, class Value, class Arg_Value>
             class IAkMap
             {
             public:
                 [[deprecated("Use GetSize() instead.")]]
                 unsigned int GetCount() const { return GetSize(); }
                 virtual unsigned int GetSize() const = 0;
                 virtual bool IsEmpty() const = 0;
  
                 virtual bool Lookup( Arg_Key in_key, Value& in_rValue ) const = 0;
  
                 virtual Value& operator[]( Arg_Key in_key ) = 0;
                 virtual void SetAt( Arg_Key in_key, Arg_Value in_newValue ) = 0;
  
                 virtual bool RemoveKey( Arg_Key in_key ) = 0;
                 virtual void RemoveAll() = 0;
  
                 virtual AkPos GetStartPosition() const = 0;
                 virtual void GetNextAssoc( AkPos& in_rNextPosition, Key& in_rKey, Value& in_rValue ) const = 0;
             };
         };
     }
 }
  
 #endif // _AK_WWISE_SOURCECONTROLCONTAINERS_H