Name
p:file-mkdir — The standard p:file-mkdir step.
Synopsis
The p:file-mkdir step creates a directory.
| Output port | Primary | Sequence | Content types |
|---|---|---|---|
| result | ✔ | application/xml |
| Option name | Type | Default value | Required |
|---|---|---|---|
| href | xs:anyURI | ✔ | |
| fail-on-error | xs:boolean | true() |
Declaration
1 |<p:declare-step xmlns:p="http://www.w3.org/ns/xproc">
| <p:output port="result" primary="true" content-types="application/xml"/>
| <p:option name="href" required="true" as="xs:anyURI"/>
| <p:option name="fail-on-error" as="xs:boolean" select="true()"/>
5 |</p:declare-step>Errors
| Code | Description |
|---|---|
err:XC0114 | It is a dynamic error (err:XC0114) if the directory referenced by the
href option cannot be created. |
err:XC0140 | It is a dynamic error (err:XC0140) if an
implementation does not support p:file-mkdir for a specified scheme. |
err:XC0141 | It is a
dynamic error (err:XC0141) if p:file-mkdir not available to the step due to access restrictions
in the environment in which the pipeline is run. |
err:XD0064 | It is a dynamic
error (err:XD0064) if the base URI is not both absolute and valid according to RFC 3986. |
Implementation defined features
- Conformant processors must support URIs whose
scheme is
filefor thehrefoption ofp:file-mkdir. It is implementation-defined what other schemes are supported byp:file-mkdir, and what the interpretation of ‘directory’, ‘file’ and ‘contents’ is for those schemes.
Description
The p:file-mkdir step is a
standard XProc 3.1 step.
It is also described on XProcRef.org.