MergeFileListFast
دستکاری سند
توضیحات
شبیه تابع MergeFileList است اما از الگوریتم پیشرفتهتری برای بهبود سرعت استفاده میکند
هنگام ادغام، فهرست فایل جدیدی ایجاد میشود که برای هر مورد در فهرست فایل مشخصشده، نتیجهٔ فرایند ادغام را در بر دارد. نام فهرست جدید همان نام فهرست اصلی بهاضافهٔ واژهٔ Result است. برای نمونه، اگر نام فهرست اصلی "MyFiles" باشد، نام فهرست جدید "MyFilesResult" خواهد بود. این فهرست جدید نام فایلها را ندارد، اما شرح متنی وضعیت فایل منطبق را طی فرایند ادغام در بر میگیرد
برای موفقیت ادغام، حداقل دو فایل باید در فهرست فایل باشد
فیلدهای فرم، حاشیهنویسیها و نشانکهای همهٔ اسناد در سند ادغامشده حاضر خواهند بود
نحو
Delphi
Function TPDFlib.MergeFileListFast(Const ListName, OutputFileName: WideString): Integer;
ActiveX
Function PDFlib::MergeFileListFast(ListName As String, OutputFileName As String) As Long
DLL
int DLMergeFileListFast(int InstanceID, const wchar_t * ListName, const wchar_t * OutputFileName);
پارامترها
| ListName | نام فهرست فایل برای استفاده؛ همهٔ فایلهای این فهرست با هم ادغام میشوند |
|---|---|
| OutputFileName | مسیر و نام فایل خروجی برای ساختن؛ این فایل همهٔ فایلهای فهرست فایل را در بر خواهد گرفت |
لغو و منابع
ادغام هنگام اسکن ورودیها و نوشتن اشیاء پیشرفت را گزارش میکند. فراخوانی Abort عملیات را متوقف، استریمهای فعال را میبندد و خروجی ناقص را حذف میکند. ادغامهای فهرست فایل، هر مبدأ را برای اسکن باز میکنند و هنگام نوشتن حداکثر readerهای مبدأ اول و جاری را فعال نگه میدارند تا مصرف هندل با بزرگ شدن فهرست محدود بماند
مقادیر بازگشتی
| 0 | فرایند merge کامل نشد. برای تعیین علت خطا، از تابع GetLastError استفاده کنید |
|---|---|
| Non-zero | تعداد فایلهایی که با موفقیت ادغام شدند |