mirror of
https://github.com/zap-proto/cs.git
synced 2026-10-30 15:05:32 +00:00
zeekay
2aa8261f86
Finishes the in-flight capnp→ZAP rebrand on this branch. The prior commits
renamed identifiers/namespaces/files/projects (Capnp.Net.Runtime→Zap.Net.Runtime,
CapnpC→ZapC, .capnp→.zap) but left the human-readable brand name "Cap'n Proto"
throughout doc-comments, .csproj/.nuspec descriptions, README, MSBuild .xaml
rule display names, and the generated XML doc. This completes brand neutrality:
- Replace 154 "Cap'n Proto" / 4 "Cap'n-Proto" / 1 "Cap'n'p" prose occurrences
with "ZAP" across 32 first-party files (runtime, generator, zapc-csharp,
MSBuild integration, chocolatey nuspecs, README, docs, XML doc).
- Revert the LICENSE provenance URL to the real upstream fork
(c80k/capnproto-dotnetcore) — upstream-fork license headers must stay.
- Canonicalize project/repo URLs to github.com/zap-proto/cs (were fabricated
c80k/zap-dotnetcore) in csproj/nuspec/VERIFICATION/README badges.
- Canonicalize docs URLs zap-protocol(.github.io|/zap-cs|/zap-cpp-core)
→ zap-proto.dev / github.com/zap-proto/{cs,cpp-core}.
- Collapse redundant "zap \"ZAP\"" PackageTags to "zap".
Verified consistent (no toolchain on host): every .sln/.csproj ProjectReference
resolves; all namespaces are Zap*/ZapC*; MSBuild task chain
(GenerateZapFileCodeBehindTask, ZapFiles ItemGroup, _ZapcCsharp_TaskAssembly)
is uniformly renamed; props/targets/xaml/coverage/chocolatey carry no capnp.
Deliberately preserved as upstream-derived test data (not first-party source):
upstream Cap'n Proto schema fixtures (rpc.zap, rpc-twoparty.zap, json.zap,
rpc-csharp.zap), golden compiler-error outputs (errors.txt), and the
machine-generated DO-NOT-EDIT test.zap.{c++,h}. Their "Cap'n Proto" strings are
the literal output of the external schema compiler the compat test matches.
115 lines
3.9 KiB
C#
115 lines
3.9 KiB
C#
using System;
|
|
using System.Collections;
|
|
using System.Collections.Generic;
|
|
|
|
namespace Zap
|
|
{
|
|
/// <summary>
|
|
/// SerializerState specialization for List(T) when T is unknown (generic), List(Data), List(Text), and List(List(...)).
|
|
/// </summary>
|
|
/// <typeparam name="TS">SerializerState which represents the element type</typeparam>
|
|
public class ListOfPointersSerializer<TS>:
|
|
SerializerState,
|
|
IReadOnlyList<TS?>
|
|
where TS: SerializerState, new()
|
|
{
|
|
/// <summary>
|
|
/// Gets or sets the element at given index.
|
|
/// </summary>
|
|
/// <param name="index">Element index</param>
|
|
/// <returns>Serializer state representing the desired element</returns>
|
|
/// <exception cref="InvalidOperationException">List was not initialized, or attempting to overwrite a non-null element.</exception>
|
|
/// <exception cref="IndexOutOfRangeException"><paramref name="index"/> is out of range.</exception>
|
|
public TS this[int index]
|
|
{
|
|
get
|
|
{
|
|
if (!IsAllocated)
|
|
throw new InvalidOperationException("Not initialized");
|
|
|
|
if (index < 0 || index >= Count)
|
|
throw new IndexOutOfRangeException();
|
|
|
|
return BuildPointer<TS>(index);
|
|
}
|
|
set
|
|
{
|
|
if (!IsAllocated)
|
|
throw new InvalidOperationException("Not initialized");
|
|
|
|
if (index < 0 || index >= Count)
|
|
throw new IndexOutOfRangeException();
|
|
|
|
Link(index, value, true);
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// This list's element count.
|
|
/// </summary>
|
|
public int Count => ListElementCount;
|
|
|
|
IEnumerable<TS?> Enumerate()
|
|
{
|
|
int count = Count;
|
|
|
|
for (int i = 0; i < count; i++)
|
|
{
|
|
yield return TryGetPointer<TS>(i);
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Implements <see cref="IEnumerable{TS}"/>.
|
|
/// </summary>
|
|
public IEnumerator<TS?> GetEnumerator()
|
|
{
|
|
return Enumerate().GetEnumerator();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Initializes this list with a specific size. The list can be initialized only once.
|
|
/// </summary>
|
|
/// <param name="count">List element count</param>
|
|
/// <exception cref="InvalidOperationException">The list was already initialized</exception>
|
|
/// <exception cref="ArgumentOutOfRangeException"><paramref name="count"/> is negative or greater than 2^29-1</exception>
|
|
public void Init(int count)
|
|
{
|
|
if (IsAllocated)
|
|
throw new InvalidOperationException("Already initialized");
|
|
|
|
if (count < 0)
|
|
throw new ArgumentOutOfRangeException(nameof(count));
|
|
|
|
SetListOfPointers(count);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Initializes the list with given content.
|
|
/// </summary>
|
|
/// <typeparam name="T">Item type</typeparam>
|
|
/// <param name="items">List content. Can be null in which case the list is simply not initialized.</param>
|
|
/// <param name="init">Serialization action to transfer a particular item into the serializer state.</param>
|
|
/// <exception cref="InvalidOperationException">The list was already initialized</exception>
|
|
/// <exception cref="ArgumentOutOfRangeException">More than 2^29-1 items.</exception>
|
|
public void Init<T>(IReadOnlyList<T>? items, Action<TS, T> init)
|
|
{
|
|
if (items == null)
|
|
{
|
|
return;
|
|
}
|
|
|
|
Init(items.Count);
|
|
|
|
for (int i = 0; i < items.Count; i++)
|
|
{
|
|
init(this[i], items[i]);
|
|
}
|
|
}
|
|
|
|
IEnumerator IEnumerable.GetEnumerator()
|
|
{
|
|
return GetEnumerator();
|
|
}
|
|
}
|
|
} |