writer = $writer; } /** * @param list<(callable(XMLWriter): XMLWriter)> $configurators */ public static function configure(callable ... $configurators): self { return self::fromUnsafeWriter(new XMLWriter(), ...$configurators); } /** * @param list<(callable(XMLWriter): XMLWriter)> $configurators */ public static function fromUnsafeWriter(XMLWriter $writer, callable ... $configurators): self { return new self(configure(...$configurators)($writer)); } /** * @param non-empty-string $file * @param list<(callable(XMLWriter): XMLWriter)> $configurators */ public static function forFile(string $file, callable ... $configurators): self { return self::configure( open(xml_file_opener($file)), ...$configurators ); } /** * @param list<(callable(XMLWriter): XMLWriter)> $configurators */ public static function inMemory(callable ... $configurators): self { return self::configure( open(memory_opener()), ...$configurators ); } /** * @param callable(XMLWriter): Generator $writer * @throws RuntimeException */ public function write(callable $writer): self { $xmlWriter = $this->writer; $cursor = $writer($xmlWriter); disallow_issues( static function () use ($cursor) : void { foreach ($cursor as $written) { disallow_libxml_false_returns( $written, 'Could not write the provided XML to the stream.' ); } } ); // Flush the content to the file. // Make sure to keep the buffer in case you are using an in-memory writer. $this->writer->flush(false); return $this; } /** * @param callable(XMLWriter): mixed $applicative */ public function apply(callable $applicative): self { $applicative($this->writer); return $this; } /** * @template T * @param callable(XMLWriter): T $mapper * * @return T */ public function map(callable $mapper) { return $mapper($this->writer); } }