Компилятор, совместимый с языками семейства xBase и Clipper
Пред.След.

PACK/UNPACK

Name

PACK/UNPACK --  Функции упаковки/распаковки и сжатия/расжатия строк и файлов.

Function

cResult             bUnZip2(<cData>)
cResult             bZip2(<cData> [,<nLevel>])
lRet                bZip2Close(<nHandle>)
nHandle             bZip2Open(<filename> [,<mode>])
realLen             bZip2Read(<nHandle>, <@cBuffer> [,<nLen>])
realLen             bZip2Write(<nHandle>, <cBuffer> [,<nLen>])
cResult             gUnZip(<cData>)
cResult             gZip(<cData> [,<nLevel>])
lRet                gZipClose(<nHandle>)
nHandle             gZipOpen(<filename> [,<mode>])
realLen             gZipRead(<nHandle>, <@cBuffer> [,<nLen>])
realLen             gZipWrite(<nHandle>, <cBuffer> [,<nLen>])

Description

В категории Pack/Unpack находятся описания функций для упаковки/распаковки и сжатия/расжатия строк и файлов.

Библиотека clip-gzip является враппером (переходником или библиотекой связи) для популярной библиотеки gzip, для ее использования требуется линковать: clip -e test.prg -lclip-gzip

Библиотека clip-bzip2 является враппером для популярной библиотеки bzip2, для ее использования требуется линковать: clip -e test.prg -lclip-bzip2

Function BUNZIP2() 

 bUnZip2(<cData>) --> cResult

Распаковывает строку, запакованную ранее bZip2().

<cData>

- данные для распаковки.

Returns :

bUnZip2() возвращает распакованную строку.

See also : bZip2()

Example :

 cResult := bUnZip2(bZip2(space(1000)))

Function BZIP2() 

 bZip2(<cData> [,<nLevel>]) --> cResult

Упаковывает строку с указанным уровнем сжатия (по умолчанию - 6).

<cData>

- данные для упаковки.

<nLevel>

- уровень сжатия.

Returns :

bZip2() возвращает упакованную строку.

See also : bUnZip2()

Example :

 cResult := bZip2(space(1000))

Function BZIP2CLOSE() 

 bZip2Close(<nHandle>) --> lRet

bZip2Close() сбрасывает все буффера на диск и закрывает файл.

<nHandle>

- номер открытого файла.

Returns :

bZip2Close() возвращает .t. или .f. в зависимости от наличия ошибки.

See also : bZip2Open() bZip2Read() bZip2Write()

Example :

 lRet := bZip2Close(h)

Function BZIP2OPEN() 

 bZip2Open(<filename> [,<mode>]) --> nHandle

Открывает bZIP2 файл с именем <filename> в режиме <mode> , если режим не указан - файл открывается для чтения. Возможные режимы открытия: "rb" - бинарное чтение без трансляции символов cr/lf. "wbX" - открыть для записи с уровнем компресии X от 0 до 9.

<filename>

- имя файла с bZIP2 архивом.

<mode>

- режим открытия файла.

Returns :

bZip2Open() возвращает номер открытого файла или -1 при ошибке.

See also : bZip2Read() bZip2Write() bZip2Close()

Example :

 h := bZip2Open("a.gz","rb")

Function BZIP2READ() 

 bZip2Read(<nHandle>, <@cBuffer> [,<nLen>]) --> realLen

Читает и распаковывает <nLen> данных из открытого bZIP2 файла с номером <nHandle> в зарезервированный <cBuffer> .

<nHandle>

- номер открытого файла.

<cBuffer>

- буффер для чтения данных.

<nLen>

- кол-во байт для чтения.

Returns :

bZip2Read() возвращает кол-во прочитанных байт или -1 при ошибке.

See also : bZip2Open() bZip2Write() bZip2Close()

Example :

 s := space(1000)
 realLen := bZip2Read(h,@s,300)

Function BZIP2WRITE() 

 bZip2Write(<nHandle>, <cBuffer> [,<nLen>]) --> realLen

Упаковывает <len> байт из <cBuffer> и записывает их в bZIP2-файл.

<nHandle>

- номер открытого файла.

<cBuffer>

- буффер с данными для записи в файл.

<nLen>

- кол-во байт для записи.

Returns :

bZip2Write() возвращает кол-во записанных байт или -1 при ошибке.

See also : bZip2Open() bZip2Read() bZip2Close()

Example :

 s := space(1000)
 realLen := bZip2Write(h,s,300)

Function GUNZIP() 

 gUnZip(<cData>) --> cResult

Распаковывает строку, запакованную ранее gZip().

<cData>

- данные для распаковки.

Returns :

gUnZip() возвращает распакованную строку.

See also : gZip()

Example :

 cResult := gUnZip(gZip(space(1000)))

Function GZIP() 

 gZip(<cData> [,<nLevel>]) --> cResult

Упаковывает строку с указанным уровнем сжатия (по умолчанию - 6).

<cData>

- данные для упаковки.

<nLevel>

- уровень сжатия.

Returns :

gZip() возвращает упакованную строку.

See also : gUnZip()

Example :

 cResult := gZip(space(1000))

Function GZIPCLOSE() 

 gZipClose(<nHandle>) --> lRet

gZipClose() сбрасывает все буффера на диск и закрывает файл.

<nHandle>

- номер открытого файла.

Returns :

gZipClose() возвращает .t. или .f. в зависимости от наличия ошибки.

See also : gZipOpen() gZipRead() gZipWrite()

Example :

 lRet := gzipClose(h)

Function GZIPOPEN() 

 gZipOpen(<filename> [,<mode>]) --> nHandle

Открывает GZIP файл с именем <filename> в режиме <mode> , если режим не указан - файл открывается для чтения. Возможные режимы открытия: "rb" - бинарное чтение без трансляции символов cr/lf. "wbX" - открыть для записи с уровнем компресии X от 0 до 9.

<filename>

- имя файла с gzip архивом.

<mode>

- режим открытия файла.

Returns :

gZipOpen() возвращает номер открытого файла или -1 при ошибке.

See also : gZipRead() gZipWrite() gZipClose()

Example :

 h := gZipOpen("a.gz","rb")

Function GZIPREAD() 

 gZipRead(<nHandle>, <@cBuffer> [,<nLen>]) --> realLen

Читает и распаковывает <nLen> данных из открытого GZIP файла с номером <nHandle> в зарезервированный <cBuffer> .

<nHandle>

- номер открытого файла.

<cBuffer>

- буффер для чтения данных.

<nLen>

- кол-во байт для чтения.

Returns :

gZipRead() возвращает кол-во прочитанных байт или -1 при ошибке.

See also : gZipOpen() gZipWrite() gZipClose()

Example :

 s := space(1000)
 realLen := gzipRead(h,@s,300)

Function GZIPWRITE() 

 gZipWrite(<nHandle>, <cBuffer> [,<nLen>]) --> realLen

Упаковывает <len> байт из <cBuffer> и записывает их в GZIP-файл.

<nHandle>

- номер открытого файла.

<cBuffer>

- буффер с данными для записи в файл.

<nLen>

- кол-во байт для записи.

Returns :

gZipWrite() возвращает кол-во записанных байт или -1 при ошибке.

See also : gZipOpen() gZipRead() gZipClose()

Example :

 s := space(1000)
 realLen := gzipWrite(h,s,300)

Пред.НачалоСлед.
DISKUTILSУровень вышеTCP