Class ChoiceState

x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__

(inherited documentation)

Determine whether the provided value can be added to the instance without violating state validation.

This method must not throw any non-catastrophic exceptions; general failures should be transformed to a False return value.

Parameters:

• particle_state - The ParticleState instance serving as the parent to this state. The implementation must inform that state when the proposed value completes the content model.
• instance - An instance of a subclass of basis.complexTypeDefinition, into which the provided value will be stored if it is consistent with the current model state.
• value - The value that is being validated against the state.
• element_use - An optional ElementUse instance that specifies the element to which the value corresponds. This will be available when the value is extracted by parsing a document, but will be absent if the value was passed as a constructor positional parameter.

Returns:

True if the value was successfully matched against the state. False if the value did not match against the state.

Overrides: ContentState_mixin.accepts

(inherited documentation)

Invoked by a sub-state to indicate that validation cannot proceed in the current state.

Normally this is used when an intermediate content model must reset itself to permit alternative models to be evaluated.

Parameters:

• sub_state - the state that was unable to accept a value
• particle_ok - True if the particle that rejected the value is in an accepting terminal state

Overrides: ContentState_mixin.notifyFailure

(inherited documentation)