PhoenixmlDb.XQuery
1.8.0
See the version list below for details.
dotnet add package PhoenixmlDb.XQuery --version 1.8.0
NuGet\Install-Package PhoenixmlDb.XQuery -Version 1.8.0
<PackageReference Include="PhoenixmlDb.XQuery" Version="1.8.0" />
<PackageVersion Include="PhoenixmlDb.XQuery" Version="1.8.0" />
<PackageReference Include="PhoenixmlDb.XQuery" />
paket add PhoenixmlDb.XQuery --version 1.8.0
#r "nuget: PhoenixmlDb.XQuery, 1.8.0"
#:package PhoenixmlDb.XQuery@1.8.0
#addin nuget:?package=PhoenixmlDb.XQuery&version=1.8.0
#tool nuget:?package=PhoenixmlDb.XQuery&version=1.8.0
PhoenixmlDb.XQuery
XQuery 4.0 query engine for PhoenixmlDb — query XML and JSON documents with the full power of XQuery.
Features
- Full XQuery 4.0 — FLWOR expressions, constructors, modules, user-defined functions
- XPath 4.0 — complete XPath implementation with 240+ built-in functions
- JSON support —
json-doc(),parse-json(), maps, arrays — query JSON natively - Full-text search —
ft:contains()with stemming, wildcards, proximity, scoring - Update Facility — insert, delete, replace, rename, transform expressions
- Type system — records, enums, union types (XQuery 4.0)
Quick example
using PhoenixmlDb.XQuery.Execution;
var engine = new QueryEngine();
// Simple query
var results = engine.ExecuteToListAsync(
"for $x in 1 to 10 where $x mod 2 = 0 return $x * $x");
// Query XML documents
var books = engine.ExecuteAsync(
"//book[price > 30]/title",
containerId);
Related packages
| Package | Description |
|---|---|
| PhoenixmlDb.Core | Core types and XDM data model (dependency) |
| PhoenixmlDb.Xslt | XSLT 4.0 transformation engine |
| PhoenixmlDb.XQuery.Cli | xquery command-line tool |
Documentation
Full documentation at phoenixml.dev
License
Apache 2.0
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Antlr4.Runtime.Standard (>= 4.13.1)
- Lucene.Net (>= 4.8.0-beta00016)
- Lucene.Net.Analysis.Common (>= 4.8.0-beta00016)
- PhoenixmlDb.Core (>= 1.7.0)
-
net8.0
- Antlr4.Runtime.Standard (>= 4.13.1)
- Lucene.Net (>= 4.8.0-beta00016)
- Lucene.Net.Analysis.Common (>= 4.8.0-beta00016)
- PhoenixmlDb.Core (>= 1.7.0)
NuGet packages (2)
Showing the top 2 NuGet packages that depend on PhoenixmlDb.XQuery:
| Package | Downloads |
|---|---|
|
PhoenixmlDb.Xslt
XSLT 4.0 transformation engine for PhoenixmlDb |
|
|
Phoenixml.Platform.Editor.Xml
XML/XSD vocabulary binding for Phoenixml.Platform — concrete IDocument and ITreeNodeProvider implementations against PhoenixmlDb.Core's XDM, XSD schema validation pipeline. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.0.0 | 0 | 9/15/2026 |
| 1.8.0 | 178 | 9/14/2026 |
| 1.7.0 | 587 | 9/11/2026 |
| 1.6.15 | 134 | 9/9/2026 |
| 1.6.14 | 162 | 9/7/2026 |
| 1.6.13 | 145 | 9/4/2026 |
| 1.6.12 | 171 | 9/1/2026 |
| 1.6.11 | 146 | 8/29/2026 |
| 1.6.10 | 172 | 8/29/2026 |
| 1.6.9 | 229 | 8/27/2026 |
| 1.6.8 | 163 | 8/26/2026 |
| 1.6.7 | 169 | 8/24/2026 |
| 1.6.6 | 155 | 8/23/2026 |
| 1.6.5 | 150 | 8/21/2026 |
| 1.6.2 | 187 | 8/16/2026 |
| 1.6.1 | 199 | 7/31/2026 |
| 1.6.0 | 174 | 7/27/2026 |
| 1.5.5 | 201 | 7/12/2026 |
| 1.5.4 | 202 | 7/9/2026 |
| 1.5.3 | 150 | 7/8/2026 |
Minor rather than patch: built-in functions now enforce their declared argument cardinality, which
is observable behaviour for any query that was relying on the lenient answer.
Takes PhoenixmlDb.Core 1.7.0.
### Behaviour change — read this before upgrading
**Built-in functions now apply argument cardinality, and their signatures match F&O 3.1.**
Previously they did not, so a call passing an empty or multi-item argument where the spec requires
exactly one returned a value instead of raising:
| call | before | after |
|---|---|---|
| `substring('abc', ())` | `""` | `XPTY0004` |
| `substring('abc', (1,2))` | `"abc"` | `XPTY0004` |
| `round-half-to-even(1.5, ())` | `2` | `XPTY0004` |
This applies to **every** built-in, not only the string functions above — the examples are
illustrative, not exhaustive. User-defined functions already raised `XPTY0004`, so this makes the
built-ins consistent with them. A query relying on the lenient behaviour will now fail where it
previously produced a value.
Enabling the check required correcting our own declarations first: **86 signatures** — 38
individually declared parameters plus all 48 `xs:` constructors through one shared base — were
stricter than F&O 3.1 demands.
### Fixed
- **Every `xs:integer` parsed from text was a `BigInteger`.** The source of a defect family, and
the cause of wrong results from `sum()` over integers read from a document.
- **`map:put` / `map:remove` / `map:replace` copied the whole map** — O(n) per update and O(n²)
per loop. Now a HAMT.
- **Map keys the comparer called equal could hash apart**, so a numeric lookup could miss and then
degrade to O(n).
- **A caller's timeout could not stop recursion, callbacks, or a slow `every`.** Cancellation is
now polled in the hot loops.
- **`contains text` threw at compile time, searched only one item, and matched `{expr}` against
everything.**
- **`contains text` treated `any` and `all` as word-level**; each search string is a phrase.
- **`dbxml:` and `ft:` functions were uncallable.** Adds `CompilationOptions.StaticNamespaces` so a
host can bind its own prefixes.
- **Host namespace bindings never reached run-time prefix resolution**, so `xs:QName('h:x')`, `cast
as xs:QName` and computed element names did not see them.
- **An index lookup with no resolver answered "no matches" instead of failing** — so indexing on
returned 0 where indexing off returned 1.
### Build
- **Development mode.** `PHOENIXML_DEV=1`, a workspace marker file, or `-p:PhoenixmlDev=true`
switches `PhoenixmlDb.*` package references to project references against the sibling checkouts.
`dotnet pack` refuses to run in dev mode and CI errors if it is ever on, so it cannot reach a
release.