docs/ecma334/17.5.8.xml

   1 <?xml version="1.0"?>
   2 <clause number="17.5.8" title="Method body">
   3   <paragraph>The <non_terminal where="17.5">method-body</non_terminal> of a method declaration consists of either a block or a semicolon. </paragraph>
   4   <paragraph>Abstract and external method declarations do not provide a method implementation, so their method bodies simply consist of a semicolon. For any other method, the method body is a block (<hyperlink>15.2</hyperlink>) that contains the statements to execute when that method is invoked. </paragraph>
   5   <paragraph>When the return type of a method is <keyword>void</keyword>, return statements (<hyperlink>15.9.4</hyperlink>) in that method's body are not permitted to specify an expression. If execution of the method body of a <keyword>void</keyword> method completes normally (that is, control flows off the end of the method body), that method simply returns to its caller. </paragraph>
   6   <paragraph>When the return type of a method is not <keyword>void</keyword>, each return statement in that method body must specify an expression of a type that is implicitly convertible to the return type. The endpoint of the method body of a value-returning method must not be reachable. In other words, in a value-returning method, control is not permitted to flow off the end of the method body. </paragraph>
   7   <paragraph>
   8     <example>[Example: In the example <code_example><![CDATA[
   9 class A
  10 {
  11    public int F() {}     // Error, return value required
  12    public int G() {
  13       return 1;
  14    }
  15    public int H(bool b) {
  16       if (b) {
  17          return 1;
  18       }
  19       else {
  20          return 0;
  21       }
  22    }
  23 }
  24 ]]></code_example>the value-returning F method results in a compile-time error because control can flow off the end of the method body. The G and H methods are correct because all possible execution paths end in a return statement that specifies a return value. end example]</example>
  25   </paragraph>
  26 </clause>