cfdm.core.DomainAncillary.del_property

DomainAncillary.del_property(prop, default=ValueError())[source]

Remove a property.

New in version (cfdm): 1.7.0

Parameters
prop: str

The name of the property to be removed.

Parameter example:

prop='long_name'

default: optional

Return the value of the default parameter if the property has not been set.

If set to an Exception instance then it will be raised instead.

Returns

The removed property value.

Examples:

>>> f = cfdm.core.DomainAncillary()
>>> f.set_property('project', 'CMIP7')
>>> f.has_property('project')
True
>>> f.get_property('project')
'CMIP7'
>>> f.del_property('project')
'CMIP7'
>>> f.has_property('project')
False
>>> print(f.del_property('project', None))
None
>>> print(f.get_property('project', None))
None