ReleaseStringList

Funkcje różne

Opis

Zwalnia listę ciągów zwróconą wcześniej przez inną funkcję API, na przykład CheckFileCompliance. Po tym wywołaniu uchwyt StringListID traci ważność i nie wolno przekazywać go do GetStringListCount ani GetStringListItem

Składnia

Delphi

Function TPDFlib.ReleaseStringList(StringListID: Integer): Integer;

ActiveX

Function PDFlib::ReleaseStringList(StringListID As Long) As Long

DLL

int DLReleaseStringList(int InstanceID, int StringListID);

Parametry

StringListID	Identyfikator zwalnianej listy ciągów, zwrócony wcześniej przez funkcję tworzącą

Wartości zwracane

0	StringListID jest nieprawidłowy albo nie odwołuje się do listy ciągów należącej do tej instancji
1	Lista została pomyślnie zwolniona

Uwagi

Listy ciągów należą do instancji PDFlib, która je utworzyła. Są automatycznie zwalniane po zniszczeniu instancji, dlatego jawne zwalnianie jest zwykle opcjonalne. Wywołuj ReleaseStringList w długotrwałych procesach tworzących wiele list, na przykład w procesie CI sprawdzającym kolejno setki plików PDF, aby ograniczyć użycie pamięci

Przykład

// 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;

Zobacz również

GetStringListCount, GetStringListItem, CheckFileCompliance