Write
extends Temporary
in package
implements
Out
Class \Hoa\File\Temporary\Write.
Write into a temporary file.
Tags
Table of Contents
Interfaces
- Out
- Interface \Hoa\Stream\IStream\Out.
Properties
- $_i : int
- Temporary file index.
Methods
- __construct() : mixed
- Open a file.
- create() : string
- Create a unique temporary file, i.e. a file with a unique filename. It is different of calling $this->__construct() that will create a temporary file that will be destroy when calling the $this->close() method.
- getTemporaryDirectory() : string
- Get the directory path used for temporary files.
- truncate() : bool
- Truncate a file to a given length.
- write() : mixed
- Write n characters.
- writeAll() : mixed
- Write all, i.e. as much as possible.
- writeArray() : mixed
- Write an array.
- writeBoolean() : mixed
- Write a boolean.
- writeCharacter() : mixed
- Write a character.
- writeFloat() : mixed
- Write a float.
- writeInteger() : mixed
- Write an integer.
- writeLine() : mixed
- Write a line.
- writeString() : mixed
- Write a string.
- _open() : resource
- Open the stream and return the associated resource.
Properties
$_i
Temporary file index.
private
static int
$_i
= 0
Methods
__construct()
Open a file.
public
__construct(string $streamName[, string $mode = parent::MODE_APPEND_WRITE ][, string $context = null ][, bool $wait = false ]) : mixed
Parameters
- $streamName : string
-
Stream name.
- $mode : string = parent::MODE_APPEND_WRITE
-
Open mode, see the parent::MODE_* constants.
- $context : string = null
-
Context ID (please, see the \Hoa\Stream\Context class).
- $wait : bool = false
-
Differ opening or not.
create()
Create a unique temporary file, i.e. a file with a unique filename. It is different of calling $this->__construct() that will create a temporary file that will be destroy when calling the $this->close() method.
public
static create([string $directory = null ][, string $prefix = '__hoa_' ]) : string
Parameters
- $directory : string = null
-
Directory where the temporary filename will be created. If the directory does not exist, it may generate a file in the system's temporary directory.
- $prefix : string = '__hoa_'
-
Prefix of the generated temporary filename.
Return values
stringgetTemporaryDirectory()
Get the directory path used for temporary files.
public
static getTemporaryDirectory() : string
Return values
stringtruncate()
Truncate a file to a given length.
public
truncate(int $size) : bool
Parameters
- $size : int
-
Size.
Return values
boolwrite()
Write n characters.
public
write(string $string, int $length) : mixed
Parameters
- $string : string
-
String.
- $length : int
-
Length.
Tags
writeAll()
Write all, i.e. as much as possible.
public
writeAll(string $string) : mixed
Parameters
- $string : string
-
String.
writeArray()
Write an array.
public
writeArray(array<string|int, mixed> $array) : mixed
Parameters
- $array : array<string|int, mixed>
-
Array.
writeBoolean()
Write a boolean.
public
writeBoolean(bool $boolean) : mixed
Parameters
- $boolean : bool
-
Boolean.
writeCharacter()
Write a character.
public
writeCharacter(string $char) : mixed
Parameters
- $char : string
-
Character.
writeFloat()
Write a float.
public
writeFloat(float $float) : mixed
Parameters
- $float : float
-
Float.
writeInteger()
Write an integer.
public
writeInteger(int $integer) : mixed
Parameters
- $integer : int
-
Integer.
writeLine()
Write a line.
public
writeLine(string $line) : mixed
Parameters
- $line : string
-
Line.
writeString()
Write a string.
public
writeString(string $string) : mixed
Parameters
- $string : string
-
String.
_open()
Open the stream and return the associated resource.
protected
& _open(string $streamName[, Context $context = null ]) : resource
Parameters
- $streamName : string
-
Stream name (e.g. path or URL).
- $context : Context = null
-
Context.