<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<root>

<name>try</name>

<category>Structure</category>

<subcategory></subcategory>

<usage>Web &amp; Application</usage>

<example>

<image></image>

<code><![CDATA[

BufferedReader reader;

String line;

void setup() {

// Open the file from the createWriter() example

reader = createReader("positions.txt");

}

void draw() {

try {

line = reader.readLine();

} catch (IOException e) {

e.printStackTrace();

line = null;

}

if (line == null) {

// Stop reading because of an error or file is empty

noLoop();

} else {

String[] pieces = split(line, TAB);

int x = int(pieces[0]);

int y = int(pieces[1]);

point(x, y);

}

}

]]></code>

</example>

<description><![CDATA[

The <b>try</b> keyword is used with <b>catch</b> to handle exceptions. Sun's Java documentation defines an exception as "an event, which occurs during the execution of a program, that disrupts the normal flow of the program's instructions." This could be, for example, an error while a file is read.

]]></description>

<syntax>

try {

tryStatements

} catch (<c>exception</c>) {

catchStatements

}

</syntax>

<parameter>

<label>tryStatements</label>

<description><![CDATA[if this code throws an exception, then the code in "catch" is run]]></description>

</parameter>

<parameter>

<label>exception</label>

<description><![CDATA[the Java exception that was thrown]]></description>

</parameter>

<parameter>

<label>catchStatements</label>

<description><![CDATA[code that handles the exception]]></description>

</parameter>

<returns></returns>

<related></related>

<availability>1.0</availability>

<type>Keyword</type>

<partof>PDE</partof>

</root>