hash_multiset::load_factor (STL/CLR)

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at hash_multiset::load_factor (STL/CLR).

Counts the average elements per bucket.

Syntax

float load_factor();  

Remarks

The member function returns (float)hash_multiset::size (STL/CLR)() / hash_multiset::bucket_count (STL/CLR)(). You use it to determine the average bucket size.

Example

// cliext_hash_multiset_load_factor.cpp   
// compile with: /clr   
#include <cliext/hash_set>   
  
typedef cliext::hash_multiset<wchar_t> Myhash_multiset;   
int main()   
    {   
    Myhash_multiset c1;   
    c1.insert(L'a');   
    c1.insert(L'b');   
    c1.insert(L'c');   
  
// display initial contents " a b c"   
    for each (wchar_t elem in c1)   
        System::Console::Write(" {0}", elem);   
    System::Console::WriteLine();   
  
// inspect current parameters   
    System::Console::WriteLine("bucket_count() = {0}", c1.bucket_count());   
    System::Console::WriteLine("load_factor() = {0}", c1.load_factor());   
    System::Console::WriteLine("max_load_factor() = {0}",   
        c1.max_load_factor());   
    System::Console::WriteLine();   
  
// change max_load_factor and redisplay   
    c1.max_load_factor(0.25f);   
    System::Console::WriteLine("bucket_count() = {0}", c1.bucket_count());   
    System::Console::WriteLine("load_factor() = {0}", c1.load_factor());   
    System::Console::WriteLine("max_load_factor() = {0}",   
        c1.max_load_factor());   
    System::Console::WriteLine();   
  
// rehash and redisplay   
    c1.rehash(100);   
    System::Console::WriteLine("bucket_count() = {0}", c1.bucket_count());   
    System::Console::WriteLine("load_factor() = {0}", c1.load_factor());   
    System::Console::WriteLine("max_load_factor() = {0}",   
        c1.max_load_factor());   
    return (0);   
    }  
  

 a b c  
bucket_count
() = 16  
load_factor
() = 0.1875  
max_load_factor
() = 4  
  
bucket_count
() = 16  
load_factor
() = 0.1875  
max_load_factor
() = 0.25  
  
bucket_count
() = 128  
load_factor
() = 0.0234375  
max_load_factor
() = 0.25  

Requirements

Header: <cliext/hash_set>

Namespace: cliext

See Also

hash_multiset (STL/CLR)
hash_multiset::bucket_count (STL/CLR)
hash_multiset::max_load_factor (STL/CLR)