image2data

Der Tech-Blog

...weitermachen, wo OCR aufhört

DOS-Commands ausführen

Jan 212015

Ab und zu ergibt sich die Notwendigkeit, DOS-Kommandos auszuführen, z.B. DIR oder FIND und deren Ergebnisse in i2dScript weiter zu verwenden. Das folgende Beispiel demonstriert, wie man vorgehen kann. Die erste der markierten Zeilen ruft ein DIR im einfachen Format für das Verzeichnis "C:\" auf und leitet die Ausgabe in die Datei laut RESULTFILENAME um. Die StringListe "oResult" lädt diese Datei und in den beiden folgenden Zeilen wird über alle Einträge iteriert und diese ausgegeben. Die zweite markierte Zeile löscht die Ergebnisdatei wieder mittels eines DEL-Aufrufs.

Der folgende Code ist auch ein schönes Beispiel für ineinander verschachtelte Try-Finally-Blöcke, da auf jeden Fall das Objekt "oResult" wieder freigegeben als auch die Ergebnisdatei wieder gelöscht werden soll:

const
  RESULTFILENAME = 'C:\Temp\Ergebnis.txt';
 
var
  iCount: Integer;
  oResult: TStringList;
 
begin
  oResult := TStringList.Create;
 
  try
    <span style="background-color: #ff9900;">i2dExecute('cmd.exe /c', 'dir /B /A-D C:\ > ' + RESULTFILENAME, 0, True);</span>
 
    try
      oResult.LoadFromFile(RESULTFILENAME);
 
      for iCount := 0 to oResult.Count - 1 do
        i2dDebugOut(oResult[iCount]);
    finally
      <span style="background-color: #ff9900;">i2dExecute('cmd.exe /c', 'del ' + RESULTFILENAME, 0, True);</span>
    end;
  finally
    oResult.Free;
  end;
end.

 

Try-Finally-Blöcke

Jan 162015

Try-Finally-Blöcke sind eng mit Try-Except-Blöcken verwandt und werden genutzt, wenn es bei Auftreten eines vorzeitigen Abbarbeitungsabbruchs (z.B. durch Fehler) notwendig ist, Restarbeiten auszuführen, bevor die aktuelle Routine oder das Skript beendet wird. Beispiele hierfür sind das Freigeben instanziierter Objekte oder allokiertem Speicher oder das Schreiben eines Logeintrags.

try
  // ein Fehler, der innerhalb dieses Blockes ausgelöst wird, bricht die Abarbeitung des Codes 
  // sofort ab und springt zu der Codezeile hinter "finally"
finally
  // hier kann Code geschrieben werden, der die oben erwähnten Aufräumarbeiten durchführt. Die 
  // Abarbeitung wird bei der folgenden "end;"-Zeile beendet
end;

Im Folgenden ein kleines Beispiel. Die markierte Zeile wirft eine Exception, da das angegebene Dokument nicht existiert. Die Folgezeilen werden nicht mehr abgearbeitet, das Skript wird mit einem Laufzeitfehler beendet. Somit wird das instanziierte Objekt "oPage" nicht mehr freigegeben, ein Speicherleck ist die Folge:

var
  oPage: TBitmap;
 
begin
  oPage := TBitmap.Create;
 
 i2dLoadBitmap('nicht_vorhandenes_dokument.tif', 1, oPage);
 
  oPage.Free;
end.

Um das zu verhindern, würde hier ein Try-Finally-Block verwendet werden, der sicherstellt, daß das Objekt "oPage" in jedem Fall wieder freigegeben wird:

var
  oPage: TBitmap;
 
begin
  oPage := TBitmap.Create;
 
  try
    i2dLoadBitmap('nicht_vorhandenes_dokument.tif', 1, oPage);
  finally
    oPage.Free;
  end;
end.

Kritischen Skriptcode also immer in Try-Except- und/oder Try-Finally-Blöcke kapseln.

Atom

powered by Nibbleblog