[line 43]
DatabaseMap is used to model a database.
GENERAL NOTE ------------ The propel.map classes are abstract building-block classes for modeling the database at runtime. These classes are similar (a lite version) to the propel.engine.database.model classes, which are build-time modeling classes. These classes in themselves do not do any database metadata lookups, but instead are used by the MapBuilder classes that were generated for your datamodel. The MapBuilder that was created for your datamodel build a representation of your database by creating instances of the DatabaseMap, TableMap, ColumnMap, etc. classes.
This method creates an empty TableMap that must then be populated. This is called indirectly on-demand by the getTable() method, when there is a table builder (MapBuilder) registered, but no TableMap loaded.