﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- saved from url=(0014)about:internet -->
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta name="book" content="ActionScript&nbsp;3.0&nbsp;Language&nbsp;and&nbsp;Components&nbsp;Reference"><link rel="stylesheet" href="style.css" type="text/css" media="screen"><link rel="stylesheet" href="print.css" type="text/css" media="print"><link rel="stylesheet" href="override.css" type="text/css"><title>Top Level Constants and Functions Details (ActionScript 3.0)</title></head><body><script language="javascript" type="text/javascript" src="asdoc.js"></script><script language="javascript" type="text/javascript" src="help.js"></script><script language="javascript" type="text/javascript" src="cookies.js"></script><script language="javascript" type="text/javascript">  
            <!--  
			    
				asdocTitle = 'Top Level Constants and Functions - ActionScript 3.0 Language and Components Reference';

				var baseRef = '';

				window.onload = configPage;
			      
			    -->  
            </script>
<script language="javascript" type="text/javascript"><!--
function submitValue(){
var searchStr=document.getElementById('search-livedocs').value;
window.location="search.html"+"###"+searchStr;
}
--></script><script type="text/javascript">
		scrollToNameAnchor();
	</script><table class="titleTable" cellpadding="0" cellspacing="0" id="titleTable" style="display:none"><tr><td class="titleTableTitle" align="left">ActionScript 3.0 Language and Components Reference</td><td class="titleTableSearch" align="center"><form class="searchForm" method="get" action="search.html" onsubmit="submitValue();"><input class="hidden" name="loc" value="" type="hidden"><input class="hidden" name="termPrefix" value="" type="hidden"><input class="hidden" name="term" value="" type="hidden"><input class="hidden" name="area" value="" type="hidden"><input id="search-livedocs" name="search_text" value="" title="" type="text"> <input type="button" name="action" value="Search" onclick="submitValue()"></form></td><td class="titleTableTopNav" align="right"><a href="../../Flash/10.0_Welcome/index.html">Home</a>&nbsp;|&nbsp;<a href="package-summary.html" onclick="loadClassListFrame('all-classes.html')">All Packages</a>&nbsp;|&nbsp;<a href="class-summary.html" onclick="loadClassListFrame('all-classes.html')">All Classes</a>&nbsp;|&nbsp;<a href="language-elements.html">Language Elements</a>&nbsp;| <a href="all-index-Symbols.html" onclick="loadClassListFrame('index-list.html')">Index</a>&nbsp;|&nbsp;<a href="appendixes.html">Appendixes</a>&nbsp;|&nbsp;<a href="conventions.html">Conventions</a>&nbsp;|&nbsp;<a id="framesLink1" href="index.html?package.html&amp;class-list.html">Frames</a><a id="noFramesLink1" style="display:none" href="" onclick="parent.location=document.location"> No Frames </a></td><td class="titleTableLogo" align="right" rowspan="3"><img src="images/logo.jpg" class="logoImage" alt=" Adobe Logo " title=" Adobe Logo "></td></tr><tr class="titleTableRow2"><td class="titleTableSubTitle" id="subTitle" align="left">Top Level</td><td class="titleTableSubNav" id="subNav" align="right" colspan="2"><a href="package.html#methodSummary">Functions</a>&nbsp;| <a href="package.html#constantSummary">Constants</a></td></tr><tr class="titleTableRow3"><td colspan="3">&nbsp;</td></tr></table><script language="javascript" type="text/javascript" xml:space="preserve">
                
                    
                

				<!--

				
				    
				

					if (!isEclipse() || window.name != ECLIPSE_FRAME_NAME) {titleBar_setSubTitle("Top Level"); titleBar_setSubNav(false,false,false	,false,false,false,false,false,true	,false,true,false,false,false);}

				    
				        
				    
				-->
                
                    
                
			</script><div class="MainContent"><br><a name="methodSummary"></a>Top level or global functions are available in any part of a SWF file where ActionScript is used, or in any user-defined class. Most of the global functions from ActionScript 2.0 have been migrated into classes.<div class="summarySection"><div class="summaryTableTitle">Global Methods </div><table cellspacing="0" cellpadding="3" class="summaryTable " id="summaryTableMethod"><tr><th>&nbsp;</th><th colspan="2">Function</th><th>Defined By</th></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#Array()" class="signatureLink">Array</a>(<a href="statements.html#..._(rest)_parameter">...</a> args):<a href="Array.html">Array</a></div><div class="summaryTableDescription">Creates a new array.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#Boolean()" class="signatureLink">Boolean</a>(expression:<a href="Object.html">Object</a>):<a href="Boolean.html">Boolean</a></div><div class="summaryTableDescription">Converts the expression parameter to a Boolean value and returns the value.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#decodeURI()" class="signatureLink">decodeURI</a>(uri:<a href="String.html">String</a>):<a href="String.html">String</a></div><div class="summaryTableDescription">Decodes an encoded URI into a string.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#decodeURIComponent()" class="signatureLink">decodeURIComponent</a>(uri:<a href="String.html">String</a>):<a href="String.html">String</a></div><div class="summaryTableDescription">Decodes an encoded URI component into a string.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#encodeURI()" class="signatureLink">encodeURI</a>(uri:<a href="String.html">String</a>):<a href="String.html">String</a></div><div class="summaryTableDescription">Encodes a string into a valid URI (Uniform Resource Identifier).</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#encodeURIComponent()" class="signatureLink">encodeURIComponent</a>(uri:<a href="String.html">String</a>):<a href="String.html">String</a></div><div class="summaryTableDescription">Encodes a string into a valid URI component.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#escape()" class="signatureLink">escape</a>(str:<a href="String.html">String</a>):<a href="String.html">String</a></div><div class="summaryTableDescription">Converts the parameter to a string and encodes it in a URL-encoded format, 
  where most nonalphanumeric characters are replaced with % hexadecimal sequences.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#int()" class="signatureLink">int</a>(value:<a href="Number.html">Number</a>):<a href="int.html">int</a></div><div class="summaryTableDescription">Converts a given numeric value to an integer value.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#isFinite()" class="signatureLink">isFinite</a>(num:<a href="Number.html">Number</a>):<a href="Boolean.html">Boolean</a></div><div class="summaryTableDescription">Returns true if the value is a finite number, 
  or false if the value is Infinity or -Infinity.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#isNaN()" class="signatureLink">isNaN</a>(num:<a href="Number.html">Number</a>):<a href="Boolean.html">Boolean</a></div><div class="summaryTableDescription">Returns true if the value is NaN(not a number).</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#isXMLName()" class="signatureLink">isXMLName</a>(str:<a href="String.html">String</a>):<a href="Boolean.html">Boolean</a></div><div class="summaryTableDescription">Determines whether the specified string is a valid name for an XML element or attribute.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#Number()" class="signatureLink">Number</a>(expression:<a href="Object.html">Object</a>):<a href="Number.html">Number</a></div><div class="summaryTableDescription">Converts a given value to a Number value.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#Object()" class="signatureLink">Object</a>(value:<a href="Object.html">Object</a>):<a href="Object.html">Object</a></div><div class="summaryTableDescription">Every value in ActionScript 3.0 is an object, which means that calling Object() on a value returns that value.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#parseFloat()" class="signatureLink">parseFloat</a>(str:<a href="String.html">String</a>):<a href="Number.html">Number</a></div><div class="summaryTableDescription">Converts a string to a floating-point number.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#parseInt()" class="signatureLink">parseInt</a>(str:<a href="String.html">String</a>, radix:<a href="uint.html">uint</a> = 0):<a href="Number.html">Number</a></div><div class="summaryTableDescription">Converts a string to an integer.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#String()" class="signatureLink">String</a>(expression:<a href="Object.html">Object</a>):<a href="String.html">String</a></div><div class="summaryTableDescription">Returns a string representation of the specified parameter.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#trace()" class="signatureLink">trace</a>(<a href="statements.html#..._(rest)_parameter">...</a> arguments):<a href="specialTypes.html#void">void</a></div><div class="summaryTableDescription">Displays expressions, or writes to log files, while debugging.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#uint()" class="signatureLink">uint</a>(value:<a href="Number.html">Number</a>):<a href="uint.html">uint</a></div><div class="summaryTableDescription">Converts a given numeric value to an unsigned integer value.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#unescape()" class="signatureLink">unescape</a>(str:<a href="String.html">String</a>):<a href="String.html">String</a></div><div class="summaryTableDescription">Evaluates the parameter str as a string, decodes the string from URL-encoded format 
  (converting all hexadecimal sequences to ASCII characters), and returns the string.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#Vector()" class="signatureLink">Vector</a>(sourceArray:<a href="Object.html">Object</a>):<a href="Vector.html">Vector</a>.&lt;T&gt;</div><div class="summaryTableDescription">Creates a new Vector instance whose elements are instances of the specified data type.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#XML()" class="signatureLink">XML</a>(expression:<a href="Object.html">Object</a>):<a href="XML.html">XML</a></div><div class="summaryTableDescription">Converts an object to an XML object.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><div class="summarySignature"><a href="#XMLList()" class="signatureLink">XMLList</a>(expression:<a href="Object.html">Object</a>):<a href="XMLList.html">XMLList</a></div><div class="summaryTableDescription">Converts an object to an XMLList object.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr></table></div><br><br><a name="constantSummary"></a>Top level or global constants are available in every script, and are visible to every Timeline and scope in your document.<div class="summarySection"><div class="summaryTableTitle">Global Constants</div><table cellspacing="0" cellpadding="3" class="summaryTable " id="summaryTableConstant"><tr><th>&nbsp;</th><th colspan="2">Constant</th><th>Defined By</th></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><a href="#Infinity" class="signatureLink">Infinity</a> : <a href="Number.html">Number</a><div class="summaryTableDescription">A special value representing positive Infinity.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><a href="#-Infinity" class="signatureLink">-Infinity</a> : <a href="Number.html">Number</a><div class="summaryTableDescription">A special value representing negative Infinity.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><a href="#NaN" class="signatureLink">NaN</a> : <a href="Number.html">Number</a><div class="summaryTableDescription">A special member of the Number data type that represents a value that is "not a number" (NaN).</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr><tr class=""><td class="summaryTablePaddingCol">&nbsp;</td><td class="summaryTableInheritanceCol">&nbsp;</td><td class="summaryTableSignatureCol"><a href="#undefined" class="signatureLink">undefined</a> : <a href="specialTypes.html#*">*</a><div class="summaryTableDescription">A special value that applies to untyped variables that have not been initialized or dynamic object properties that are not initialized.</div></td><td class="summaryTableOwnerCol">Top&nbsp;Level</td></tr></table></div><div class="detailSectionHeader"> Constant Detail </div><a name="constantDetail"></a><a name="Infinity"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">Infinity</td><td class="detailHeaderType">Constant</td></tr></table><div class="detailBody"><code>public const Infinity:<a href="Number.html">Number</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        A special value representing positive
        <code>Infinity</code>
        . The value of this constant is the same as
        <code>Number.POSITIVE_INFINITY</code>
        .
      </p><p><span class="label">See also</span></p><div class="seeAlso"><a href="Number.html#POSITIVE_INFINITY" target="">Number.POSITIVE_INFINITY</a></div><br/><span class="label"> Example </span><br/><br/><div class="detailBody">
        The result of division by 0 is
        <code>Infinity</code>
        , but only 
 when the divisor is a positive number.
        <div class="listing"><pre>trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity</pre></div>
      </div></div><a name="constantDetail"></a><a name="-Infinity"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">-Infinity</td><td class="detailHeaderType">Constant</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code>public const -Infinity:<a href="Number.html">Number</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        A special value representing negative
        <code>Infinity</code>
        . The value of this constant is the same as
        <code>Number.NEGATIVE_INFINITY</code>
        .
      </p><p><span class="label">See also</span></p><div class="seeAlso"><a href="Number.html#NEGATIVE_INFINITY" target="">Number.NEGATIVE_INFINITY</a></div><br/><span class="label"> Example </span><br/><br/><div class="detailBody">
        The result of division by 0 is
        <code>-Infinity</code>
        , but only 
 when the divisor is a negative number.
        <div class="listing"><pre>trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity</pre></div>
      </div></div><a name="constantDetail"></a><a name="NaN"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">NaN</td><td class="detailHeaderType">Constant</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code>public const NaN:<a href="Number.html">Number</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        A special member of the Number data type that represents a value that is "not a number" (
        <code>NaN</code>
        ). 
 When a mathematical expression results in a value that cannot be expressed as a number, the result is
        <code>NaN</code>
        .
 The following list describes common expressions that result in
        <code>NaN</code>
        .
        <ul><li>
            Division by 0 results in
            <code>NaN</code>
            only if the divisor is also 0. If the divisor is greater than 0, division by 0 results in
            <code>
              <code>Infinity</code>
            </code>
            . If the divisor is less than 0,  division by 0 results in
            <code>
              <code>-Infinity</code>
            </code>
            ;
          </li><li>Square root of a negative number;</li><li>The arcsine of a number outside the valid range of 0 to 1;</li><li>
            <code>Infinity</code>
            subtracted from
            <code>Infinity</code>
            ;
          </li><li>
            <code>Infinity</code>
            or
            <code>-Infinity</code>
            divided by
            <code>Infinity</code>
            or
            <code>-Infinity</code>
            ;
          </li><li>
            <code>Infinity</code>
            or
            <code>-Infinity</code>
            multiplied by 0;
          </li></ul>
        
        <p>
          The
          <code>NaN</code>
          value is not a member of the int or uint data types.
        </p>
        
        <p>
          The
          <code>NaN</code>
          value is not considered equal to any other value, including
          <code>NaN</code>
          , which makes it impossible to use the equality operator to test whether an expression is
          <code>NaN</code>
          . To determine whether a number is the
          <code>NaN</code>
          function, use
          <code>isNaN()</code>
          .
        </p>
        
      </p><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#isNaN()" target="">isNaN()</a><br/><a href="Number.html#NaN" target="">Number.NaN</a></div></div><a name="constantDetail"></a><a name="undefined"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">undefined</td><td class="detailHeaderType">Constant</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code>public const undefined:<a href="specialTypes.html#*">*</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        A special value that applies to untyped variables that have not been initialized or dynamic object properties that are not initialized.
 In ActionScript 3.0, only variables that are untyped can hold the value
        <code>undefined</code>
        ,
 which is not true in ActionScript 1.0 and ActionScript 2.0.
 For example, both of the following variables are
        <code>undefined</code>
        because they are untyped and unitialized:
        <ul><li>
            <code>var foo;</code>
          </li><li>
            <code>var bar:*;</code>
          </li></ul>
        
        <p>
          The
          <code>undefined</code>
          value also applies to uninitialized or undefined properties of dynamic objects.
 For example, if an object is an instance of the Object class, 
 the value of any dynamically added property is
          <code>undefined</code>
          until a value is assigned to that property.
        </p>
        
        <p>
          Results vary when
          <code>undefined</code>
          is used with various functions:
        </p>
        
        <ul><li>
            The value returned by
            <code>String(undefined)</code>
            is
            <code>"undefined"</code>
            (
            <code>undefined</code>
            is
 converted to a string).
          </li><li>
            The value returned by
            <code>Number(undefined)</code>
            is
            <code>NaN</code>
            .
          </li><li>
            The value returned by
            <code>int(undefined)</code>
            and
            <code>uint(undefined)</code>
            is 0.
          </li><li>
            The value returned by
            <code>Object(undefined)</code>
            is a new Object instance.
          </li><li>
            When the value
            <code>undefined</code>
            is assigned to a typed variable, 
 the value is converted to the default value of the data type.
          </li></ul>
        
        <p>
          Do not confuse
          <code>undefined</code>
          with
          <code>null</code>
          .
 When
          <code>null</code>
          and
          <code>undefined</code>
          are compared with the equality
 (
          <code>==</code>
          ) operator, they compare as equal. However, when
          <code>null</code>
          and
          <code>undefined</code>
          are
 compared with the strict equality (
          <code>===</code>
          ) operator, they compare
 as not equal.
        </p>
        
      </p><p><span class="label">See also</span></p><div class="seeAlso"><a href="statements.html#null" target="">null</a></div><br/><span class="label"> Example </span><br/><br/><div class="detailBody">
        In the following example, an untyped variable,
        <code>myVar</code>
        is declared but not initialized.
 The value of
        <code>myVar</code>
        is
        <code>undefined</code>
        because the variable is untyped.
 This is true whether the variable has no type annotation or uses the special (*) untyped annotation (
        <code>var myVar:*;</code>
        ).
        <div class="listing"><pre>// trace value of untyped and uninitialized variable
var myVar;
trace(myVar); // undefined</pre></div>
      </div><br/><div class="detailBody">
        The same rule applies to uninitialized properties of a dynamic object. For example, given an instance,
        <code>obj</code>
        , of the
 dynamic class
        <code>A</code>
        , the value of
        <code>obj.propName</code>
        , which is an uninitialized 
 property of the
        <code>obj</code>
        instance, is
        <code>undefined</code>
        .
        <div class="listing"><pre>dynamic class A {}
var obj:A = new A()

// trace undefined property of obj
trace(obj.propName); // undefined</pre></div>
      </div></div><a name="methodDetail"></a><div class="detailSectionHeader"> Function detail </div><a name="Array()"></a><a name="Array(restParam)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">Array</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td></tr></table><div class="detailBody"><code> public function Array(<a href="statements.html#..._(rest)_parameter">...</a> args):<a href="Array.html">Array</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Creates a new array. The array can be of length zero or more, or an array populated by a list of 
  specified elements, possibly of different data types. The number and data type of
  the arguments you use determine the contents of the returned array.
        <ul><li>
            Calling
            <code>Array()</code>
            with no arguments returns an empty array.
          </li><li>
            Calling
            <code>Array()</code>
            with a single integer argument returns an array of the specified length, but whose elements have undefined values.
          </li><li>
            Calling
            <code>Array()</code>
            with a list of specific values returns an array with elements that contain each of the specified values.
          </li></ul>
        Using the
        <code>Array()</code>
        function is similar to creating an array with the Array class constructor.
        <p>
          Use the
          <code>as</code>
          operator for explicit type conversion, or type casting, 
  when the argument is not a primitive value. For more information, see the Example
  section of this entry.
        </p>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><a href="statements.html#..._(rest)_parameter">...</a> <span class="label">args</span></code> &mdash; You can pass no arguments for an empty array, a single integer argument for an array of a specific length, or a series of comma-separated values of various types for an array populated with those values.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Array.html">Array</a></code> &mdash; An array of length zero or more.</td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="Array.html" target="">Array class</a><br/><a href="operators.html#as" target="">as operator</a></div><br/><span class="label"> Example </span><br/><br/><div class="detailBody">
        The following example demonstrates the behavior of the
        <code>Array()</code>
        function when an argument is not a primitive value. A common use case of casting to an array
 is the conversion of an Object instance that stores its values in array format. 
 If
        <code>Array()</code>
        is called with an argument of type
        <code>Object</code>
        ,
 or any other non-primitive data type, a reference to the object is stored in an element
 of the new array. In other words, if the only argument passed is an object, 
 a reference to that object becomes the first element of the new array.
        <div class="listing"><pre>var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = Array( obj );

trace(newArray == obj);    // false
trace(newArray[0] == obj); // true
trace(newArray[0][0])      // a
trace(newArray[0][1])      // b
trace(newArray[0][2])      // c</pre></div>
      </div><br/><div class="detailBody">
        To cast
        <code>obj</code>
        to an array, use the
        <code>as</code>
        operator, which returns an array reference
 if
        <code>obj</code>
        is a valid array and
        <code>null</code>
        otherwise:
        <div class="listing"><pre>var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = obj as Array;

trace(newArray == obj); // true
trace(newArray[0]);     // a
trace(newArray[1]);     // b
trace(newArray[2]);     // c</pre></div>
      </div></div><a name="Boolean()"></a><a name="Boolean(Object)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">Boolean</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function Boolean(expression:<a href="Object.html">Object</a>):<a href="Boolean.html">Boolean</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Converts the
        <code>expression</code>
        parameter to a Boolean value and returns the value.
        <p>The return value depends on the data type and value of the argument, as described in the following table:</p>
        
        <table class="innertable" ><tr><th>Input Value</th><th>Example</th><th>Return Value</th></tr><tr><td>
                  <code>0</code>
                </td><td>
                  <code>Boolean(0)</code>
                </td><td>
                  <code>false</code>
                </td></tr><tr><td>
                  <code>NaN</code>
                </td><td>
                  <code>Boolean(NaN)</code>
                </td><td>
                  <code>false</code>
                </td></tr><tr><td>
                  Number (not
                  <code>0</code>
                  or
                  <code>NaN</code>
                  )
                </td><td>
                  <code>Boolean(4)</code>
                </td><td>
                  <code>true</code>
                </td></tr><tr><td>Empty string</td><td>
                  <code>Boolean("")</code>
                </td><td>
                  <code>false</code>
                </td></tr><tr><td>Non-empty string</td><td>
                  <code>Boolean("6")</code>
                </td><td>
                  <code>true</code>
                </td></tr><tr><td>
                  <code>null</code>
                </td><td>
                  <code>Boolean(null)</code>
                </td><td>
                  <code>false</code>
                </td></tr><tr><td>
                  <code>undefined</code>
                </td><td>
                  <code>Boolean(undefined)</code>
                </td><td>
                  <code>false</code>
                </td></tr><tr><td>Instance of Object class</td><td>
                  <code>Boolean(new Object())</code>
                </td><td>
                  <code>true</code>
                </td></tr><tr><td>No argument</td><td>
                  <code>Boolean()</code>
                </td><td>
                  <code>false</code>
                </td></tr></table>
        
        <p>
          Unlike previous versions of ActionScript, the
          <code>Boolean()</code>
          function returns the same results as does the Boolean class constructor.
        </p>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">expression</span>:<a href="Object.html">Object</a></code> &mdash; An expression or object to convert to Boolean.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Boolean.html">Boolean</a></code> &mdash; The result of the conversion to Boolean.</td></tr></table></div><a name="decodeURI()"></a><a name="decodeURI(String)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">decodeURI</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function decodeURI(uri:<a href="String.html">String</a>):<a href="String.html">String</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Decodes an encoded URI into a string. Returns a string in which all characters previously encoded 
  by the
        <code>encodeURI</code>
        function are restored to their unencoded representation.
        <p>
          The following table shows the set of escape sequences that are
          <i>not</i>
          decoded to characters by the
          <code>decodeURI</code>
          function. Use
          <code>decodeURIComponent()</code>
          to decode the escape sequences in this table.
        </p>
        
        <table class="innertable" ><tr><th>Escape sequences not decoded</th><th>Character equivalents</th></tr><tr><td>
                  <code>%23</code>
                </td><td>
                  <code>#</code>
                </td></tr><tr><td>
                  <code>%24</code>
                </td><td>
                  <code>$</code>
                </td></tr><tr><td>
                  <code>%26</code>
                </td><td>
                  <code>&</code>
                </td></tr><tr><td>
                  <code>%2B</code>
                </td><td>
                  <code>+</code>
                </td></tr><tr><td>
                  <code>%2C</code>
                </td><td>
                  <code>,</code>
                </td></tr><tr><td>
                  <code>%2F</code>
                </td><td>
                  <code>/</code>
                </td></tr><tr><td>
                  <code>%3A</code>
                </td><td>
                  <code>:</code>
                </td></tr><tr><td>
                  <code>%3B</code>
                </td><td>
                  <code>;</code>
                </td></tr><tr><td>
                  <code>%3D</code>
                </td><td>
                  <code>=</code>
                </td></tr><tr><td>
                  <code>%3F</code>
                </td><td>
                  <code>?</code>
                </td></tr><tr><td>
                  <code>%40</code>
                </td><td>
                  <code>@</code>
                </td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">uri</span>:<a href="String.html">String</a></code> &mdash; 
            A string encoded with the
            <code>encodeURI</code>
            function.
          </td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="String.html">String</a></code> &mdash; 
            A string in which all characters previously escaped by the
            <code>encodeURI</code>
            function are
  restored to their unescaped representation.
          </td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#decodeURIComponent()" target="">decodeURIComponent()</a><br/><a href="package.html#encodeURI()" target="">encodeURI()</a><br/><a href="package.html#encodeURIComponent()" target="">encodeURIComponent()</a></div><br/><span class="label"> Example </span><br/><br/><div class="detailBody">
        <div class="listing"><pre>package {
    import flash.display.Sprite;

    public class DecodeURIExample extends Sprite {
        public function DecodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=&lt;user name='some user'&gt;&lt;/user&gt;";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=&lt;user name='some user'&gt;&lt;/user&gt;
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=&lt;user name='some user'&gt;&lt;/user&gt;
        }
    }
}</pre></div>
      </div></div><a name="decodeURIComponent()"></a><a name="decodeURIComponent(String)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">decodeURIComponent</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function decodeURIComponent(uri:<a href="String.html">String</a>):<a href="String.html">String</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Decodes an encoded URI component into a string. Returns a string in which 
  all characters previously escaped by the
        <code>encodeURIComponent</code>
        function are restored to their uncoded representation.
        <p>
          This function differs from the
          <code>decodeURI()</code>
          function in that it is intended for use only with a part of a URI string, called a URI component.
  A URI component is any text that appears between special characters called
          <i>component separators</i>
          (
          <code>: / ; and ?</code>
          ). 
  Common examples of a URI component are "http" and "www.adobe.com".
        </p>
        
        <p>
          Another important difference between this function and
          <code>decodeURI()</code>
          is that because this function
  assumes that it is processing a URI component it treats the escape sequences that represent special separator characters (
          <code>; / ? : @ & = + $ , #</code>
          ) as regular
  text that should be decoded.
        </p>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">uri</span>:<a href="String.html">String</a></code> &mdash; 
            A string encoded with the
            <code>encodeURIComponent</code>
            function.
          </td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="String.html">String</a></code> &mdash; 
            A string in which all characters previously escaped by the
            <code>encodeURIComponent</code>
            function are
  restored to their unescaped representation.
          </td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#decodeURI()" target="">decodeURI()</a><br/><a href="package.html#encodeURI()" target="">encodeURI()</a><br/><a href="package.html#encodeURIComponent()" target="">encodeURIComponent()</a></div></div><a name="encodeURI()"></a><a name="encodeURI(String)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">encodeURI</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function encodeURI(uri:<a href="String.html">String</a>):<a href="String.html">String</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Encodes a string into a valid URI (Uniform Resource Identifier). 
  Converts a complete URI into a string in which all characters are encoded 
  as UTF-8 escape sequences unless a character belongs to a small group of basic characters.
        <p>
          The following table shows the entire set of basic characters that are
          <i>not</i>
          converted to UTF-8 escape sequences by the
          <code>encodeURI</code>
          function.
        </p>
        
        <table class="innertable" ><tr><th>Characters not encoded</th></tr><tr><td>
                  <code>0 1 2 3 4 5 6 7 8 9</code>
                </td></tr><tr><td>
                  <code>a b c d e f g h i j k l m n o p q r s t u v w x y z</code>
                </td></tr><tr><td>
                  <code>A B C D E F G H I J K L M N O P Q R S T U V W X Y Z</code>
                </td></tr><tr><td>
                  <code>; / ? : @ & = + $ , #</code>
                </td></tr><tr><td>
                  <code>- _ . ! ~ * ' ( )</code>
                </td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">uri</span>:<a href="String.html">String</a></code> &mdash; A string representing a complete URI.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="String.html">String</a></code> &mdash; A string with certain characters encoded as UTF-8 escape sequences.</td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#decodeURI()" target="">decodeURI()</a><br/><a href="package.html#decodeURIComponent()" target="">decodeURIComponent()</a><br/><a href="package.html#encodeURIComponent()" target="">encodeURIComponent()</a></div><br/><span class="label"> Example </span><br/><br/><div class="detailBody">
        <div class="listing"><pre>package {
    import flash.display.Sprite;

    public class EncodeURIExample extends Sprite {
        public function EncodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=&lt;user name='some user'&gt;&lt;/user&gt;";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=&lt;user name='some user'&gt;&lt;/user&gt;
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=&lt;user name='some user'&gt;&lt;/user&gt;
        }
    }
}</pre></div>
      </div></div><a name="encodeURIComponent()"></a><a name="encodeURIComponent(String)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">encodeURIComponent</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function encodeURIComponent(uri:<a href="String.html">String</a>):<a href="String.html">String</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Encodes a string into a valid URI component. Converts a substring of a URI into a 
  string in which all characters are encoded as UTF-8 escape sequences unless a character
  belongs to a very small group of basic characters.
        <p>
          The
          <code>encodeURIComponent()</code>
          function differs from the
          <code>encodeURI()</code>
          function in that it is intended for use only with a part of a URI string, called a URI component.
  A URI component is any text that appears between special characters called
          <i>component separators</i>
          (
          <code>: / ; and ?</code>
          ). 
  Common examples of a URI component are "http" and "www.adobe.com".
        </p>
        
        <p>
          Another important difference between this function and
          <code>encodeURI()</code>
          is that because this function
  assumes that it is processing a URI component it treats the special separator characters (
          <code>; / ? : @ & = + $ , #</code>
          ) as regular
  text that should be encoded.
        </p>
        
        <p>
          The following table shows all characters that are
          <i>not</i>
          converted to UTF-8 escape sequences by the
          <code>encodeURIComponent</code>
          function.
        </p>
        
        <table class="innertable" ><tr><th>Characters not encoded</th></tr><tr><td>
                  <code>0 1 2 3 4 5 6 7 8 9</code>
                </td></tr><tr><td>
                  <code>a b c d e f g h i j k l m n o p q r s t u v w x y z</code>
                </td></tr><tr><td>
                  <code>A B C D E F G H I J K L M N O P Q R S T U V W X Y Z</code>
                </td></tr><tr><td>
                  <code>- _ . ! ~ * ' ( )</code>
                </td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">uri</span>:<a href="String.html">String</a></code></td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="String.html">String</a></code></td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#decodeURI()" target="">decodeURI()</a><br/><a href="package.html#decodeURIComponent()" target="">decodeURIComponent()</a><br/><a href="package.html#encodeURI()" target="">encodeURI()</a></div></div><a name="escape()"></a><a name="escape(String)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">escape</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function escape(str:<a href="String.html">String</a>):<a href="String.html">String</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Converts the parameter to a string and encodes it in a URL-encoded format, 
  where most nonalphanumeric characters are replaced with
        <code>%</code>
        hexadecimal sequences. 
  When used in a URL-encoded string, the percentage symbol (
        <code>%</code>
        ) is used to introduce 
  escape characters, and is not equivalent to the modulo operator (
        <code>%</code>
        ).
        <p>
          The following table shows all characters that are
          <i>not</i>
          converted to escape sequences by the
          <code>escape()</code>
          function.
        </p>
        
        <table class="innertable" ><tr><th>Characters not encoded</th></tr><tr><td>
                  <code>0 1 2 3 4 5 6 7 8 9</code>
                </td></tr><tr><td>
                  <code>a b c d e f g h i j k l m n o p q r s t u v w x y z</code>
                </td></tr><tr><td>
                  <code>A B C D E F G H I J K L M N O P Q R S T U V W X Y Z</code>
                </td></tr><tr><td>
                  <code>@ - _ . * + /</code>
                </td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">str</span>:<a href="String.html">String</a></code> &mdash; The expression to convert into a string and encode in a URL-encoded format.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="String.html">String</a></code> &mdash; A URL-encoded string.</td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#unescape()" target="">unescape()</a></div></div><a name="int()"></a><a name="int(Number)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">int</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function int(value:<a href="Number.html">Number</a>):<a href="int.html">int</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>Converts a given numeric value to an integer value. Decimal values are truncated at the decimal point.</p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">value</span>:<a href="Number.html">Number</a></code> &mdash; A value to be converted to an integer.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="int.html">int</a></code> &mdash; The converted integer value.</td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#uint()" target="">uint()</a></div></div><a name="isFinite()"></a><a name="isFinite(Number)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">isFinite</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function isFinite(num:<a href="Number.html">Number</a>):<a href="Boolean.html">Boolean</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0.</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Returns
        <code>true</code>
        if the value is a finite number, 
  or
        <code>false</code>
        if the value is
        <code>Infinity</code>
        or
        <code>-Infinity</code>
        .
  The presence of
        <code>Infinity</code>
        or
        <code>-Infinity</code>
        indicates a mathematical
  error condition such as division by 0.
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">num</span>:<a href="Number.html">Number</a></code> &mdash; A number to evaluate as finite or infinite.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Boolean.html">Boolean</a></code> &mdash; 
            Returns
            <code>true</code>
            if it is a finite number 
  or
            <code>false</code>
            if it is infinity or negative infinity
          </td></tr></table></div><a name="isNaN()"></a><a name="isNaN(Number)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">isNaN</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function isNaN(num:<a href="Number.html">Number</a>):<a href="Boolean.html">Boolean</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Returns
        <code>true</code>
        if the value is
        <code>NaN</code>
        (not a number). The
        <code>isNaN()</code>
        function is useful for checking whether a mathematical expression evaluates successfully to a number. 
  The most common use of
        <code>isNaN()</code>
        is to check the value returned from the
        <code>parseInt()</code>
        and
        <code>parseFloat()</code>
        functions. The
        <code>NaN</code>
        value is a special member of the Number data type that represents a value that is "not a number."
        <p>
          <b>Note</b>
          : The
          <code>NaN</code>
          value is not a member of the int or uint data types.
        </p>
        
        <p>
          The following table describes the return value of
          <code>isNaN()</code>
          on various input types and
  values. (If your compiler warnings are set to Strict Mode, some of the following operations will generate
  compiler warnings.)
        </p>
        
        <table class="innertable" ><tr><th>Input Type/Value</th><th>Example</th><th>Return Value</th></tr><tr><td>0 divided by 0</td><td>
                  <code>isNaN(0/0)</code>
                </td><td>
                  <code>true</code>
                </td></tr><tr><td>
                  Non-zero number divided by
                  <code>0</code>
                </td><td>
                  <code>isNaN(5/0)</code>
                </td><td>
                  <code>false</code>
                </td></tr><tr><td>Square root of a negative number</td><td>
                  <code>isNaN(Math.sqrt(-1))</code>
                </td><td>
                  <code>true</code>
                </td></tr><tr><td>Arcsine of number greater than 1 or less than 0</td><td>
                  <code>isNaN(Math.asin(2))</code>
                </td><td>
                  <code>true</code>
                </td></tr><tr><td>String that can be converted to Number</td><td>
                  <code>isNaN("5")</code>
                </td><td>
                  <code>false</code>
                </td></tr><tr><td>String that cannot be converted to Number</td><td>
                  <code>isNaN("5a")</code>
                </td><td>
                  <code>true</code>
                </td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">num</span>:<a href="Number.html">Number</a></code> &mdash; A numeric value or mathematical expression to evaluate.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Boolean.html">Boolean</a></code> &mdash; 
            Returns
            <code>true</code>
            if the value is
            <code>NaN</code>
            (not a number) and
            <code>false</code>
            otherwise.
          </td></tr></table></div><a name="isXMLName()"></a><a name="isXMLName(String)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">isXMLName</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function isXMLName(str:<a href="String.html">String</a>):<a href="Boolean.html">Boolean</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>Determines whether the specified string is a valid name for an XML element or attribute.</p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">str</span>:<a href="String.html">String</a></code> &mdash; A string to evaluate.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Boolean.html">Boolean</a></code> &mdash; 
            Returns
            <code>true</code>
            if the
            <code>str</code>
            argument is a valid XML name;
            <code>false</code>
            otherwise.
          </td></tr></table></div><a name="Number()"></a><a name="Number(Object)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">Number</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function Number(expression:<a href="Object.html">Object</a>):<a href="Number.html">Number</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Converts a given value to a Number value. The following table shows the result of various input types:
        <table class="innertable" ><tr><th>Input Type/Value</th><th>Example</th><th>Return Value</th></tr><tr><td>
                  <code>undefined</code>
                </td><td>
                  <code>Number(undefined)</code>
                </td><td>
                  <code>NaN</code>
                </td></tr><tr><td>
                  <code>null</code>
                </td><td>
                  <code>Number(null)</code>
                </td><td>
                  <code>0</code>
                </td></tr><tr><td>
                  <code>true</code>
                </td><td>
                  <code>Number(true)</code>
                </td><td>
                  <code>1</code>
                </td></tr><tr><td>
                  <code>false</code>
                </td><td>
                  <code>Number(false)</code>
                </td><td>
                  <code>0</code>
                </td></tr><tr><td>
                  <code>NaN</code>
                </td><td>
                  <code>Number(NaN)</code>
                </td><td>
                  <code>NaN</code>
                </td></tr><tr><td>Empty string</td><td>
                  <code>Number("")</code>
                </td><td>
                  <code>0</code>
                </td></tr><tr><td>String that converts to Number</td><td>
                  <code>Number("5")</code>
                </td><td>
                  The number (e.g.
                  <code>5</code>
                  )
                </td></tr><tr><td>String that does not convert to Number</td><td>
                  <code>Number("5a")</code>
                </td><td>
                  <code>NaN</code>
                </td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">expression</span>:<a href="Object.html">Object</a></code> &mdash; A value to be converted to a number.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Number.html">Number</a></code> &mdash; The converted number value</td></tr></table></div><a name="Object()"></a><a name="Object(Object)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">Object</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function Object(value:<a href="Object.html">Object</a>):<a href="Object.html">Object</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Every value in ActionScript 3.0 is an object, which means that calling
        <code>Object()</code>
        on a value returns that value.
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">value</span>:<a href="Object.html">Object</a></code> &mdash; An object or a number, string, or Boolean value to convert.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Object.html">Object</a></code> &mdash; 
            The value specified by the
            <code>value</code>
            parameter.
          </td></tr></table></div><a name="parseFloat()"></a><a name="parseFloat(String)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">parseFloat</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function parseFloat(str:<a href="String.html">String</a>):<a href="Number.html">Number</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Converts a string to a floating-point number. The function reads, or
        <i>parses</i>
        , and returns the numbers in a string until it reaches a character that is not a part of the initial number. If the string does not begin with a number that can be parsed,
        <code>parseFloat()</code>
        returns
        <code>NaN</code>
        . White space preceding valid integers is ignored, as are trailing nonnumeric characters.
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">str</span>:<a href="String.html">String</a></code> &mdash; The string to read and convert to a floating-point number.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Number.html">Number</a></code> &mdash; 
            A number or
            <code>NaN</code>
            (not a number).
          </td></tr></table></div><a name="parseInt()"></a><a name="parseInt(String,uint)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">parseInt</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function parseInt(str:<a href="String.html">String</a>, radix:<a href="uint.html">uint</a> = 0):<a href="Number.html">Number</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Converts a string to an integer. If the specified string in the parameters cannot be converted to a number, the function returns
        <code>NaN</code>
        . Strings beginning with 0x are interpreted as hexadecimal numbers. Unlike in previous versions of ActionScript, integers beginning with 0 are
        <i>not</i>
        interpreted as octal numbers. You must specify a radix of 8 for octal numbers. White space and zeroes preceding valid integers are ignored, as are trailing nonnumeric characters.
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">str</span>:<a href="String.html">String</a></code> &mdash; A string to convert to an integer.</td></tr><tr><td class="paramSpacer">&nbsp;</td></tr><tr><td width="20px"></td><td><code><span class="label">radix</span>:<a href="uint.html">uint</a></code> (default = <code>0</code>)<code></code> &mdash; An integer representing the radix (base) of the number to parse. Legal values are from 2 to 36.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Number.html">Number</a></code> &mdash; 
            A number or
            <code>NaN</code>
            (not a number).
          </td></tr></table></div><a name="String()"></a><a name="String(Object)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">String</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function String(expression:<a href="Object.html">Object</a>):<a href="String.html">String</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Returns a string representation of the specified parameter.
        <p>The following table shows the result of various input types:</p>
        
        <table class="innertable" ><tr><th>Input Type/Value</th><th>Return Value</th></tr><tr><td>
                  <code>undefined</code>
                </td><td>
                  <code>undefined</code>
                </td></tr><tr><td>
                  <code>null</code>
                </td><td>
                  <code>"null"</code>
                </td></tr><tr><td>
                  <code>true</code>
                </td><td>
                  <code>"true"</code>
                </td></tr><tr><td>
                  <code>false</code>
                </td><td>
                  <code>"false"</code>
                </td></tr><tr><td>
                  <code>NaN</code>
                </td><td>
                  <code>"NaN"</code>
                </td></tr><tr><td>String</td><td>String</td></tr><tr><td>Object</td><td>Object.toString()</td></tr><tr><td>Number</td><td>String representation of the number</td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">expression</span>:<a href="Object.html">Object</a></code> &mdash; An expression to convert to a string.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="String.html">String</a></code> &mdash; 
            A string representation of the value passed for the
            <code>expression</code>
            parameter.
          </td></tr></table></div><a name="trace()"></a><a name="trace(restParam)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">trace</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function trace(<a href="statements.html#..._(rest)_parameter">...</a> arguments):<a href="specialTypes.html#void">void</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Displays expressions, or writes to log files, while debugging. A single trace
  statement can support multiple arguments. If any argument in a trace statement includes a data type
  other than a String, the trace function invokes the associated
        <code>toString()</code>
        method for
  that data type. For example, if the argument is a Boolean value the trace function invokes
        <code>Boolean.toString()</code>
        and displays the return value.
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><a href="statements.html#..._(rest)_parameter">...</a> <span class="label">arguments</span></code> &mdash; One or more (comma separated) expressions to evaluate. For multiple expressions, a space is inserted between each expression in the output.</td></tr></table></p><br/><span class="label"> Example </span><br/><br/><div class="detailBody">
        The following example uses the class
        <code>TraceExample</code>
        to 
 show how the
        <code>trace()</code>
        method can be used to print a simple string.  Generally,
 the message will be printed to a "Debug" console.
        <div class="listing"><pre>package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}</pre></div>
      </div></div><a name="uint()"></a><a name="uint(Number)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">uint</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function uint(value:<a href="Number.html">Number</a>):<a href="uint.html">uint</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Converts a given numeric value to an unsigned integer value. Decimal values are truncated at the decimal point.
        <p>
          The following table describes the return value of
          <code>uint()</code>
          on various input types and values.
        </p>
        
        <table class="innertable" ><tr><th>Input Type/Value</th><th>Example</th><th>Return Value</th></tr><tr><td>
                  <code>undefined</code>
                </td><td>
                  <code>uint(undefined)</code>
                </td><td>
                  <code>0</code>
                </td></tr><tr><td>
                  <code>null</code>
                </td><td>
                  <code>uint(null)</code>
                </td><td>
                  <code>0</code>
                </td></tr><tr><td>
                  <code>0</code>
                </td><td>
                  <code>uint(0)</code>
                </td><td>
                  <code>0</code>
                </td></tr><tr><td>
                  <code>NaN</code>
                </td><td>
                  <code>uint(NaN)</code>
                </td><td>
                  <code>0</code>
                </td></tr><tr><td>Positive floating-point number</td><td>
                  <code>uint(5.31)</code>
                </td><td>
                  Truncated unsigned integer (e.g.
                  <code>5</code>
                  )
                </td></tr><tr><td>Negative floating-point number</td><td>
                  <code>uint(-5.78)</code>
                </td><td>Truncates to integer then applies rule for negative integers</td></tr><tr><td>Negative integer</td><td>
                  <code>uint(-5)</code>
                </td><td>
                  Sum of
                  <code>uint.MAX_VALUE</code>
                  and the negative integer (for example,
                  <code>uint.MAX_VALUE + (-5)</code>
                  )
                </td></tr><tr><td>
                  <code>true</code>
                </td><td>
                  <code>uint(true)</code>
                </td><td>
                  <code>1</code>
                </td></tr><tr><td>
                  <code>false</code>
                </td><td>
                  <code>uint(false)</code>
                </td><td>
                  <code>0</code>
                </td></tr><tr><td>Empty String</td><td>
                  <code>uint("")</code>
                </td><td>
                  <code>0</code>
                </td></tr><tr><td>String that converts to Number</td><td>
                  <code>uint("5")</code>
                </td><td>The number</td></tr><tr><td>String that does not convert to Number</td><td>
                  <code>uint("5a")</code>
                </td><td>
                  <code>0</code>
                </td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">value</span>:<a href="Number.html">Number</a></code> &mdash; A value to be converted to an integer.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="uint.html">uint</a></code> &mdash; The converted integer value.</td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#int()" target="">int()</a></div></div><a name="unescape()"></a><a name="unescape(String)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">unescape</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function unescape(str:<a href="String.html">String</a>):<a href="String.html">String</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Evaluates the parameter
        <code>str</code>
        as a string, decodes the string from URL-encoded format 
  (converting all hexadecimal sequences to ASCII characters), and returns the string.
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">str</span>:<a href="String.html">String</a></code> &mdash; A string with hexadecimal sequences to escape.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="String.html">String</a></code> &mdash; A string decoded from a URL-encoded parameter.</td></tr></table></div><a name="Vector()"></a><a name="Vector(Object)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">Vector</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function Vector(sourceArray:<a href="Object.html">Object</a>):<a href="Vector.html">Vector</a>.&lt;T&gt;</code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>Flash Player 10, AIR 1.5</td></tr></table><p></p><p></p><p>
        Creates a new Vector instance whose elements are instances of the specified data type. 
  When calling this function, you specify the data type of the result Vector's elements 
  (the Vector's
        <i>base type</i>
        ) using a type parameter. This function 
  uses the same syntax that's used when declaring a Vector instance or calling the
        <code>new Vector.&lt;T&gt;()</code>
        constructor:
        <div class="listing"><pre>var v:Vector.&lt;String&gt; = Vector.&lt;String&gt;(["Hello", "World"]);</pre></div>
        
        <p>
          The resulting Vector is populated 
  with the values in the elements of the
          <code>sourceArray</code>
          argument. 
  If the
          <code>sourceArray</code>
          argument is already a Vector.&lt;T>  
  instance where
          <code>T</code>
          is the base type, the function returns 
  that Vector. Otherwise, the result Vector 
  is populated with the elements of the
          <code>sourceArray</code>
          Array or Vector.
        </p>
        
        <p>
          In either case, the data type of all the elements of the
          <code>sourceArray</code>
          argument must match the base type
          <code>T</code>
          specified in the function call.
        </p>
        
        <p>
          If the
          <code>sourceArray</code>
          argument has
          <code>length</code>
          0, the function 
  returns an empty Vector.
        </p>
        
        <p>
          If a Vector is passed as the
          <code>sourceArray</code>
          argument and its base type 
  is not
          <code>T</code>
          , or if an Array is passed and its elements are not all instances of  
  data type
          <code>T</code>
          , an attempt is made to convert the values to the base type. If 
  the values can be automatically converted, the result Vector contains the converted values. 
  If no conversion can be made, an error occurs.
        </p>
        
        <p>
          Likewise, if an element in the
          <code>sourceArray</code>
          argument is an instance of 
  a subclass of the base type
          <code>T</code>
          , the call succeeds and the element is 
  added to the resulting Vector. This works even if the
          <code>sourceArray</code>
          argument is a Vector whose base type is a subclass 
  of
          <code>T</code>
          . In fact, this is the only way to convert a Vector with base type
          <code>T</code>
          to a Vector with a base type that's a superclass of
          <code>T</code>
          .
        </p>
        
        <p>For example, the following code results in a compile error in strict mode, or a 
  TypeError at run time, because it attempts to assign a Vector.&lt;Sprite> to a 
  Vector.&lt;DisplayObject> variable (Sprite is a subclass of DisplayObject):</p>
        
        <div class="listing"><pre>var v1:Vector.&lt;Sprite&gt; = new Vector.&lt;Sprite&gt;();
  v1[0] = new Sprite();
  var v2:Vector.&lt;DisplayObject&gt; = v1;</pre></div>
        
        <p>The following alternative version of the code successfully copies the elements of a 
  Vector.&lt;Sprite> instance to a Vector.&lt;DisplayObject> instance:</p>
        
        <div class="listing"><pre>var v1:Vector.&lt;Sprite&gt; = new Vector.&lt;Sprite&gt;();
  v1[0] = new Sprite();
  var v2:Vector.&lt;DisplayObject&gt; = Vector.&lt;DisplayObject&gt;(v1);</pre></div>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">sourceArray</span>:<a href="Object.html">Object</a></code> &mdash; An Array or Vector instance whose elements become the elements of the result 
  Vector. If the argument is a Vector instance whose associated data type is the same as the 
  specified data type, the argument is returned as the function result.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="Vector.html">Vector</a>.&lt;T&gt;</code> &mdash; 
            A Vector instance populated with the elements of the
            <code>sourceArray</code>
            array.
          </td></tr></table><br/><span class="label">Throws</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="TypeError.html">TypeError</a> </code> &mdash; 
            If the
            <code>sourceArray</code>
            argument contains an element that can't be 
  converted to the specified data type.
          </td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="Vector.html" target="">Vector class</a></div></div><a name="XML()"></a><a name="XML(Object)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">XML</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function XML(expression:<a href="Object.html">Object</a>):<a href="XML.html">XML</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Converts an object to an XML object.
        <p>The following table describes return values for various input types.</p>
        
        <table class="innertable" ><tr><th>Parameter Type</th><th>Return Value</th></tr><tr><td>Boolean</td><td>Value is first converted to a string, then converted to an XML object.</td></tr><tr><td>Null</td><td>A runtime error occurs (TypeError exception).</td></tr><tr><td>Number</td><td>Value is first converted to a string, then converted to an XML object.</td></tr><tr><td>Object</td><td>Converts to XML only if the value is a String, Number or Boolean value. Otherwise a runtime error occurs (TypeError exception).</td></tr><tr><td>String</td><td>Value is converted to XML.</td></tr><tr><td>Undefined</td><td>A runtime error occurs (TypeError exception).</td></tr><tr><td>XML</td><td>Input value is returned unchanged.</td></tr><tr><td>XMLList</td><td>Returns an XML object only if the XMLList object contains only one property of type XML. Otherwise a runtime error occurs (TypeError exception).</td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">expression</span>:<a href="Object.html">Object</a></code> &mdash; Object to be converted to XML.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="XML.html">XML</a></code> &mdash; An XML object containing values held in the converted object.</td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#XMLList()" target="">XMLList()</a></div></div><a name="XMLList()"></a><a name="XMLList(Object)"></a><table class="detailHeader" cellpadding="0" cellspacing="0"><tr><td class="detailHeaderName">XMLList</td><td class="detailHeaderParens">()</td><td class="detailHeaderType">function</td><td class="detailHeaderRule">&nbsp;</td></tr></table><div class="detailBody"><code> public function XMLList(expression:<a href="Object.html">Object</a>):<a href="XMLList.html">XMLList</a></code><p></p><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Language Version:&nbsp;</b></td><td>ActionScript 3.0</td></tr></table><table cellpadding="0" cellspacing="0" border="0"><tr><td style="white-space:nowrap" valign="top"><b>Runtime Versions:&nbsp;</b></td><td>AIR 1.0, Flash Player 9</td></tr></table><p></p><p></p><p>
        Converts an object to an XMLList object.
        <p>The following table describes return values for various input types.</p>
        
        <table class="innertable" ><tr><th>Parameter Type</th><th>Return Value</th></tr><tr><td>Boolean</td><td>Value is first converted to a string, then converted to an XMLList object.</td></tr><tr><td>Null</td><td>A runtime error occurs (TypeError exception).</td></tr><tr><td>Number</td><td>Value is first converted to a string, then converted to an XMLList object.</td></tr><tr><td>Object</td><td>Converts to XMLList only if the value is a String, Number or Boolean value. Otherwise a runtime error occurs (TypeError exception).</td></tr><tr><td>String</td><td>Value is converted to an XMLList object.</td></tr><tr><td>Undefined</td><td>A runtime error occurs (TypeError exception).</td></tr><tr><td>XML</td><td>Value is converted to an XMLList object.</td></tr><tr><td>XMLList</td><td>Input value is returned unchanged.</td></tr></table>
        
      </p><p><span class="label"> Parameters </span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20px"></td><td><code><span class="label">expression</span>:<a href="Object.html">Object</a></code> &mdash; Object to be converted into an XMLList object.</td></tr></table></p><p></p><span class="label">Returns</span><table cellpadding="0" cellspacing="0" border="0"><tr><td width="20"></td><td><code><a href="XMLList.html">XMLList</a></code> &mdash; An XMLList object containing values held in the converted object.</td></tr></table><p><span class="label">See also</span></p><div class="seeAlso"><a href="package.html#XML()" target="">XML()</a></div></div><p></p><center class="copyright"> &copy; 2004-2008 Adobe Systems Incorporated. All rights reserved. <br/>Thu Oct 30 2008, 07:14 PM -07:00  </center><div style="display:none">Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level Top Level </div></div></body></html>
