blob: cd9d5d8c79f0128aa27e21330213a42e56bc576d (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
|
package org.checkerframework.dataflow.qual;
import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* {@code TerminatesExecution} is a method annotation that indicates that a
* method terminates the execution of the program. This can be used to
* annotate methods such as {@code System.exit()}.
* <p>
* The annotation enables flow-sensitive type refinement to be more
* precise. For example, after
* <pre>
* if (x == null) {
* System.err.println("Bad value supplied");
* System.exit(1);
* }
* </pre>
* the Nullness Checker can determine that {@code x} is non-null.
*
* <p>
* The annotation is a <em>trusted</em> annotation, meaning that it is not
* checked whether the annotated method really does terminate the program.
*
* @checker_framework.manual #type-refinement Automatic type refinement (flow-sensitive type qualifier inference)
*
* @author Stefan Heule
*
*/
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.METHOD, ElementType.CONSTRUCTOR })
public @interface TerminatesExecution {
}
|