View Javadoc
1   package org.metricshub.jawk.jrt;
2   
3   /*-
4    * ╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲
5    * Jawk
6    * ჻჻჻჻჻჻
7    * Copyright (C) 2006 - 2025 MetricsHub
8    * ჻჻჻჻჻჻
9    * This program is free software: you can redistribute it and/or modify
10   * it under the terms of the GNU Lesser General Public License as
11   * published by the Free Software Foundation, either version 3 of the
12   * License, or (at your option) any later version.
13   *
14   * This program is distributed in the hope that it will be useful,
15   * but WITHOUT ANY WARRANTY; without even the implied warranty of
16   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17   * GNU General Lesser Public License for more details.
18   *
19   * You should have received a copy of the GNU General Lesser Public
20   * License along with this program.  If not, see
21   * <http://www.gnu.org/licenses/lgpl-3.0.html>.
22   * ╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱
23   */
24  
25  /**
26   * A runtime exception thrown by Jawk. It is provided
27   * to conveniently distinguish between Jawk runtime
28   * exceptions and other runtime exceptions.
29   *
30   * @author Danny Daglas
31   */
32  public class AwkRuntimeException extends RuntimeException {
33  
34  	private static final long serialVersionUID = 1L;
35  
36  	private final int lineNumber;
37  
38  	/**
39  	 * <p>
40  	 * Constructor for AwkRuntimeException.
41  	 * </p>
42  	 *
43  	 * @param msg a {@link java.lang.String} object
44  	 */
45  	public AwkRuntimeException(String msg) {
46  		super(msg);
47  		this.lineNumber = -1;
48  	}
49  
50  	public AwkRuntimeException(String msg, Throwable cause) {
51  		super(msg, cause);
52  		this.lineNumber = -1;
53  	}
54  
55  	/**
56  	 * <p>
57  	 * Constructor for AwkRuntimeException.
58  	 * </p>
59  	 *
60  	 * @param lineno a int
61  	 * @param msg a {@link java.lang.String} object
62  	 */
63  	public AwkRuntimeException(int lineno, String msg) {
64  		super(msg);
65  		this.lineNumber = lineno;
66  	}
67  
68  	public AwkRuntimeException(int lineno, String msg, Throwable cause) {
69  		super(msg, cause);
70  		this.lineNumber = lineno;
71  	}
72  
73  	/**
74  	 * Returns the line number associated with this exception or {@code -1} if
75  	 * unavailable.
76  	 *
77  	 * @return the offending line number or {@code -1}
78  	 */
79  	public int getLineNumber() {
80  		return lineNumber;
81  	}
82  }