Annotation of libwww/Library/src/HTFSave.html, revision 2.1

2.1     ! frystyk     1: <HTML>
        !             2: <HEAD>
        !             3:   <!-- Changed by: Henrik Frystyk Nielsen, 19-May-1996 -->
        !             4:   <TITLE>W3C Sample Code Library libwww ANSI C File Streams</TITLE>
        !             5: </HEAD>
        !             6: <BODY>
        !             7: <H1>
        !             8:   Basic ANSI C File Writer Stream
        !             9: </H1>
        !            10: <PRE>
        !            11: /*
        !            12: **     (c) COPYRIGHT MIT 1995.
        !            13: **     Please first read the full copyright statement in the file COPYRIGH.
        !            14: */
        !            15: </PRE>
        !            16: <P>
        !            17: This module contains some local file writer streams based on the basic file
        !            18: writer stream defined in the <A HREF="HTFWrite.html">HTFWrite module</a>.
        !            19: They can be used to do save-as, save-and-callback etc.
        !            20: <P>
        !            21: This module is implemented by <A HREF="HTFSave.c">HTFSave.c</A>, and it
        !            22: is a part of the <A HREF="http://www.w3.org/Library/">W3C Sample Code
        !            23: Library</A>.
        !            24: <PRE>
        !            25: #ifndef HTFSAVE_H
        !            26: #define HTFSAVE_H
        !            27: 
        !            28: #include "HTFWrite.h"
        !            29: </PRE>
        !            30: <H2>
        !            31:   <A NAME="converters">Various Converters using the File Writer Stream</A>
        !            32: </H2>
        !            33: <P>
        !            34: This is a set of functions that can be registered as converters. They all
        !            35: use the basic ANSI C file writer stream for writing out to the local file
        !            36: system.
        !            37: <PRE>
        !            38: extern HTConverter HTSaveAndExecute, HTSaveLocally, HTSaveAndCallback;
        !            39: </PRE>
        !            40: <P>
        !            41: <DL>
        !            42:   <DT>
        !            43:     <CODE>HTSaveLocally</CODE>
        !            44:   <DD>
        !            45:     Saves a file to local disk. This can for example be used to dump date objects
        !            46:     of unknown media types to local disk. The stream prompts for a file name
        !            47:     for the temporary file.
        !            48:   <DT>
        !            49:     <CODE>HTSaveAndExecute</CODE>
        !            50:   <DD>
        !            51:     Creates temporary file, writes to it and then executes system command (maybe
        !            52:     an external viewer) when <CODE>EOF</CODE> has been reached. The stream finds
        !            53:     a suitable name of the temporary file which preserves the suffix. This way,
        !            54:     the system command can find out the file type from the name of the temporary
        !            55:     file name.
        !            56:   <DT>
        !            57:     <CODE>HTSaveAndCallback</CODE>
        !            58:   <DD>
        !            59:     This stream works exactly like the <CODE>HTSaveAndExecute</CODE> stream but
        !            60:     in addition when <CODE>EOF</CODE> has been reached, it checks whether a callback
        !            61:     function has been associated with the request object in which case, this
        !            62:     callback is being called. This can be use by the application to do some
        !            63:     processing <EM>after</EM> the system command has terminated. The callback
        !            64:     function is called with the file name of the temporary file as parameter.
        !            65: </DL>
        !            66: <PRE>
        !            67: #endif
        !            68: </PRE>
        !            69: <P>
        !            70:   <HR>
        !            71: <ADDRESS>
        !            72:   @(#) $Id: HTFWrite.html,v 2.22 1998/05/14 02:10:28 frystyk Exp $
        !            73: </ADDRESS>
        !            74: </BODY></HTML>

Webmaster