WriteHandle

:::info[Note] This is a point-in-time snapshot of the API documentation from January 2026. Going forward, we will not be maintaining a public copy of these references, and recommend users to refer to the built-in signature helpers available in the Hack LSP instead for complete and up-to-date information. :::

Interface Synopsis

namespace HH\Lib\File;

interface WriteHandle implements Handle, \HH\Lib\IO\SeekableWriteFDHandle {...}

Public Methods

• ->truncate(?int $length = NULL): void

Public Methods (HH\Lib\File\Handle)

• ->getPath(): string
  Get the name of this file
• ->getSize(): int
  Get the size of the file
• ->lock(LockType $type): Lock
  Get a shared or exclusive lock on the file
• ->tryLockx(LockType $type): Lock
  Immediately get a shared or exclusive lock on a file, or throw

Public Methods (HH\Lib\IO\FDHandle)

• ->getFileDescriptor(): \HH\Lib\OS\FileDescriptor

Public Methods (HH\Lib\IO\SeekableHandle)

• ->seek(int $offset): void
  Move to a specific offset within a handle
• ->tell(): int
  Get the current pointer position within a handle

Public Methods (HH\Lib\IO\WriteHandle)

• ->writeAllAsync(string $bytes, ?int $timeout_ns = NULL): Awaitable<void>
  Write all of the requested data
• ->writeAllowPartialSuccessAsync(string $bytes, ?int $timeout_ns = NULL): Awaitable<int>
  Write data, waiting if necessary

Protected Methods (HH\Lib\IO\WriteHandle)

• ->writeImpl(string $bytes): int
  An immediate unordered write