Package org.jruby

Class RubySymbol.SymbolTable

java.lang.Object

org.jruby.RubySymbol.SymbolTable

Enclosing class:

RubySymbol

public static final class RubySymbol.SymbolTable
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static final class	RubySymbol.SymbolTable.SymbolEntry

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final int	DEFAULT_INITIAL_CAPACITY
(package private) static final float	DEFAULT_LOAD_FACTOR
private final float	loadFactor
(package private) static final int	MAXIMUM_CAPACITY
private final Ruby	runtime
private int	size
private RubySymbol.SymbolTable.SymbolEntry[]	symbolTable
private final ReentrantLock	tableLock
private int	threshold

Constructor Summary

Constructors

Constructor	Description
SymbolTable(Ruby runtime)

Method Summary

Modifier and Type	Method	Description
RubyArray	all_symbols()
private RubySymbol	createSymbol(String name, ByteList value, int hash, boolean hard)
private RubySymbol	createSymbol(String name, ByteList value, RubySymbol.ObjBooleanConsumer<RubySymbol> handler, int hash, boolean hard)
private RubySymbol	fastCreateSymbol(String internedName, boolean hard)
RubySymbol	fastGetSymbol(String internedName)
RubySymbol	fastGetSymbol(String internedName, boolean hard)
private RubySymbol	findSymbol(ByteList bytes, int hash, boolean hard)
private static RubySymbol.SymbolTable.SymbolEntry	getEntryFromTable(RubySymbol.SymbolTable.SymbolEntry[] table, int hash)
private static int	getIndex(int hash, RubySymbol.SymbolTable.SymbolEntry[] table)
RubySymbol	getSymbol(String name)
RubySymbol	getSymbol(String name, boolean hard)
RubySymbol	getSymbol(ByteList bytes)
RubySymbol	getSymbol(ByteList bytes, boolean hard)
RubySymbol	getSymbol(ByteList bytes, RubySymbol.ObjBooleanConsumer<RubySymbol> handler, boolean hard)	Get or retrieve an existing symbol from the table, invoking the given handler before return.
private RubySymbol.SymbolTable.SymbolEntry[]	getTableForCreate()
private static boolean	isSymbolMatch(String name, int hash, RubySymbol.SymbolTable.SymbolEntry entry)
private static boolean	isSymbolMatch(ByteList bytes, int hash, RubySymbol.SymbolTable.SymbolEntry entry)
RubySymbol	lookup(long id)
RubySymbol	lookup(String name)	Deprecated.
private RubySymbol	lookupSymbol(String name, RubySymbol.SymbolTable.SymbolEntry[] table, int hash, int index)
private RubySymbol	lookupSymbolByString(String internedName, RubySymbol.SymbolTable.SymbolEntry[] table, int index)
private RubySymbol.SymbolTable.SymbolEntry[]	rehash()
private void	removeDeadEntry(RubySymbol.SymbolTable.SymbolEntry[] table, int index, RubySymbol.SymbolTable.SymbolEntry last, RubySymbol.SymbolTable.SymbolEntry e)
int	size()
void	store(RubySymbol symbol)	Deprecated.
private void	storeSymbol(ByteList value, int hash, boolean hard, RubySymbol.SymbolTable.SymbolEntry[] table, int index, RubySymbol symbol, String internedName)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DEFAULT_INITIAL_CAPACITY

static final int DEFAULT_INITIAL_CAPACITY

See Also:

• Constant Field Values

MAXIMUM_CAPACITY

static final int MAXIMUM_CAPACITY

See Also:

• Constant Field Values

DEFAULT_LOAD_FACTOR

static final float DEFAULT_LOAD_FACTOR

See Also:

• Constant Field Values

tableLock

private final ReentrantLock tableLock

symbolTable

private volatile RubySymbol.SymbolTable.SymbolEntry[] symbolTable

size

private int size

threshold

private int threshold

loadFactor

private final float loadFactor

runtime

private final Ruby runtime

Constructor Details

SymbolTable

public SymbolTable(Ruby runtime)

Method Details

getSymbol

public RubySymbol getSymbol(String name)

getSymbol

public RubySymbol getSymbol(String name,
 boolean hard)

getSymbol

public RubySymbol getSymbol(ByteList bytes)

getSymbol

public RubySymbol getSymbol(ByteList bytes,
 boolean hard)

getSymbol

public RubySymbol getSymbol(ByteList bytes,
 RubySymbol.ObjBooleanConsumer<RubySymbol> handler,
 boolean hard)

Get or retrieve an existing symbol from the table, invoking the given handler before return. In the case of a new symbol, the handler will be invoked before the symbol is registered, so it can be manipulated without leaking changes.

Parameters:

bytes - the symbol bytes

handler - the handler to invoke

hard - whether to hold a hard reference to the symbol

Returns:

the new or existing symbol

findSymbol

private RubySymbol findSymbol(ByteList bytes,
 int hash,
 boolean hard)

fastGetSymbol

public RubySymbol fastGetSymbol(String internedName)

fastGetSymbol

public RubySymbol fastGetSymbol(String internedName,
 boolean hard)

getEntryFromTable

private static RubySymbol.SymbolTable.SymbolEntry getEntryFromTable(RubySymbol.SymbolTable.SymbolEntry[] table,
 int hash)

isSymbolMatch

private static boolean isSymbolMatch(String name,
 int hash,
 RubySymbol.SymbolTable.SymbolEntry entry)

isSymbolMatch

private static boolean isSymbolMatch(ByteList bytes,
 int hash,
 RubySymbol.SymbolTable.SymbolEntry entry)

createSymbol

private RubySymbol createSymbol(String name,
 ByteList value,
 int hash,
 boolean hard)

createSymbol

private RubySymbol createSymbol(String name,
 ByteList value,
 RubySymbol.ObjBooleanConsumer<RubySymbol> handler,
 int hash,
 boolean hard)

Parameters:

name - encoded symbol name

value - symbol bytes

handler - the handler to call

hash - the hash for the symbol

hard - whether to hold a hard reference to this symbol for the lifetime of the symbol table

Returns:

the new or existing symbol

See Also:

• RubySymbol.newSymbol(Ruby, ByteList, ObjBooleanConsumer)

storeSymbol

private void storeSymbol(ByteList value,
 int hash,
 boolean hard,
 RubySymbol.SymbolTable.SymbolEntry[] table,
 int index,
 RubySymbol symbol,
 String internedName)

fastCreateSymbol

private RubySymbol fastCreateSymbol(String internedName,
 boolean hard)

getIndex

private static int getIndex(int hash,
 RubySymbol.SymbolTable.SymbolEntry[] table)

getTableForCreate

private RubySymbol.SymbolTable.SymbolEntry[] getTableForCreate()

lookupSymbol

private RubySymbol lookupSymbol(String name,
 RubySymbol.SymbolTable.SymbolEntry[] table,
 int hash,
 int index)

lookupSymbolByString

private RubySymbol lookupSymbolByString(String internedName,
 RubySymbol.SymbolTable.SymbolEntry[] table,
 int index)

removeDeadEntry

private void removeDeadEntry(RubySymbol.SymbolTable.SymbolEntry[] table,
 int index,
 RubySymbol.SymbolTable.SymbolEntry last,
 RubySymbol.SymbolTable.SymbolEntry e)

lookup

public RubySymbol lookup(long id)

all_symbols

public RubyArray all_symbols()

size

public int size()

rehash

private RubySymbol.SymbolTable.SymbolEntry[] rehash()

lookup

@Deprecated
public RubySymbol lookup(String name)

Deprecated.

store

@Deprecated
public void store(RubySymbol symbol)

Deprecated.