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.
}
}
}