Skip to main content
Version: v19 R8 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.Blob
    cria um novo objecto 4D.Blob opcionalmente encapsulando uma cópia dos dados de outro blob (blob escalar ou 4D.Blob)
.size : Real    devolve o tamanho de um 4D.Blob, expresso em bytes.
.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.Blob

ParâmetrosTipoDescriçã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

A propriedade .size devolve o tamanho de um 4D.Blob, expresso em bytes.

.slice()

Histórico
VersãoMudanças
v19 R2Adicionado

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

ParâmetrosTipoDescriçã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. 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á"