using System; using System.IO; namespace ICSharpCode.SharpZipLib.Core { /// /// Provides simple " utilities. /// public sealed class StreamUtils { /// /// Read from a ensuring all the required data is read. /// /// The stream to read. /// The buffer to fill. /// static public void ReadFully(Stream stream, byte[] buffer) { ReadFully(stream, buffer, 0, buffer.Length); } /// /// Read from a " ensuring all the required data is read. /// /// The stream to read data from. /// The buffer to store data in. /// The offset at which to begin storing data. /// The number of bytes of data to store. /// Required parameter is null /// and or are invalid. /// End of stream is encountered before all the data has been read. static public void ReadFully(Stream stream, byte[] buffer, int offset, int count) { if (stream == null) { throw new ArgumentNullException("nameof(stream)"); } if (buffer == null) { throw new ArgumentNullException("nameof(buffer)"); } // Offset can equal length when buffer and count are 0. if ((offset < 0) || (offset > buffer.Length)) { throw new ArgumentOutOfRangeException("nameof(offset)"); } if ((count < 0) || (offset + count > buffer.Length)) { throw new ArgumentOutOfRangeException("nameof(count)"); } while (count > 0) { int readCount = stream.Read(buffer, offset, count); if (readCount <= 0) { throw new EndOfStreamException(); } offset += readCount; count -= readCount; } } /// /// Copy the contents of one to another. /// /// The stream to source data from. /// The stream to write data to. /// The buffer to use during copying. static public void Copy(Stream source, Stream destination, byte[] buffer) { if (source == null) { throw new ArgumentNullException("nameof(source)"); } if (destination == null) { throw new ArgumentNullException("nameof(destination)"); } if (buffer == null) { throw new ArgumentNullException("nameof(buffer)"); } // Ensure a reasonable size of buffer is used without being prohibitive. if (buffer.Length < 128) { throw new ArgumentException("Buffer is too small", "nameof(buffer)"); } bool copying = true; while (copying) { int bytesRead = source.Read(buffer, 0, buffer.Length); if (bytesRead > 0) { destination.Write(buffer, 0, bytesRead); } else { destination.Flush(); copying = false; } } } /// /// Copy the contents of one to another. /// /// The stream to source data from. /// The stream to write data to. /// The buffer to use during copying. /// The progress handler delegate to use. /// The minimum between progress updates. /// The source for this event. /// The name to use with the event. /// This form is specialised for use within #Zip to support events during archive operations. static public void Copy(Stream source, Stream destination, byte[] buffer, ProgressHandler progressHandler, TimeSpan updateInterval, object sender, string name) { Copy(source, destination, buffer, progressHandler, updateInterval, sender, name, -1); } /// /// Copy the contents of one to another. /// /// The stream to source data from. /// The stream to write data to. /// The buffer to use during copying. /// The progress handler delegate to use. /// The minimum between progress updates. /// The source for this event. /// The name to use with the event. /// A predetermined fixed target value to use with progress updates. /// If the value is negative the target is calculated by looking at the stream. /// This form is specialised for use within #Zip to support events during archive operations. static public void Copy(Stream source, Stream destination, byte[] buffer, ProgressHandler progressHandler, TimeSpan updateInterval, object sender, string name, long fixedTarget) { if (source == null) { throw new ArgumentNullException("nameof(source)"); } if (destination == null) { throw new ArgumentNullException("nameof(destination)"); } if (buffer == null) { throw new ArgumentNullException("nameof(buffer)"); } // Ensure a reasonable size of buffer is used without being prohibitive. if (buffer.Length < 128) { throw new ArgumentException("Buffer is too small", "nameof(buffer)"); } if (progressHandler == null) { throw new ArgumentNullException("nameof(progressHandler)"); } bool copying = true; DateTime marker = DateTime.Now; long processed = 0; long target = 0; if (fixedTarget >= 0) { target = fixedTarget; } else if (source.CanSeek) { target = source.Length - source.Position; } // Always fire 0% progress.. var args = new ProgressEventArgs(name, processed, target); progressHandler(sender, args); bool progressFired = true; while (copying) { int bytesRead = source.Read(buffer, 0, buffer.Length); if (bytesRead > 0) { processed += bytesRead; progressFired = false; destination.Write(buffer, 0, bytesRead); } else { destination.Flush(); copying = false; } if (DateTime.Now - marker > updateInterval) { progressFired = true; marker = DateTime.Now; args = new ProgressEventArgs(name, processed, target); progressHandler(sender, args); copying = args.ContinueRunning; } } if (!progressFired) { args = new ProgressEventArgs(name, processed, target); progressHandler(sender, args); } } /// /// Initialise an instance of /// private StreamUtils() { // Do nothing. } } }