org.bridj

Class FlagSet<E extends Enum<E>>

java.lang.Object

org.bridj.FlagSet<E>

All Implemented Interfaces:

Iterable<E>, ValuedEnum<E>

Direct Known Subclasses:

FlagSet.IntFlagSet

public class FlagSet<E extends Enum<E>>
extends Object
implements ValuedEnum<E>

Set of int-valued enum values that is itself int-valued (bitwise OR of all the values).
This helps use Java enums (that implement ValuedEnum) as combinable C flags (see fromValues(E...) ).

Author:

ochafik

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FlagSet.IntFlagSet<E extends Enum<E>>

Method Summary

Methods

Modifier and Type	Method and Description
FlagSet<E>	and(E... valuesToBeCombinedWithOR)
static <EE extends Enum<EE>> FlagSet.IntFlagSet<EE>	createFlagSet(int value, Class<EE> enumClass)
static <EE extends Enum<EE>> FlagSet<EE>	createFlagSet(long value, Class<EE> enumClass)
static <EE extends Enum<EE>> FlagSet<EE>	createFlagSet(long value, EE... enumValue)
boolean	equals(Object o)
static <EE extends Enum<EE>> IntValuedEnum<EE>	fromValue(int value, Class<EE> enumClass)
static <EE extends Enum<EE>> IntValuedEnum<EE>	fromValue(int value, EE... enumValues)
static <EE extends Enum<EE>> ValuedEnum<EE>	fromValue(long value, EE... enumValues)
static <EE extends Enum<EE>> FlagSet<EE>	fromValue(ValuedEnum<EE> value)
static <E extends Enum<E>> FlagSet<E>	fromValues(E... enumValues)
static List<Long>	getBits(long value) Isolate bits that are set in the value.
Class<E>	getEnumClass()
boolean	has(E... valuesToBeCombinedWithOR) Tests if the flagset value is contains the OR combination of all the given values combined with bitwise OR operations.
int	hashCode()
boolean	is(E... valuesToBeCombinedWithOR) Tests if the flagset value is equal to the OR combination of all the given values combined with bitwise OR operations.
Iterator<E>	iterator()
FlagSet<E>	or(E... valuesToBeCombinedWithOR)
E	toEnum()
String	toString()
long	value() Get the integral value of this FlagSet.
FlagSet<E>	without(E... valuesToBeCombinedWithOR)

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

iterator

public Iterator<E> iterator()

Specified by:

iterator in interface Iterable<E extends Enum<E>>

toEnum

public E toEnum()

toString

public String toString()

Overrides:

toString in class Object

createFlagSet

public static <EE extends Enum<EE>> FlagSet<EE> createFlagSet(long value,
                                              Class<EE> enumClass)

createFlagSet

public static <EE extends Enum<EE>> FlagSet.IntFlagSet<EE> createFlagSet(int value,
                                                         Class<EE> enumClass)

fromValue

public static <EE extends Enum<EE>> FlagSet<EE> fromValue(ValuedEnum<EE> value)

createFlagSet

public static <EE extends Enum<EE>> FlagSet<EE> createFlagSet(long value,
                                              EE... enumValue)

fromValue

public static <EE extends Enum<EE>> IntValuedEnum<EE> fromValue(int value,
                                                Class<EE> enumClass)

fromValue

public static <EE extends Enum<EE>> IntValuedEnum<EE> fromValue(int value,
                                                EE... enumValues)

fromValue

public static <EE extends Enum<EE>> ValuedEnum<EE> fromValue(long value,
                                             EE... enumValues)

getBits

public static List<Long> getBits(long value)

Isolate bits that are set in the value.
For instance, getBits(0xf) yields 0x1, 0x2, 0x4, 0x8

Parameters:

value -

Returns:

split bits, which give the value back if OR-ed all together.

value

public long value()

Get the integral value of this FlagSet.

Specified by:

value in interface ValuedEnum<E extends Enum<E>>

Returns:

value of the flag set

getEnumClass

public Class<E> getEnumClass()

is

public boolean is(E... valuesToBeCombinedWithOR)

Tests if the flagset value is equal to the OR combination of all the given values combined with bitwise OR operations.
The following C code :

E v = ...; // E is an enum type
 if (v == (E_V1 | E_V2)) { ... }
 

Can be translated to the following Java + BridJ code :

FlagSet<E> v = ...;
 if (v.is(E_V1, E_V2)) { ... }
 

has

public boolean has(E... valuesToBeCombinedWithOR)

Tests if the flagset value is contains the OR combination of all the given values combined with bitwise OR operations.
The following C code :

E v = ...; // E is an enum type
 if (v & (E_V1 | E_V2)) { ... }
 

Can be translated to the following Java + BridJ code :

FlagSet<E> v = ...;
 if (v.has(E_V1, E_V2)) { ... }
 

or

public FlagSet<E> or(E... valuesToBeCombinedWithOR)

without

public FlagSet<E> without(E... valuesToBeCombinedWithOR)

and

public FlagSet<E> and(E... valuesToBeCombinedWithOR)

fromValues

public static <E extends Enum<E>> FlagSet<E> fromValues(E... enumValues)