<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept xml:lang="en" id="GUID-4C31BFCC-BC2A-55B1-8D3B-3355032E2062"><title>autoload</title><prolog><metadata><keywords/></metadata></prolog><conbody><p><userinput>autoload [ {+|-}UXmt ] [ -wkz ] [ name ... ]</userinput> </p> <p>Equivalent to functions <codeph>-u</codeph>, with the exception of <codeph>-X</codeph> /<codeph>+X</codeph>, <codeph>-w</codeph>, <codeph>-k</codeph> and <codeph>-z</codeph>. </p> <table id="GUID-9C277500-94BE-5D0D-8F4F-ACBDA3B7FBB6"><tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/><tbody><row><entry><p> <codeph>-X</codeph>  </p> </entry> <entry><p>Can be used only inside a shell function, and may not be followed by a name. It causes the calling function to be marked for autoloading and then immediately loaded and executed, with the current array of positional parameters as arguments. This replaces the previous definition of the function. If no function definition is found, an error is printed and the function remains undefined and marked for autoloading. </p> </entry> </row> <row><entry><p> <codeph>+X</codeph>  </p> </entry> <entry><p>Attempts to load each name as an autoloaded function, but does not execute it. The exit status is zero (success) if the function was not previously defined and a definition for it was found. This does not replace any existing definition of the function. The exit status is nonzero (failure) if the function was already defined or when no definition was found. In the latter case the function remains undefined and marked for autoloading. </p> <p>It can also be combined with either <codeph>-k</codeph> or <codeph>-z</codeph> to make the function be loaded using <codeph>ksh-style</codeph> or <codeph>zsh-style</codeph> autoloading, respectively. If neither is given, the current setting of the <codeph>KSH_AUTOLOAD </codeph> options determines how the function is loaded. With <codeph>ksh-style</codeph> autoloading, the contents of the file will not be executed immediately. Instead, the function created will contain the contents of the file plus a call to the function itself appended to it, thus given normal <codeph>ksh</codeph> autoloading behaviour on the first call to the function. </p> </entry> </row> </tbody> </tgroup> </table> <p> <b>Note:</b> Symbian platform does not support the use of <codeph>-w</codeph> option. </p> </conbody></concept>