ReleaseStringList
Çeşitli işlevler
Açıklama
Daha önce başka bir API işlevi tarafından döndürülen bir dize listesini serbest bırakır (örneğin CheckFileCompliance). Bu çağrıdan sonra StringListID tanıtıcısı artık geçerli değildir ve GetStringListCount veya GetStringListItem işlevine geçirilmemelidir
Sözdizimi
Delphi
Function TPDFlib.ReleaseStringList(StringListID: Integer): Integer;ActiveX
Function PDFlib::ReleaseStringList(StringListID As Long) As LongDLL
int DLReleaseStringList(int InstanceID, int StringListID);Parametreler
| StringListID | Daha önce bir üretici işlevi tarafından döndürülen, serbest bırakılacak dize listesinin kimliği |
|---|
Dönüş değerleri
| 0 | StringListID geçersizdir veya bu örneğe ait bir dize listesine başvurmaz |
|---|---|
| 1 | Liste başarıyla serbest bırakıldı |
Açıklamalar
Dize listeleri, onları üreten PDFlib örneğine aittir. Örnek yok edildiğinde otomatik olarak serbest bırakıldıklarından açıkça serbest bırakma genellikle isteğe bağlıdır. Bellek kullanımını sınırlı tutmak için çok sayıda liste üreten uzun süreli işlemlerde (örneğin yüzlerce PDF'yi sırayla doğrulayan bir CI çalışanında) ReleaseStringList çağrısı yapın
Örnek
// Validate many files in a loop, releasing each result list as soon as it has been logged
var
I, Issues, Count, J: Integer;
begin
for I := 0 to Files.Count - 1 do
begin
Issues := PDF.CheckFileCompliance(Files[I], '', 1, 0);
if Issues <> 0 then
begin
Count := PDF.GetStringListCount(Issues);
for J := 1 to Count do
WriteLn(Files[I], ' : ', PDF.GetStringListItem(Issues, J));
PDF.ReleaseStringList(Issues);
end;
end;
end;