Class IdSet

Creates a new IdSet or loads one from a dictionary or a file.

To create a new, empty set: idset = IdSet(firstNumber = x). To create a set from a str->int dictionary: idset = IdSet(idDict = x). To load a dictionary from a file: idset = IdSet(filename = x).

Parameters:

• firstNumber (int) - The number given to the first name defined. Subsequent names will have higher numbers.
• idDict (dictionary) - Dictionary of name / integer pairs. The integer values must be unique.
• locked (boolean) - Whether new names can be added to the set. If set to True, getId will return None for names that are not already in the set.
• filename (str) - load name/id pairs from a file

Returns the id number for a name. If the name doesn't already have an id, a new id is defined, unless createIfNotExist is set to false, in which case None is returned for these cases.

Parameters:

• key (str) - name
• createIfNotExist (True, False or None) - If the name doesn't have an id, define an id for it

Returns: int or None

an identifier

Give a specific id for a certain name. Neither the name nor the id must exist in the set and the id must be smaller than the largest id already in the set. Usually this method is used only when inserting name/id pairs from an existing source.

Returns the name corresponding to the identifier. If the identifier doesn't exits, returns None.

Parameters:

• id (int) - the identifier number

Returns: str or None

a name

Returns a sorted list of all names. Can be slow for large IdSets.

Returns a sorted list of id numbers. Can be slow for large IdSets.

Loads name/id pairs from a file. The IdSet is cleared of all existing ids before loading the ones from the file.