SQL Server

Find ZIP Entries Matching a Wildcard Pattern Using EntryMatching

See more Zip Examples

This example demonstrates how to use the EntryMatching method to find ZIP entries whose stored paths match a wildcard pattern.

The wildcard character * matches zero or more characters. The comparison is performed against the full stored path within the ZIP archive.

This method is useful for:

• Finding files having a particular extension
• Locating files within specific subdirectories
• Searching ZIP archives without manually iterating through every entry

Suppose the ZIP archive contains:

docs/
docs/readme.txt
docs/manual.pdf
images/logo.png
images/banner.jpg
data/config/settings.json

Notice that the ZIP archive contains an explicit directory entry named docs/. ZIP archives may optionally contain separate directory entries in addition to file entries.

When searching with the pattern docs/*, the first matching entry could therefore be the directory entry docs/ rather than a file contained within that directory.

The example searches for:

• The first .png file
• The first entry beneath the docs directory
• The first JSON file anywhere within the ZIP archive

SQL Server

-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    DECLARE @success int
    SELECT @success = 0

    SELECT @success = 0

    -- Open an existing ZIP archive.
    DECLARE @zip int
    EXEC @hr = sp_OACreate 'Chilkat.Zip', @zip OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    EXEC sp_OAMethod @zip, 'OpenZip', @success OUT, 'example.zip'
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @zip, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @zip
        RETURN
      END

    DECLARE @entry int
    EXEC @hr = sp_OACreate 'Chilkat.ZipEntry', @entry OUT

    -- ------------------------------------------------------------
    -- Find the first .png file in the ZIP archive.

    EXEC sp_OAMethod @zip, 'EntryMatching', @success OUT, '*.png', @entry

    IF @success = 1
      BEGIN

        PRINT 'Found PNG file:'

        EXEC sp_OAGetProperty @entry, 'FileName', @sTmp0 OUT
        PRINT '  ' + @sTmp0

        PRINT ''
      END

    -- ------------------------------------------------------------
    -- Find the first entry beneath the docs directory.
    -- 
    -- Note: ZIP archives may optionally contain explicit directory
    -- entries such as "docs/" in addition to file entries.
    -- Therefore, the first matching entry could be the directory
    -- itself rather than a file contained within the directory.

    EXEC sp_OAMethod @zip, 'EntryMatching', @success OUT, 'docs/*', @entry

    IF @success = 1
      BEGIN

        PRINT 'First matching docs entry:'

        EXEC sp_OAGetProperty @entry, 'FileName', @sTmp0 OUT
        PRINT '  ' + @sTmp0

        EXEC sp_OAGetProperty @entry, 'IsDirectory', @iTmp0 OUT
        PRINT '  IsDirectory = ' + @iTmp0

        PRINT ''
      END

    -- ------------------------------------------------------------
    -- Find the first JSON file anywhere in the ZIP archive.

    EXEC sp_OAMethod @zip, 'EntryMatching', @success OUT, '*.json', @entry

    IF @success = 1
      BEGIN

        PRINT 'Found JSON file:'

        EXEC sp_OAGetProperty @entry, 'FileName', @sTmp0 OUT
        PRINT '  ' + @sTmp0

        PRINT ''
      END

    -- ------------------------------------------------------------
    -- The matching is performed against the full stored ZIP path.
    -- For example:
    -- 
    --     docs/readme.txt
    --     images/logo.png
    --     data/config/settings.json
    -- 
    -- The wildcard '*' matches zero or more characters.

    EXEC sp_OAMethod @zip, 'CloseZip', NULL


    PRINT 'Done.'

    EXEC @hr = sp_OADestroy @zip
    EXEC @hr = sp_OADestroy @entry


END
GO