ReleaseStringList
Různé funkce
Popis
Uvolní seznam řetězců, který dříve vrátila jiná funkce API (například CheckFileCompliance). Po tomto volání už handle StringListID není platný a nesmí se předat funkcím GetStringListCount ani GetStringListItem
Syntaxe
Delphi
Function TPDFlib.ReleaseStringList(StringListID: Integer): Integer;ActiveX
Function PDFlib::ReleaseStringList(StringListID As Long) As LongDLL
int DLReleaseStringList(int InstanceID, int StringListID);Parametry
| StringListID | ID string listu k uvolnění, jak bylo dříve vráceno produkční funkcí |
|---|
Návratové hodnoty
| 0 | StringListID is invalid or does not reference a string list owned by this instance. |
|---|---|
| 1 | Seznam se úspěšně uvolnil |
Poznámky
String listy vlastní instance PDFlib, která je vytvořila. Automaticky se uvolní se zničením instance, takže explicitní uvolnění je obvykle volitelné. V dlouho běžících procesech vytvářejících mnoho listů (třeba CI worker validující stovky PDF za sebou) volejte ReleaseStringList, aby využití paměti zůstalo ohraničené
Příklad
// 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;