PhoenixmlDb.XQuery 1.7.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package PhoenixmlDb.XQuery --version 1.7.0
                    


                    

                
NuGet\Install-Package PhoenixmlDb.XQuery -Version 1.7.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.7.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="PhoenixmlDb.XQuery" Version="1.7.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.7.0
                    


                    

                
#r "nuget: PhoenixmlDb.XQuery, 1.7.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.7.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.7.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=PhoenixmlDb.XQuery&version=1.7.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 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);
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: an element or document constructor without a node builder now raises
instead of returning something of the wrong kind, which is observable behaviour for any host
supplying its own node store.

Takes PhoenixmlDb.Core 1.7.0.

### Fixed

- **`fn:sum` returned 0 for `xs:integer` values cast from text.** `xs:integer` is unbounded, so
 casting text to it yields a `BigInteger` even for a value as small as 10. The accumulation chain
 matched `int`/`long`, `double`, `float`, `decimal`, untypedAtomic and the durations — but not
 `BigInteger` — so such items fell through the whole chain, still counted, and contributed
 nothing. `sum((xs:integer("10"), xs:integer("30")))` returned **0**, with no error.

 Only `xs:integer` cast from TEXT is affected, which is what any query summing element content
 produces. `fn:avg` and `fn:min`/`fn:max` already carried the case. **Present in every published
 1.6.x.**

- **`fn:sum`/`avg`/`max`/`min` atomized storage-backed elements to `""`**, so aggregates over
 nodes read from a store failed the cast to `xs:double` while `fn:data()` over the same nodes
 returned the values. Root cause was in Core and is fixed there in 1.7.0; this is the
 engine-side half.

- **Element and document constructors degraded silently without an `INodeBuilder`.** An element
 constructor returned an `xs:string` of its own serialized markup; a document constructor
 dropped its wrapper. Neither has a correct result available, so the substitute surfaced later
 as an unrelated error — "axis step used when the context item is not a node" — pointing at the
 path expression rather than the node store. Both now raise, naming `INodeBuilder` and the type
 the host supplied.

### Verified

- XQuery unit suite 1554/1554
- Full W3C XSLT 3.0 sweep through the downstream engine: no set regressed
- Independently measured against an LMDB store by the phoenixml database repo: 73 pass/13 fail →
 **85/1**, and a same-machine A/B against 1.6.9 across 434 QT3 test-sets at **ratio 0.989** with
 no outcome changes

### Known, not fixed

`map:put` and `map:remove` copy the whole map, so building or updating a map in a loop is O(n²)
— phoenixmldb-xquery#6. Present in 1.6.x as well; the A/B above measured the one affected test
set ~21% slower on this version, a worsening of an existing quadratic rather than a new defect.
The fix is a persistent map structure and is deliberately not rushed into this release.

### Note on release discipline

16 versions shipped in the 1.6.x line of the sibling XSLT package and 14 here, several carrying
defects found only later — including the `fn:sum` bug above. See
`phoenixmldb-xslt/docs/RELEASE-HYGIENE.md`.