pub fn long_name_of(
model: &Model,
zone: EntityId,
) -> Result<Option<String>, SchemaGap>Expand description
LongName of a single IfcZone, distinguishing “not authored” from
“this release has no such attribute”.
zones cannot make this distinction: its Zone::long_name field is
Option<String> and predates #52, so both cases collapse to None
there. IFC2X3’s IfcZone has no LongName at all (it is a plain
five-attribute IfcGroup subtype), unlike IFC4’s and IFC4X3’s, which add
LongName as the sixth. Reading it under IFC2X3 is therefore not “the
file left it blank” – there is no slot to have left blank – and a
caller that needs to tell the two apart should use this accessor instead
of Zone::long_name.
§Errors
SchemaGap::Schema if the model’s FILE_SCHEMA does not resolve to
IFC2X3, IFC4 or IFC4X3. SchemaGap::NotInSchema if the resolved
release does not declare LongName for IfcZone (IFC2X3).