PIPE
hStream = PIPE sPipeName FOR [ READ ] [ WRITE ] [ WATCH ]
Abre um pipe nomeado para leitura, escrita ou ambos. Se o pipe não existir, ele será criado automaticamente.
Um pipe fornece fluxo unidirecional de comunicação entre processos dentro do mesmo sistema. Em outras palavras, eles são half-duplex, ou seja, o fluxo de dados em uma única direção.
Uma das principais características de um pipe é que o fluxo de dados através do meio de comunicação é transiente.
Uma vez que os dados são lidos utilizando o descritor "read", eles não podem ser lido novamente.
Além disso, se nós escrevemos dados continuamente para o descritor de gravação,
então, será possível ler os dados apenas na ordem em que os dados foram escritos.
No entanto, um pipe tem de ser aberto em ambas as extremidades ao mesmo tempo, antes que você possa continuar a fazer qualquer operação de entrada ou de saída do mesmo. A abertura de um pipe para leitura normalmente bloqueia até que algum outro processo abre o mesmo pipe para a escrita.
Gambas implementa um pipe FIFO (First-In, First-out). Para mais informações veja mkfifo nas páginas de manual Linux/Unix.
-
Se a palavra-chave
READ
for especificada, o pipe é aberto para leitura.
-
Se a palavra-chave
WRITE
for especificada, o pipe é aberto para escrita.
-
Se a palavra-chave
WATCH
for especificada, o pipe é vigiado pelo interpretador:
-
Se pelo menos um byte pode ser lido a partir do pipe, então, o manipulador de eventos
file_read()
é chamado.
-
Se pelo menos um byte pode ser escrito para o pipe, então, o manipulador de eventos
file_write()
é chamado.
Se o pipe for aberto com êxito, um objeto stream é retornado à variável
hStream.
Pipe streams nunca são buffered.
Erros
Mensagem
|
Descrição
|
Acesso proibido (#43)
|
O acesso solicitado para o pipe não é permitido, ou a permissão de busca é negada por um dos diretórios do prefixo do caminho pathname, ou o acesso ao diretório pai não permite escrita.
|
Dispositivo está cheio (#37)
|
File name era para ser criado, mas o dispositivo especificado por Pipe name não tem espaço para o novo arquivo.
|
Não é um diretório (#49)
|
Um componente descrito como um diretório em Pipe name não é, de fato, um diretório.
|
Erro de sistema... (#42)
|
Outros erros de sistema possíveis:
-
Muitas ligações simbólicas foram encontradas na resolução do caminho.
-
O comprimento do argumento path excede o máximo permitido ou um componente nome de path é mais longo do que o máxima permitido.
-
Um componente do prefixo path especificado pelo caminho não é um diretório existente ou caminho existente é uma string vazia.
-
O diretório que contém o novo arquivo não pode ser estendido ou o sistema de arquivos está sem recursos de alocação de arquivos.
-
O limite do sistema sobre o número total de arquivos abertos foi atingido.
-
Pipe name refere-se a um arquivo em um sistema de arquivos somente leitura, e o acesso de escrita foi solicitado.
|
Exemplos
' Imprime as mensagens enviadas para um pipe
' Inicia a execução em uma janela, depois de fazer: ls > /tmp/FIFO1
Dim hFile AS File
Dim sLine AS String
hFile = Pipe "/tmp/FIFO1" For Read
Do
Read #hFile, sLine, -256
If Not sLine Then Break
Print sLine;
Loop
' Outra maneira de ler um pipe quando os dados são várias linhas de texto.
Dim hFile As File
Dim sLine As String
hFile = Pipe "/tmp/FIFO1" For Read
Do
Line Input #hFile, sLine
If hFile.EndOfFile Then Break
Print sLine
Loop
Veja também