lang • pipe

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