DBFILEGET()
 Inserta el contenido de un campo en un fichero.
------------------------------------------------------------------------------
 Sintaxis

     DBFILEGET(<nPosCampo>, <cFicheroDestino>, <nModo>)
        --> lExito

 Argumentos

     <nPosCampo> es la posición del campo en la estructura del fichero
     de base de datos.

     <cFicheroDestino> es el nombre del fichero en el que se va a
     escribir el contenido del campo, incluidos opcionalmente la unidad, el
     directorio y la extensión. Consulte SETDEFAULT() y SETPATH() si desea
     información sobre las reglas de búsqueda y creación de ficheros. No se
     asume ninguna extensión por defecto.

     Si <cFicheroDestino> no existe, se crea. Si existe, se intenta abrir el
     fichero en modo exclusivo y, si se logra, se escriben los datos en el
     fichero. En el caso de que se deniegue el acceso debido, por ejemplo, a
     que otro proceso está utilizando el fichero, NETERR() toma el valor
     verdadero (.T.).

     <nModo> es una constante que define el modo de copia de acuerdo con
     los valores de la siguiente tabla:

     Constantes DBFILEGET()
     ------------------------------------------------------------------------
     Constante                Descripción
     ------------------------------------------------------------------------
     FILEGET_APPEND           Añade datos al fichero
     FILEGET_OVERWRITE        Sobreescribe los datos del fichero.
                              Es el valor por defecto.
     ------------------------------------------------------------------------

 Devuelve

     DBFILEGET() devuelve verdadero (.T.) si la operación se ha realizado
     con éxito; en caso contrario, devuelve falso (.F.).

 Descripción

     DBFILEGET() proporciona un mecanismo para copiar el contenido de un
     campo en un fichero. Por defecto, esta función opera en el área de
     trabajo seleccionada. Si desea utilizarla en otra área de trabajo, debe
     especificarla con una expresión de alias.

     DBFILEGET() se utiliza junto con DBFILEPUT() para transferir datos
     entre ficheros y campos de bases de datos.

 Ejemplos

      Este ejemplo exporta el contenido de un campo que contiene una
        imagen a un fichero .GIF. De esta manera, el fichero se puede
        utilizar para visualizar la imagen:

        FUNCTION MostrarImagen()
           LOCAL cFich := "Imagen.gif"
           LOCAL nPos

           // Base de datos cliente con un campo denominado "Imag" que
           // contiene la imagen del cliente
           USE Cliente NEW VIA "DBFCDX"
           nPos := FieldPos("Imag")

           // Copia los datos del campo "Imag"
           IF !DBFILEGET(nPos, cFich, FILEGET_OVERWRITE)
                ALERT ("Fallo al copiar imagen " + cFich)

           ELSE
              // Código para visualizar la imagen
           ENDIF

 Ficheros   La biblioteca asociada es CLIPPER.LIB,
            el fichero de cabecera asociado es Dbinfo.h
 To download this example - click here.

See Also: DBFILEPUT()