cf.List.del_property

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

Remove a property.

New in version 3.0.0.

Parameters:
prop: str

The name of the property.

Parameter example:

prop='long_name'

default: optional

Return the value of the default parameter if the property does not exist. If set to an Exception instance then it will be raised instead.

Returns:

The removed property.

Examples:

>>> 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