-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathFile.cs
164 lines (151 loc) · 12.5 KB
/
File.cs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
namespace LC6464.Base16384;
/// <summary>
/// Base16384 编解码器。
/// </summary>
public static partial class Base16384 {
/// <summary>
/// 强制使用长流模式（分段编码）编码二进制数据流中的数据到 Base16384 UTF-16 BE 编码文件。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="stream">二进制数据流</param>
/// <param name="fileInfo">创建的 Base16384 UTF-16 BE 编码文件信息</param>
/// <param name="buffer">外部提供的缓存空间（长度必须大于等于 <see cref="Buffer0Length"/>）</param>
/// <param name="encodingBuffer">外部提供的用于编码的缓存空间（长度必须大于等于 <see cref="EncodeLength"/>(<see cref="Buffer0Length"/>)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long EncodeFromLongStreamToNewFile(Stream stream, FileInfo fileInfo, Span<byte> buffer, Span<byte> encodingBuffer) {
using var file = fileInfo.Create();
file.Write(Utf16BEPreamble);
return EncodeFromLongStreamToStream(stream, file, buffer, encodingBuffer);
}
/// <summary>
/// 编码二进制数据流中的数据到 Base16384 UTF-16 BE 编码文件。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="stream">二进制数据流</param>
/// <param name="fileInfo">创建的 Base16384 UTF-16 BE 编码文件信息</param>
/// <param name="buffer">外部提供的缓存空间（若 <paramref name="stream"/>.Length > <see cref="Buffer0Length"/>，则长度必须大于等于 <see cref="Buffer0Length"/>；否则长度必须大于等于 <paramref name="stream"/>.Length - <paramref name="stream"/>.Position）</param>
/// <param name="encodingBuffer">外部提供的用于编码的缓存空间（若 <paramref name="stream"/>.Length > <see cref="Buffer0Length"/>，则长度必须大于等于 <see cref="EncodeLength"/>(<see cref="Buffer0Length"/>)；否则长度必须大于等于 <see cref="EncodeLength"/>(<paramref name="stream"/>.Length - <paramref name="stream"/>.Position)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long EncodeToNewFile(Stream stream, FileInfo fileInfo, Span<byte> buffer, Span<byte> encodingBuffer) {
using var file = fileInfo.Create();
file.Write(Utf16BEPreamble);
return EncodeToStream(stream, file, buffer, encodingBuffer);
}
/// <summary>
/// 强制使用长流模式（分段编码）解码 Base16384 UTF-16 BE 编码数据流中的数据到二进制文件。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="stream">Base16384 UTF-16 BE 编码数据流</param>
/// <param name="fileInfo">创建的二进制文件信息</param>
/// <param name="buffer">外部提供的缓存空间（长度必须大于等于 <see cref="Buffer1Length"/> + 2）</param>
/// <param name="decodingBuffer">外部提供的用于编码的缓存空间（长度必须大于等于 <see cref="DecodeLength"/>(<see cref="Buffer1Length"/>)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long DecodeFromLongStreamToNewFile(Stream stream, FileInfo fileInfo, Span<byte> buffer, Span<byte> decodingBuffer) {
using var file = fileInfo.Create();
return DecodeFromLongStreamToStream(stream, file, buffer, decodingBuffer);
}
/// <summary>
/// 解码 Base16384 UTF-16 BE 编码数据流中的数据到二进制文件。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="stream">Base16384 UTF-16 BE 编码数据流</param>
/// <param name="fileInfo">创建的二进制文件信息</param>
/// <param name="buffer">外部提供的缓存空间（若 <paramref name="stream"/>.Length > <see cref="Buffer1Length"/>，则长度必须大于等于 <see cref="Buffer1Length"/> + 2；否则长度必须大于等于 <paramref name="stream"/>.Length - <paramref name="stream"/>.Position）</param>
/// <param name="decodingBuffer">外部提供的用于编码的缓存空间（若 <paramref name="stream"/>.Length > <see cref="Buffer1Length"/>，则长度必须大于等于 <see cref="DecodeLength"/>(<see cref="Buffer1Length"/>)；否则长度必须大于等于 <see cref="DecodeLength"/>(<paramref name="stream"/>.Length - <paramref name="stream"/>.Position)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long DecodeToNewFile(Stream stream, FileInfo fileInfo, Span<byte> buffer, Span<byte> decodingBuffer) {
using var file = fileInfo.Create();
return DecodeToStream(stream, file, buffer, decodingBuffer);
}
/// <summary>
/// 编码二进制数据到 Base16384 UTF-16 BE 编码文件。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="data">二进制数据</param>
/// <param name="fileInfo">创建的 Base16384 UTF-16 BE 编码文件信息</param>
/// <param name="encodingBuffer">外部提供的用于编码的缓存空间（若 <paramref name="data"/>.Length > <see cref="Buffer0Length"/>，则长度必须大于等于 <see cref="EncodeLength"/>(<see cref="Buffer0Length"/>)；否则长度必须大于等于 <see cref="EncodeLength"/>(<paramref name="data"/>.Length)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long EncodeToNewFile(ReadOnlySpan<byte> data, FileInfo fileInfo, Span<byte> encodingBuffer) {
using var file = fileInfo.Create();
file.Write(Utf16BEPreamble);
return EncodeToStream(data, file, encodingBuffer);
}
/// <summary>
/// 解码 Base16384 UTF-16 BE 编码数据到二进制文件。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="data">Base16384 UTF-16 BE 编码数据</param>
/// <param name="fileInfo">创建的二进制文件信息</param>
/// <param name="decodingBuffer">外部提供的用于编码的缓存空间（若 <paramref name="data"/>.Length > <see cref="Buffer1Length"/>，则长度必须大于等于 <see cref="DecodeLength"/>(<see cref="Buffer1Length"/>)；否则长度必须大于等于 <see cref="DecodeLength"/>(<paramref name="data"/>.Length)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long DecodeToNewFile(ReadOnlySpan<byte> data, FileInfo fileInfo, Span<byte> decodingBuffer) {
using var file = fileInfo.Create();
return DecodeToStream(data, file, decodingBuffer);
}
/// <summary>
/// 编码二进制文件中的数据至 Base16384 UTF-16 BE 编码数据，追加到输出数据流。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="fileInfo">二进制文件信息</param>
/// <param name="output">输出数据流</param>
/// <param name="buffer">外部提供的缓存空间（若 <paramref name="fileInfo"/>.Length > <see cref="Buffer0Length"/>，则长度必须大于等于 <see cref="Buffer0Length"/>；否则长度必须大于等于 <paramref name="fileInfo"/>.Length）</param>
/// <param name="encodingBuffer">外部提供的用于编码的缓存空间（若 <paramref name="fileInfo"/>.Length > <see cref="Buffer0Length"/>，则长度必须大于等于 <see cref="EncodeLength"/>(<see cref="Buffer0Length"/>)；否则长度必须大于等于 <see cref="EncodeLength"/>(<paramref name="fileInfo"/>.Length)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long EncodeFromFileToStream(FileInfo fileInfo, Stream output, Span<byte> buffer, Span<byte> encodingBuffer) {
using var file = fileInfo.OpenRead();
return EncodeToStream(file, output, buffer, encodingBuffer);
}
/// <summary>
/// 解码 Base16384 UTF-16 BE 编码文件中的数据至二进制数据，追加到输出数据流。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="fileInfo">Base16384 UTF-16 BE 编码文件信息</param>
/// <param name="output">输出数据流</param>
/// <param name="buffer">外部提供的缓存空间（若 <paramref name="fileInfo"/>.Length > <see cref="Buffer1Length"/>，则长度必须大于等于 <see cref="Buffer1Length"/> + 2；否则长度必须大于等于 <paramref name="fileInfo"/>.Length）</param>
/// <param name="decodingBuffer">外部提供的用于编码的缓存空间（若 <paramref name="fileInfo"/>.Length > <see cref="Buffer1Length"/>，则长度必须大于等于 <see cref="DecodeLength"/>(<see cref="Buffer1Length"/>)；否则长度必须大于等于 <see cref="DecodeLength"/>(<paramref name="fileInfo"/>.Length)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long DecodeFromFileToStream(FileInfo fileInfo, Stream output, Span<byte> buffer, Span<byte> decodingBuffer) {
using var file = fileInfo.OpenRead();
if (((file.ReadByte() << 8) | file.ReadByte()) != 0xFEFF) {
file.Position = 0; // 如果是无 BOM 的非标准文件则回退
}
return DecodeToStream(file, output, buffer, decodingBuffer);
}
/// <summary>
/// 编码二进制文件中的数据至 Base16384 UTF-16 BE 编码文件。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="fileInfo">二进制文件信息</param>
/// <param name="outputFileInfo">Base16384 UTF-16 BE 编码文件信息</param>
/// <param name="buffer">外部提供的缓存空间（若 <paramref name="fileInfo"/>.Length > <see cref="Buffer0Length"/>，则长度必须大于等于 <see cref="Buffer0Length"/>；否则长度必须大于等于 <paramref name="fileInfo"/>.Length）</param>
/// <param name="encodingBuffer">外部提供的用于编码的缓存空间（若 <paramref name="fileInfo"/>.Length > <see cref="Buffer0Length"/>，则长度必须大于等于 <see cref="EncodeLength"/>(<see cref="Buffer0Length"/>)；否则长度必须大于等于 <see cref="EncodeLength"/>(<paramref name="fileInfo"/>.Length)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long EncodeFromFileToNewFile(FileInfo fileInfo, FileInfo outputFileInfo, Span<byte> buffer, Span<byte> encodingBuffer) {
using var output = outputFileInfo.Create();
output.Write(Utf16BEPreamble);
return EncodeFromFileToStream(fileInfo, output, buffer, encodingBuffer);
}
/// <summary>
/// 解码 Base16384 UTF-16 BE 编码文件中的数据至二进制文件。<br/>
/// 特别提醒：必须保证外部提供的缓存空间长度足够大，否则将会引发异常。
/// </summary>
/// <param name="fileInfo">Base16384 UTF-16 BE 编码文件信息</param>
/// <param name="outputFileInfo">二进制文件信息</param>
/// <param name="buffer">外部提供的缓存空间（若 <paramref name="fileInfo"/>.Length > <see cref="Buffer1Length"/>，则长度必须大于等于 <see cref="Buffer1Length"/> + 2；否则长度必须大于等于 <paramref name="fileInfo"/>.Length）</param>
/// <param name="decodingBuffer">外部提供的用于编码的缓存空间（若 <paramref name="fileInfo"/>.Length > <see cref="Buffer1Length"/>，则长度必须大于等于 <see cref="DecodeLength"/>(<see cref="Buffer1Length"/>)；否则长度必须大于等于 <see cref="DecodeLength"/>(<paramref name="fileInfo"/>.Length)）</param>
/// <exception cref="ArgumentException">外部提供的缓存空间不足</exception>
/// <returns>已写入的数据长度</returns>
public static long DecodeFromFileToNewFile(FileInfo fileInfo, FileInfo outputFileInfo, Span<byte> buffer, Span<byte> decodingBuffer) {
using var output = outputFileInfo.Create();
return DecodeFromFileToStream(fileInfo, output, buffer, decodingBuffer);
}
}