Perl Requires Chilkat v11.7.0+

Rejoin Words Hyphenated at Line Ends

See more PDF Text Extraction Examples

Demonstrates the "dehyphenate" clean-up option (true by default). A word broken at the end of a line ("docu-" / "ment") is rejoined, while a hyphen that belongs to the word ("self-service") is kept. Set the option to false to keep the lines exactly as printed. Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

# The PDF used in this example is available at hyphenated.pdf

my $pdf = Chilkat2::Pdf->new;
my $success = $pdf->LoadFile('qa_data/pdf/hyphenated.pdf');
if (!$success) {
    print $pdf->LastErrorText, "\n";
    exit;
}

my $json = Chilkat2::JsonObject->new;
my $jsonOut = Chilkat2::JsonObject->new;

# The paragraph breaks "document", "self-service", "underlying" and "re-issued" at line ends.
# The default rejoins them.  "self-service" keeps its hyphen because the word appears with it,
# unbroken, elsewhere on the page; "re-issued" appears nowhere else, so it becomes "reissued".
$success = $pdf->ExtractText('text', $json, $jsonOut);
if (!$success) {
    print $pdf->LastErrorText, "\n";
    exit;
}

print "---- default (dehyphenate: true) ----\n";
print $jsonOut->StringOf('text'), "\n";

$json->UpdateBool('dehyphenate', 0);
$success = $pdf->ExtractText('text', $json, $jsonOut);
if (!$success) {
    print $pdf->LastErrorText, "\n";
    exit;
}

print "---- dehyphenate: false ----\n";
print $jsonOut->StringOf('text'), "\n";

# Sample output:

# ---- default (dehyphenate: true) ----
# Self-Service Kiosk Notes
#
# The new self-service kiosk in the lobby prints a visitor badge from the document number on the reservation. Staff should direct first-time visitors to the self-service kiosk rather than the desk, and should keep the paper tray topped up. The underlying software restarts itself overnight; a badge that fails to print is reissued at the desk on request.
# ---- dehyphenate: false ----
# Self-Service Kiosk Notes
#
# The new self-service kiosk in the lobby prints a visitor badge from the docu- ment number on the reservation. Staff should direct first-time visitors to the self- service kiosk rather than the desk, and should keep the paper tray topped up. The under- lying software restarts itself overnight; a badge that fails to print is re- issued at the desk on request.