In computer programming, a postcondition is a condition or predicate that must always be true just after the execution of some section of code or after an operation in a formal specification. Postconditions are sometimes tested using assertions within the code itself. Often, postconditions are simply included in the documentation of the affected section of code.
For example: The result of a factorial is always an integer and greater than or equal to 1. So a program that calculates the factorial of an input number would have postconditions that the result after the calculation be an integer and that it be greater than or equal to 1. Another example: a program that calculates the square root of an input number might have the postconditions that the result be a number and that its square be equal to the input.
In some software design approaches, postconditions, along with preconditions and class invariants, are components of the software construction method design by contract.
The postcondition for any routine is a declaration of the properties which are guaranteed upon completion of the routine's execution.[1] As it relates to the routine's contract, the postcondition offers assurance to potential callers that in cases in which the routine is called in a state in which its precondition holds, the properties declared by the postcondition are assured.
The following example written in Eiffel sets the value of a class attribute hour
based on a caller-provided argument a_hour
. The postcondition follows the keyword ensure
. In this example, the postcondition guarantees, in cases in which the precondition holds (i.e., when a_hour
represents a valid hour of the day), that after the execution of set_hour
, the class attribute hour
will have the same value as a_hour
. The tag "hour_set:
" describes this postcondition clause and serves to identify it in case of a runtime postcondition violation.
In the presence of inheritance, the routines inherited by descendant classes (subclasses) do so with their contracts, that is their preconditions and postconditions, in force. This means that any implementations or redefinitions of inherited routines also have to be written to comply with their inherited contracts. Postconditions can be modified in redefined routines, but they may only be strengthened.[2] That is, the redefined routine may increase the benefits it provides to the client, but may not decrease those benefits.