javachk

Error message based on Java feature support

collapse all in page

Syntax

MSG = javachk(feature)
javachk(feature,component)

Description

MSG = javachk(feature) returns a generic error message if the specified Java® feature is not available in the current MATLAB® session.

example

javachk(feature,component) also names the specified component in the error message.

example

Examples

collapse all

To test if Java is available before calling a Java command, use these statements. The isempty function is true when there is no error.

if isempty(javachk('jvm'))
   scalar = java.lang.Double(5);
end

To provide context in the javachk error message, add the optional text parameter to the javachk function.

Create a script, myFile.m, with the following statements. The script checks if Java is available before calling Java to create a frame.

error(javachk('awt','myFile'))
myFrame = java.awt.Frame;
myFrame.setVisible(1)

Start MATLAB from the Linux® system prompt.

matlab -nojvm

Run the script.

myFile

If Java is not available, then MATLAB displays this error, identifying the source as the myFile script.

Error using myFile (line 1)
myFile is not supported because:
Java is not currently available.

Input Arguments

collapse all

Java feature, specified as one of these values.

'awt'

UI components in the Java Abstract Window Toolkit (AWT) are available.

'desktop'

MATLAB interactive desktop is running. For more information, see desktop option will not be supported.

'jvm'

Java Virtual Machine software (JVM®) is available.

'swing'

Swing components (Java lightweight UI components in the Java Foundation Classes) are available.

Identifier, specified as a string or a character vector, to display in the error message.

Data Types: string | char

Output Arguments

collapse all

Error message, returned as a structure with the following fields. If the feature is available, javachk returns an error structure with empty fields.

Message, specified as a character vector.

Identifier, specified as a character vector.

Version History

Introduced before R2006a

expand all

See Also

|