Loading...
Searching...
No Matches
juce::NamedPipe Class Referencefinal

`#include <juce_NamedPipe.h>`

## Public Member Functions

| NamedPipe ()
| ~NamedPipe ()
bool | openExisting (const String &pipeName)
bool | createNewPipe (const String &pipeName, bool mustNotExist=false)
void | close ()
bool | isOpen () const
String | getName () const
int | read (void *destBuffer, int maxBytesToRead, int timeOutMilliseconds)
int | write (const void *sourceBuffer, int numBytesToWrite, int timeOutMilliseconds)

## Detailed Description

A cross-process pipe that can have data written to and read from it.

Two processes can use NamedPipe objects to exchange blocks of data.

See also
  InterprocessConnection

Definition at line 36 of file juce_NamedPipe.h.

## Constructor & Destructor Documentation

## NamedPipe()

juce::NamedPipe::NamedPipe | ( |  | ) |

Creates a NamedPipe.

Definition at line 28 of file juce_NamedPipe.cpp.

Referenced by write().

## ~NamedPipe()

juce::NamedPipe::~NamedPipe | ( |  | ) |

Destructor.

Definition at line 30 of file juce_NamedPipe.cpp.

## Member Function Documentation

## close()

void juce::NamedPipe::close | ( |  | ) |

Closes the pipe, if it's open.

Referenced by createNewPipe(), openExisting(), and ~NamedPipe().

## createNewPipe()

bool juce::NamedPipe::createNewPipe | ( | const String & | pipeName,
|  | bool | mustNotExist = false )

Tries to create a new pipe. Returns true if it succeeds. If mustNotExist is true then it will fail if a pipe is already open with the same name.

Definition at line 50 of file juce_NamedPipe.cpp.

## getName()

String juce::NamedPipe::getName | ( |  | ) | const

Returns the last name that was used to try to open this pipe.

Definition at line 59 of file juce_NamedPipe.cpp.

Referenced by close().

## isOpen()

bool juce::NamedPipe::isOpen | ( |  | ) | const

True if the pipe is currently open.

Definition at line 44 of file juce_NamedPipe.cpp.

Referenced by close().

## openExisting()

bool juce::NamedPipe::openExisting | ( | const String & | pipeName | ) |

Tries to open a pipe that already exists. Returns true if it succeeds.

Definition at line 35 of file juce_NamedPipe.cpp.

## read()

int juce::NamedPipe::read | ( | void * | destBuffer,
|  | int | maxBytesToRead,
|  | int | timeOutMilliseconds )

Reads data from the pipe.

This will block until another thread has written enough data into the pipe to fill the number of bytes specified, or until another thread calls the cancelPendingReads() method.

If the operation fails, it returns -1, otherwise, it will return the number of bytes read.

If timeOutMilliseconds is less than zero, it will wait indefinitely, otherwise this is a maximum timeout for reading from the pipe.

## write()

int juce::NamedPipe::write | ( | const void * | sourceBuffer,
|  | int | numBytesToWrite,
|  | int | timeOutMilliseconds )

Writes some data to the pipe.

Returns
  the number of bytes written, or -1 on failure.

The documentation for this class was generated from the following files:

- juce_NamedPipe.h
- juce_NamedPipe.cpp