--- a/Symbian3/PDK/Source/GUID-84922B27-FDCF-56FD-91ED-5E0BFE3ED0E4.dita Thu Mar 11 15:24:26 2010 +0000
+++ b/Symbian3/PDK/Source/GUID-84922B27-FDCF-56FD-91ED-5E0BFE3ED0E4.dita Thu Mar 11 18:02:22 2010 +0000
@@ -1,147 +1,147 @@
-<?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 task
- PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
-<task id="GUID-84922B27-FDCF-56FD-91ED-5E0BFE3ED0E4" xml:lang="en"><title>Compressing
-and Decompressing File - Zip Format </title><shortdesc>The Zip Compression Library, EZLib provides stream and file compression
-and decompression functionality for the Symbian platforms. The files can be
-compressed to two formats namely zip and gzip. Compression and Decompression
-are performed iteratively, till the completion of required task. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
-<context id="GUID-BE620F4A-6D23-5832-8C2A-4B9C75F6BF12"/>
-<steps id="GUID-0DE92899-962B-5E18-9378-EB7B6C78E7BD">
-<step id="GUID-414B561B-4BCA-5D6F-A744-3944D0EBDBE2"><cmd>Pass the input and
-output files as parameters to construct an instance of <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref>.
-This returns a pointer to <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref> (input buffer). </cmd>
-<info> <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref> provides functions that accept
-and converts the data into buffers for <xref href="GUID-B90BA6D6-72A2-3EB8-B8EF-CD5408107A9E.dita"><apiname>MEZBufferManager</apiname></xref> class
-to manage it internally. </info>
-</step>
-<step id="GUID-BA8CC59E-FD6B-5ACA-A516-EBFFB5316D30"><cmd/>
-<info>Pass the input buffer and other compression parameters to the object
-of the <xref href="GUID-AEF8BCC8-6B24-3D59-AD3A-17B5203B3AA5.dita"><apiname>CEZCompressor</apiname></xref> class. </info>
-</step>
-<step id="GUID-BD4E38F1-78A7-5ED3-83D7-6C56EE7122DD"><cmd/>
-<info>Use <xref href="GUID-AEF8BCC8-6B24-3D59-AD3A-17B5203B3AA5.dita#GUID-AEF8BCC8-6B24-3D59-AD3A-17B5203B3AA5/GUID-03E4E3A2-3830-3209-9D7B-A2238B5AF219"><apiname>CEZCompressor::DeflateL()</apiname></xref> to compress the file. </info>
-</step>
-</steps>
-<example><p>The following code demonstrates a compression procedure. </p><codeblock xml:space="preserve">/*
- * Compresses the file into a zip file using the EZlib component.
- * It is assumed that the input and output file names are contained in a
- * provided ini file.
- */
-
-
-void CEZlibEZipTests::DoEZlibDeflateL()
- {
-RFs iFs;
- iFS.connect();
-
-
-
- //Open input file
-_LIT(KInputFileLocation, "c:\\private\\E80000B7\\zip\\input\\input.doc");
-TFileName inputFile(KInputFileLocation);
- RFile input;
- err = input.Open(iFs, inputFile, EFileStream | EFileRead | EFileShareExclusive);
- if(err != KErrNone)
- {
- INFO_PRINTF1(KOpenFileError);
- User::Leave(err);
- }
-
-
-
- //open output file
-
-_LIT(KOutputFileLocation, "c:\\private\\E80000B7\\zip\\input\\output.zip");
-TFileName outputFile(KOutputFileLocation);
- RFile output;
- err = output.Replace(iFs, outputFile, EFileStream | EFileWrite | EFileShareExclusive);
- if(err != KErrNone)
- {
- INFO_PRINTF1(KCreateFileError);
- User::Leave(err);
- }
-
-
-
- CEZFileBufferManager *bufferManager = CEZFileBufferManager::NewLC(input, output);
- CEZCompressor *compressor = CEZCompressor::NewLC(*bufferManager, aLevel, aWindowBits, aMemLevel, aStrategy);
-
- while(compressor->DeflateL())
- {
- }
- output.Close();
-input.Close();
- iFS.Close();
-
-
-
- }
-</codeblock></example>
-<postreq><p>The decompression of a <filepath>.zip</filepath> file can be achieved
-through the following the steps: </p> <ol id="GUID-468D2F53-B015-5DAB-96A7-08DBE8101773">
-<li id="GUID-23A8B3BC-0C23-503A-969A-EAD80BBDA3ED"><p>Pass the
-input and output files as parameters to construct an instance of <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref>.
-This returns a pointer to <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref> ( buffer). </p> </li>
-<li id="GUID-60335F30-42FF-57A1-8457-ADFAE6C34E76"><p>Pass the buffer to the
-object of the <xref href="GUID-BC3CEC02-B747-38FB-8B35-E7390DB06E35.dita"><apiname>CEZDecompressor</apiname></xref> class. </p> </li>
-<li id="GUID-969C35D8-AAB8-5875-9DA9-B80D0F402EB1"><p> <xref href="GUID-BC3CEC02-B747-38FB-8B35-E7390DB06E35.dita#GUID-BC3CEC02-B747-38FB-8B35-E7390DB06E35/GUID-0AC99B66-412B-3CCF-84DA-D7BC0F0D32B2"><apiname>CEZDecompressor::InflateL()</apiname></xref> is
-called repeatedly until the decompression is complete. </p> </li>
-</ol> <p>The following code demonstrates the decompression procedure. </p> <codeblock id="GUID-4A0A0D64-939C-587F-B9C7-F34B8F934E25" xml:space="preserve">/* Decompresses the file contained in a Zip file using the EZlib component.
- * It is assumed that the input and output file names are contained in a
- * provided ini file.
- */
-
-void CEZlibEZipTests::DoEZlibInflateL()
- {
-RFs iFs;
- iFS.connect();
-
-//Open input file
-_LIT(KInputFileLocation, "c:\\private\\E80000B7\\zip\\input\\output.zip");
-TFileName inputFile(KInputFileLocation);
- RFile input;
- err = input.Open(iRfs, inputFile, EFileStream | EFileRead | EFileShareExclusive);
- if(err != KErrNone)
- {
- INFO_PRINTF1(KOpenFileError);
- User::Leave(err);
- }
-
-
-
- //open output file
-
-_LIT(KOutputFile, "c:\\private\\E80000B7\\zip\\input\\input.doc");
-TFileName outputFile(KOutputFile);
- RFile output;
- err = output.Replace(iFs, outputFile, EFileStream | EFileWrite | EFileShareExclusive);
- if(err != KErrNone)
- {
- INFO_PRINTF1(KCreateFileError);
- User::Leave(err);
- }
-
-
-
-CEZFileBufferManager *bufferManager = CEZFileBufferManager::NewLC(input, Output);
-CEZDecompressor *decompressor = CEZDecompressor::NewLC(*bufferManager, aWindowBits);
-
-
- while(decompressor->InflateL())
- {
- }
-output.Close();
- input.Close();
- ifs.Close();
-
- }</codeblock> </postreq>
+<?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 task
+ PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
+<task id="GUID-84922B27-FDCF-56FD-91ED-5E0BFE3ED0E4" xml:lang="en"><title>Compressing
+and Decompressing File - Zip Format </title><shortdesc>The Zip Compression Library, EZLib provides stream and file compression
+and decompression functionality for the Symbian platforms. The files can be
+compressed to two formats namely zip and gzip. Compression and Decompression
+are performed iteratively, till the completion of required task. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>
+<context id="GUID-BE620F4A-6D23-5832-8C2A-4B9C75F6BF12"/>
+<steps id="GUID-0DE92899-962B-5E18-9378-EB7B6C78E7BD">
+<step id="GUID-414B561B-4BCA-5D6F-A744-3944D0EBDBE2"><cmd>Pass the input and
+output files as parameters to construct an instance of <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref>.
+This returns a pointer to <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref> (input buffer). </cmd>
+<info> <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref> provides functions that accept
+and converts the data into buffers for <xref href="GUID-B90BA6D6-72A2-3EB8-B8EF-CD5408107A9E.dita"><apiname>MEZBufferManager</apiname></xref> class
+to manage it internally. </info>
+</step>
+<step id="GUID-BA8CC59E-FD6B-5ACA-A516-EBFFB5316D30"><cmd/>
+<info>Pass the input buffer and other compression parameters to the object
+of the <xref href="GUID-AEF8BCC8-6B24-3D59-AD3A-17B5203B3AA5.dita"><apiname>CEZCompressor</apiname></xref> class. </info>
+</step>
+<step id="GUID-BD4E38F1-78A7-5ED3-83D7-6C56EE7122DD"><cmd/>
+<info>Use <xref href="GUID-AEF8BCC8-6B24-3D59-AD3A-17B5203B3AA5.dita#GUID-AEF8BCC8-6B24-3D59-AD3A-17B5203B3AA5/GUID-03E4E3A2-3830-3209-9D7B-A2238B5AF219"><apiname>CEZCompressor::DeflateL()</apiname></xref> to compress the file. </info>
+</step>
+</steps>
+<example><p>The following code demonstrates a compression procedure. </p><codeblock xml:space="preserve">/*
+ * Compresses the file into a zip file using the EZlib component.
+ * It is assumed that the input and output file names are contained in a
+ * provided ini file.
+ */
+
+
+void CEZlibEZipTests::DoEZlibDeflateL()
+ {
+RFs iFs;
+ iFS.connect();
+
+
+
+ //Open input file
+_LIT(KInputFileLocation, "c:\\private\\E80000B7\\zip\\input\\input.doc");
+TFileName inputFile(KInputFileLocation);
+ RFile input;
+ err = input.Open(iFs, inputFile, EFileStream | EFileRead | EFileShareExclusive);
+ if(err != KErrNone)
+ {
+ INFO_PRINTF1(KOpenFileError);
+ User::Leave(err);
+ }
+
+
+
+ //open output file
+
+_LIT(KOutputFileLocation, "c:\\private\\E80000B7\\zip\\input\\output.zip");
+TFileName outputFile(KOutputFileLocation);
+ RFile output;
+ err = output.Replace(iFs, outputFile, EFileStream | EFileWrite | EFileShareExclusive);
+ if(err != KErrNone)
+ {
+ INFO_PRINTF1(KCreateFileError);
+ User::Leave(err);
+ }
+
+
+
+ CEZFileBufferManager *bufferManager = CEZFileBufferManager::NewLC(input, output);
+ CEZCompressor *compressor = CEZCompressor::NewLC(*bufferManager, aLevel, aWindowBits, aMemLevel, aStrategy);
+
+ while(compressor->DeflateL())
+ {
+ }
+ output.Close();
+input.Close();
+ iFS.Close();
+
+
+
+ }
+</codeblock></example>
+<postreq><p>The decompression of a <filepath>.zip</filepath> file can be achieved
+through the following the steps: </p> <ol id="GUID-468D2F53-B015-5DAB-96A7-08DBE8101773">
+<li id="GUID-23A8B3BC-0C23-503A-969A-EAD80BBDA3ED"><p>Pass the
+input and output files as parameters to construct an instance of <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref>.
+This returns a pointer to <xref href="GUID-A54D8675-1874-3B4F-816D-001A235C0F9C.dita"><apiname>CEZFileBufferManager</apiname></xref> ( buffer). </p> </li>
+<li id="GUID-60335F30-42FF-57A1-8457-ADFAE6C34E76"><p>Pass the buffer to the
+object of the <xref href="GUID-BC3CEC02-B747-38FB-8B35-E7390DB06E35.dita"><apiname>CEZDecompressor</apiname></xref> class. </p> </li>
+<li id="GUID-969C35D8-AAB8-5875-9DA9-B80D0F402EB1"><p> <xref href="GUID-BC3CEC02-B747-38FB-8B35-E7390DB06E35.dita#GUID-BC3CEC02-B747-38FB-8B35-E7390DB06E35/GUID-0AC99B66-412B-3CCF-84DA-D7BC0F0D32B2"><apiname>CEZDecompressor::InflateL()</apiname></xref> is
+called repeatedly until the decompression is complete. </p> </li>
+</ol> <p>The following code demonstrates the decompression procedure. </p> <codeblock id="GUID-4A0A0D64-939C-587F-B9C7-F34B8F934E25" xml:space="preserve">/* Decompresses the file contained in a Zip file using the EZlib component.
+ * It is assumed that the input and output file names are contained in a
+ * provided ini file.
+ */
+
+void CEZlibEZipTests::DoEZlibInflateL()
+ {
+RFs iFs;
+ iFS.connect();
+
+//Open input file
+_LIT(KInputFileLocation, "c:\\private\\E80000B7\\zip\\input\\output.zip");
+TFileName inputFile(KInputFileLocation);
+ RFile input;
+ err = input.Open(iRfs, inputFile, EFileStream | EFileRead | EFileShareExclusive);
+ if(err != KErrNone)
+ {
+ INFO_PRINTF1(KOpenFileError);
+ User::Leave(err);
+ }
+
+
+
+ //open output file
+
+_LIT(KOutputFile, "c:\\private\\E80000B7\\zip\\input\\input.doc");
+TFileName outputFile(KOutputFile);
+ RFile output;
+ err = output.Replace(iFs, outputFile, EFileStream | EFileWrite | EFileShareExclusive);
+ if(err != KErrNone)
+ {
+ INFO_PRINTF1(KCreateFileError);
+ User::Leave(err);
+ }
+
+
+
+CEZFileBufferManager *bufferManager = CEZFileBufferManager::NewLC(input, Output);
+CEZDecompressor *decompressor = CEZDecompressor::NewLC(*bufferManager, aWindowBits);
+
+
+ while(decompressor->InflateL())
+ {
+ }
+output.Close();
+ input.Close();
+ ifs.Close();
+
+ }</codeblock> </postreq>
</taskbody></task>
\ No newline at end of file