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