#[unsafe(no_mangle)]pub unsafe extern "C" fn openbim_ifc_v0_1_model_convert_length_unit(
model: OpenbimIfcModel,
target: *const u8,
target_len: usize,
flags: u32,
nodes: *mut OpenbimIfcValueNode,
node_capacity: usize,
out_nodes_required: *mut usize,
strings: *mut u8,
string_capacity: usize,
out_strings_required: *mut usize,
) -> OpenbimIfcStatusExpand description
Convert the model’s length unit to the unit named target
(target_len UTF-8 bytes): an SI METRE with any prefix, or inch,
foot, yard, mile, US survey foot. Every length, area and volume
value is rescaled as one checked transaction. flags:
OPENBIM_IFC_LENGTH_UNIT_KEEP_AREA_AND_VOLUME,
OPENBIM_IFC_LENGTH_UNIT_KEEP_REPLACED_UNITS,
OPENBIM_IFC_LENGTH_UNIT_DRY_RUN. The answer is the LengthUnitReport
tape of the module docs; a size query or a short buffer plans the
conversion and answers BufferTooSmall without applying it.
InvalidValue for a target that is not a length unit;
Unsupported naming the values the conversion cannot carry (a
parameter on a curve whose parameter space IFC leaves undefined, a
p-curve off a plane, polynomial coefficients …) and for an offset
unit (#110); InvalidModel when the project length unit does not
resolve; UnsupportedSchema; InvalidArgument for an unknown flag or
text that is not UTF-8; FeatureDisabled.
§Safety
target valid for target_len; the buffers as for
openbim_ifc_v0_1_entity_attribute.