LoadFromMappedFile
Manajemen dokumen, Performa, Input file
Deskripsi
Memuat dan memilih PDF lokal melalui tampilan terpetakan baca-saja yang terbatas, memungkinkan pembacaan objek dan stream tertunda yang besar memakai ulang halaman file sistem operasi tanpa menyimpan sumber lengkap dalam memori
Sintaks
Delphi
Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;Parameter
| FileName | Jalur PDF lokal |
|---|---|
| Password | Kata sandi untuk membuka PDF, atau string kosong untuk dokumen tanpa enkripsi |
| WindowSize | Ukuran tampilan terpetakan yang diminta dalam byte; nol memilih 64 MiB, nilai di bawah granularitas alokasi sistem operasi dinaikkan ke granularitas itu dan nilai di atas 1 GiB dibatasi |
| Options | Nol mengizinkan fallback file stream baca-saja, sedangkan PDF_MAPPED_FILE_REQUIRE_MAPPING gagal kecuali tampilan terpetakan aktif |
Nilai yang dikembalikan
| 0 | Argumen tidak valid, file tidak dapat dibuka, pemetaan yang disyaratkan tidak tersedia, atau PDF tidak dapat dimuat; periksa LastErrorCode |
|---|---|
| 1 | Dokumen telah dimuat dan dipilih |
Catatan
Build Windows menyimpan satu tampilan baca-saja dan memetakannya ulang sesuai kebutuhan pada batas granularitas alokasi; platform lain dan kegagalan pemetaan memakai kontrak pembacaan absolut yang sama di atas file stream baca-saja normal kecuali pemetaan disyaratkanView 64 MiB bawaan membatasi pemakaian ruang alamat secara independen dari ukuran sumber dan cocok untuk akses jarang ke file lokal besar; view yang lebih kecil dapat mengurangi ruang alamat residen dengan biaya lebih banyak pemetaan ulangPembacaan irisan objek absolut menyalin langsung dari view saat ini ke penyimpanan milik parser tanpa mengubah kursor stream posisional; ini bukan API pointer zero-copy persisten karena pemetaan ulang membuat alamat view tidak validSumber tetap terbuka sampai dokumen yang dimuat dihapus, dan penyimpanan atau ekstraksi tertunda dapat terus membacanyaJika
OnPassword ditugaskan, setiap percobaan ulang kata sandi yang ditolak menerima stream terpetakan dan status parser yang baruGunakan
GetMappedFileInfo untuk memastikan apakah pemetaan aktif dan memeriksa statistik view serta pembacaan saat ini