RETURN
 Finaliza un procedimiento, función definida por el usuario o programa
------------------------------------------------------------------------------
 Sintaxis

     RETURN [<exp>]

 Argumentos

     <exp> es una expresión de cualquier tipo que da como resultado el
     valor de retorno para funciones definidas por el usuario. Si una
     función definida por el usuario finaliza sin una sentencia RETURN, el
     valor de retorno es NIL.

 Descripción

     RETURN finaliza un procedimiento, función definida por el usuario o
     programa, devolviendo el control al procedimiento o función que la
     invocó. Si se ejecuta un RETURN en el procedimiento de nivel más alto,
     el control pasa al sistema operativo. Al devolverse el control al
     procedimiento llamante, se liberan todas las variables privadas creadas
     y las variables locales declaradas en el procedimiento o función actual
     definida por el usuario.

     En un procedimiento o función definida por el usuario puede haber más
     de una sentencia RETURN. Aunque no es imprescindible que termine en
     dicha sentencia, como todas las funciones definidas por el usuario
     deben devolver un valor, la función definida por el usuario debe
     contener al menos una sentencia RETURN con un argumento.

     Nota: Una definición de procedimiento o de función definida por el
     usuario finaliza al encontrarse la siguiente sentencia PROCEDURE,
     FUNCTION o carácter de fin de fichero, no al encontrarse una sentencia
     RETURN.

 Notas

     ■ Matrices: Como las matrices son un tipo de datos como otro
        cualquiera, las instancias de tipo matriz son realmente valores como
        cadenas de caracteres y, por tanto, pueden devolverse desde una
        función definida por el usuario.

     ■ RETURN TO MASTER: CA-Clipper no permite la utilización de
        RETURN TO MASTER ni las demás formas de RETURN que especifican el
        nivel al que debe devolverse el control. Sin embargo, es posible
        simular estas operaciones con BEGIN SEQUENCE...END.

 Ejemplos

      Estos ejemplos muestran el formato general de la sentencia
        RETURN en un procedimiento y en una función:

        PROCEDIMIENTO <idProcedimiento>
           //
           <sentencias>...
           //
           RETURN

        FUNCTION <idFuncion>
           //
           <sentencias>...
           //
           RETURN <expDevuelta>

      Este ejemplo devuelve una matriz creada en una función al
        procedimiento o función definida por el usuario que la ha invocado:

        FUNCTION DevolverMatriz
           PRIVATE aMatriz[10][10]
           aMatriz[1][1] = "miCadena"
           RETURN aMatriz

 To download this example - click here.

See Also: BEGIN SEQUENCE FUNCTION LOCAL PRIVATE PROCEDURE