PhoenixmlDb.XQuery 1.8.0

There is a newer version of this package available.
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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="PhoenixmlDb.XQuery" Version="1.8.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="PhoenixmlDb.XQuery" Version="1.8.0" />
                    
Directory.Packages.props
<PackageReference Include="PhoenixmlDb.XQuery" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add PhoenixmlDb.XQuery --version 1.8.0
                    
#r "nuget: PhoenixmlDb.XQuery, 1.8.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package PhoenixmlDb.XQuery@1.8.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=PhoenixmlDb.XQuery&version=1.8.0
                    
Install as a Cake Addin
#tool nuget:?package=PhoenixmlDb.XQuery&version=1.8.0
                    
Install as a Cake Tool

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 supportjson-doc(), parse-json(), maps, arrays — query JSON natively
  • Full-text searchft: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);
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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed

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.