Saltar para o conteúdo principal
Versão: v20 R4 BETA

Blob

A classe Blob permite-lhe criar e manipular objectos blob (4D. Blob).

Resumo

4D. Blob.new() : 4D. Blob
4D. Blob.new( blobScal : Blob ) : 4D. Blob
4D. Blob.new( blobObj : 4D. Blob ) : 4D.
    cria um novo objecto 4D.Blob opcionalmente encapsulando uma cópia dos dados de outro blob (blob escalar ou 4D.Blob)
.size : Real    Blob`
.slice() : 4D. Blob
.slice( start : Real ) : 4D. Blob
.slice( start : Real; end : Real ) : 4D. Blob
     cria e devolve um 4D. Blob que refere dados de um subconjunto do blob sobre o qual é chamado. A bolha original não é alterada.

4D. Blob.new()

Histórico
VersãoMudanças
v19 R2Adicionado

4D. Blob.new() : 4D. Blob
4D. Blob.new( blobScal : Blob ) : 4D. Blob
4D. Blob.new( blobObj : 4D. Blob ) : 4D.

ParâmetroTipoDescrição
blobBlob or 4D. Blob->Blob a copiar
Resultados4D. Blob<-Novo 4D. Blob

|

Descrição

4D. Blob.new cria um novo objecto 4D.Blob opcionalmente encapsulando uma cópia dos dados de outro blob (blob escalar ou 4D.Blob).

Se o parâmetro blob for omitido, o método devolve um 4D. Blob vazio.

.size

.size : Real

Descrição

Novo 4D. Blob|

.slice()

Histórico
VersãoMudanças
v19 R2Adicionado

.slice() : 4D. Blob
.slice( start : Real ) : 4D. Blob
.slice( start : Real; end : Real ) : 4D. Blob

ParâmetroTipoDescrição
startReal->índice do primeiro byte a incluir no novo 4D. Blob.
endReal->índice do primeiro byte que não será incluído no novo 4D. Blob
Resultados4D. Blob<-Novo 4D.Blob

|

Descrição

.slice() cria e devolve um 4D. Blob que refere dados de um subconjunto do blob sobre o qual é chamado. A bolha original não é alterada.

O parâmetro start é um índice no blob indicando o primeiro byte a ser incluído no novo 4D. Blob. Se especificar um valor negativo, 4D trata-o como uma compensação desde o fim da bolha até ao início. Por exemplo, -10 seria o 10º do último byte na bolha. O valor predefinido é 0. Valor normal padrão é 0 Se especificar um valor para início maior do que o tamanho do blob da fonte, o tamanho do blob devolvido 4D. Blob's é 0, e não contém dados.

O parâmetro end é um índice no blob indicando o primeiro byte que não será incluído no novo 4D. Blob (ou seja, o byte exactamente neste índice não está incluído). Se especificar um valor negativo, 4D trata-o como uma compensação desde o fim da bolha até ao início. Por exemplo, -10 seria o 10º do último byte na bolha. O valor por defeito é o tamanho do blob.

Exemplo

var $myBlob : 4D. Blob

// Store text in a 4D. Blob CONVERT FROM TEXT("Hello, World!"; "UTF-8"; $myBlob)
$is4DBlob:=OB Instance of($myBlob; 4D. Blob); //True

$myString:=Convert to text($myBlob; "UTF-8")
// $myString contains "Hello, World!"

// Criar um novo 4D. Blob de $myBlob
$myNewBlob:=$myBlob.slice(0; 5)

$myString:=Converter para texto($myNewBlob; "UTF-8")
// $myString contém "Olá"