microsoft-visualbasic-runtime/ComponentModel/DataStructures/BitMap/HashModel.vb

#Region "Microsoft.VisualBasic::41ba2dd93115d064fca9cd3c745bf034, Microsoft.VisualBasic.Core\ComponentModel\DataStructures\BitMap\HashModel.vb"

    ' Author:
    ' 
    '       asuka (amethyst.asuka@gcmodeller.org)
    '       xie (genetics@smrucc.org)
    '       xieguigang (xie.guigang@live.com)
    ' 
    ' Copyright (c) 2018 GPL3 Licensed
    ' 
    ' 
    ' GNU GENERAL PUBLIC LICENSE (GPL3)
    ' 
    ' 
    ' This program is free software: you can redistribute it and/or modify
    ' it under the terms of the GNU General Public License as published by
    ' the Free Software Foundation, either version 3 of the License, or
    ' (at your option) any later version.
    ' 
    ' 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.
    ' 
    ' You should have received a copy of the GNU General Public License
    ' along with this program. If not, see <http://www.gnu.org/licenses/>.



    ' /********************************************************************************/

    ' Summaries:

    '     Interface IAddressOf
    ' 
    ' 
    ' 
    '     Interface IAddress
    ' 
    '         Properties: Address
    ' 
    '         Sub: Assign
    ' 
    '     Interface IHashHandle
    ' 
    ' 
    ' 
    '     Class IHashValue
    ' 
    '         Properties: Address, ID, obj
    ' 
    '         Sub: Assign
    ' 
    '     Module AddressedValueExtensions
    ' 
    '         Function: Vector
    ' 
    ' 
    ' /********************************************************************************/

#End Region

Imports System.Runtime.CompilerServices
Imports Microsoft.VisualBasic.ComponentModel.Collection.Generic

Namespace ComponentModel

    ''' <summary>
    ''' This object gets a object handle value to indicated that the position this object exists 
    ''' in the list collection structure. 
    ''' (这个对象具有一个用于指明该对象在列表对象中的位置的对象句柄值)
    ''' </summary>
    ''' <remarks></remarks>
    Public Interface IAddressOf : Inherits IAddress(Of Integer)
    End Interface

    ''' <summary>
    ''' This object gets a object handle value to indicated that the position this object exists 
    ''' in the list collection structure. 
    ''' (这个对象具有一个用于指明该对象在列表对象中的位置的对象句柄值)
    ''' </summary>
    ''' <remarks></remarks>
    Public Interface IAddress(Of T As IComparable)

        ''' <summary>
        ''' The ID that this object in a list instance.
        ''' (本对象在一个列表对象中的位置索引号) 
        ''' </summary>
        ''' <value></value>
        ''' <returns></returns>
        ''' <remarks>因为索引号在赋值之后是不可以被修改了的，所以这个属性使用ReadOnly</remarks>
        ReadOnly Property Address As T

        Sub Assign(address As T)
    End Interface

    Public Interface IHashHandle : Inherits IAddressOf, INamedValue
    End Interface

    Public Class IHashValue(Of T As INamedValue)
        Implements IHashHandle

        Public Property obj As T
        Public Property Address As Integer Implements IAddressOf.Address
        Public Property ID As String Implements INamedValue.Key
            Get
                Return obj.Key
            End Get
            Set(value As String)
                obj.Key = value
            End Set
        End Property

        Public Sub Assign(address As Integer) Implements IAddress(Of Integer).Assign
            Me.Address = address
        End Sub
    End Class

    <HideModuleName>
    <Extension>
    Public Module AddressedValueExtensions

        <Extension>
        Public Function Vector(Of T As IAddress(Of Integer), TOut)(source As IEnumerable(Of T), length As Integer, getValue As Func(Of T, TOut)) As TOut()
            Dim chunk As TOut() = New TOut(length - 1) {}

            For Each element As T In source
                chunk(element.Address) = getValue(element)
            Next

            Return chunk
        End Function
    End Module
End Namespace