Skip to content

Fix Update Libraries.cs #55761

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MatveevichOne wants to merge 1 commit into
base: eiriktsarpalis-document-stj-dotnet-11
Choose a base branch
from
Open

Fix Update Libraries.cs #55761

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
96 changes: 28 additions & 68 deletions docs/core/whats-new/dotnet-11/snippets/csharp/Libraries.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
using System.Buffers;
using System.Buffers;
using System.Diagnostics;
using System.Formats.Tar;
using System.Globalization;
Expand All @@ -18,9 +18,8 @@ public static class LibrariesExamples
static async Task ProcessRunAndCaptureExample()
{
// <ProcessRunAndCapture>
// One-shot capture: stdout and stderr together, plus exit code.
ProcessTextOutput result = await Process.RunAndCaptureTextAsync(
"git", ["status", "--porcelain"]);
"git", new[] { "status", "--porcelain" });

Console.WriteLine(result.StandardOutput);
Console.WriteLine($"Exit code: {result.ExitStatus.ExitCode}");
Expand All @@ -30,11 +29,11 @@ static async Task ProcessRunAndCaptureExample()
static void ZLibEncoderSpanExample()
{
// <ZLibEncoderSpan>
ReadOnlySpan<byte> source = [0x48, 0x65, 0x6C, 0x6C, 0x6F]; // "Hello"
ReadOnlySpan<byte> source = new byte[] { 0x48, 0x65, 0x6C, 0x6C, 0x6F }; // "Hello"
byte[] buffer = new byte[source.Length + 32];
Span<byte> destination = buffer;

using ZLibEncoder encoder = new();
using ZLibEncoder encoder = new ZLibEncoder();
OperationStatus status = encoder.Compress(
source, destination, out int bytesConsumed, out int bytesWritten,
isFinalBlock: true);
Expand All @@ -48,22 +47,21 @@ static void FloatingPointHexExample()
// <FloatingPointHex>
double value = Math.PI;

// Format as hexadecimal IEEE-754: preserves all bits exactly
string hex = value.ToString("X"); // e.g., "0X1.921FB54442D18P+1"
double roundTripped = double.Parse(hex, NumberStyles.HexFloat);
string hex = value.ToString("X", CultureInfo.InvariantCulture);
double roundTripped = double.Parse(hex, NumberStyles.HexFloat, CultureInfo.InvariantCulture);

Console.WriteLine(roundTripped == value); // True — exact round-trip
Console.WriteLine(roundTripped == value);
// </FloatingPointHex>
}

static void UtfValidationExample()
{
// <UtfValidation>
ReadOnlySpan<byte> bytes = [0xC3, 0x28]; // invalid UTF-8
int badIndex = Utf8.IndexOfInvalidSubsequence(bytes); // 0
ReadOnlySpan<byte> bytes = new byte[] { 0xC3, 0x28 };
int badIndex = Utf8.IndexOfInvalidSubsequence(bytes);

ReadOnlySpan<char> chars = "valid \uD83D\uDC4D end"; // valid UTF-16 (👍 emoji)
bool ok = Utf16.IsValid(chars); // true
ReadOnlySpan<char> chars = "valid \uD83D\uDC4D end".AsSpan();
bool ok = Utf16.IsValid(chars);
// </UtfValidation>
}

Expand All @@ -77,7 +75,6 @@ static void Utf8JsonWriterResetExample()
writer.WriteEndObject();
writer.Flush();

// Reuse the writer with different output options.
stream.SetLength(0);
writer.Reset(stream, new JsonWriterOptions { Indented = false });
// </Utf8JsonWriterReset>
Expand All @@ -91,13 +88,9 @@ static void JsonTypeInfoExample()
TypeInfoResolver = new DefaultJsonTypeInfoResolver()
};

// Previously, a manual downcast was required.
JsonTypeInfo<MyRecord> info1 = (JsonTypeInfo<MyRecord>)options.GetTypeInfo(typeof(MyRecord));

// The generic method returns the correct type directly.
JsonTypeInfo<MyRecord> info2 = options.GetTypeInfo<MyRecord>();

// TryGetTypeInfo reports whether the configured resolver handles the type.
if (options.TryGetTypeInfo<MyRecord>(out JsonTypeInfo<MyRecord>? typeInfo))
{
_ = typeInfo;
Expand All @@ -108,9 +101,6 @@ static void JsonTypeInfoExample()
static void JsonNamingIgnoreExample()
{
// <JsonNamingIgnore>
// Type-level JsonIgnore omits null members by default. The type-level
// naming policy overrides the global policy, and the member policy wins
// for EventName.
var options = new JsonSerializerOptions
{
PropertyNamingPolicy = JsonNamingPolicy.PascalCase
Expand All @@ -119,26 +109,22 @@ static void JsonNamingIgnoreExample()
var data = new EventData { EventName = "Launch", ReleaseVersion = "11", Notes = null };
string json = JsonSerializer.Serialize(data, options);
Console.WriteLine(json);
// {"eventName":"Launch","release_version":"11"}
// </JsonNamingIgnore>
}

static async Task TarArchiveFormatExample()
{
// <TarArchiveFormat>
// Create a GNU format tar archive for Linux compatibility
TarFile.CreateFromDirectory("/source/dir", "/dest/archive.tar",
includeBaseDirectory: true, format: TarEntryFormat.Gnu);
includeBaseDirectory: true, entryFormat: TarEntryFormat.Gnu);

// Create a Ustar format archive for broader compatibility
using Stream outputStream = File.OpenWrite("/dest/ustar.tar");
TarFile.CreateFromDirectory("/source/dir", outputStream,
includeBaseDirectory: false, format: TarEntryFormat.Ustar);
includeBaseDirectory: false, entryFormat: TarEntryFormat.Ustar);

// Async version
CancellationToken cancellationToken = CancellationToken.None;
await TarFile.CreateFromDirectoryAsync("/source/dir", "/dest/archive.tar",
includeBaseDirectory: true, format: TarEntryFormat.Pax,
includeBaseDirectory: true, entryFormat: TarEntryFormat.Pax,
cancellationToken: cancellationToken);
// </TarArchiveFormat>
}
Expand All @@ -148,16 +134,13 @@ static void SafeFileHandlePipeExample()
// <SafeFileHandlePipe>
SafeFileHandle.CreateAnonymousPipe(
out SafeFileHandle readEnd,
out SafeFileHandle writeEnd,
asyncRead: true,
asyncWrite: false);
out SafeFileHandle writeEnd);

using (readEnd)
using (writeEnd)
{
// SafeFileHandle.Type reports the kind of OS object the handle refers to
Console.WriteLine(readEnd.Type); // Pipe
Console.WriteLine(writeEnd.Type); // Pipe
Console.WriteLine(readEnd.Type);
Console.WriteLine(writeEnd.Type);
}
// </SafeFileHandlePipe>
}
Expand All @@ -167,14 +150,12 @@ static void RegexAnyNewLineExample()
// <RegexAnyNewLine>
string text = "line1\r\nline2\u0085line3\u2028line4";

// RegexOptions.AnyNewLine makes ^, $, and . treat all Unicode newline
// sequences as line terminators, not just \n.
MatchCollection matches = Regex.Matches(
text,
@"^line\d$",
RegexOptions.Multiline | RegexOptions.AnyNewLine);

Console.WriteLine(matches.Count); // 4
Console.WriteLine(matches.Count);
// </RegexAnyNewLine>
}

Expand All @@ -185,27 +166,22 @@ public static void LinqJoinsExample()
{
(1, "Laptop", "Electronics"),
(2, "Mouse", "Electronics"),
(3, "Orphan", null), // No matching category
(3, "Orphan", null),
};
var categories = new List<(string Name, string Description)>
{
("Electronics", "Electronic devices"),
("Furniture", "Office furniture"), // No matching product
("Furniture", "Office furniture"),
};

// LeftJoin: all products, matched categories (null if none)
var leftJoined = products.LeftJoin(
categories,
p => p.Category,
c => c.Name);

foreach (var (product, category) in leftJoined)
Console.WriteLine($"{product.Name}: {category.Description ?? "(none)"}");
// Laptop: Electronic devices
// Mouse: Electronic devices
// Orphan: (none)

// FullJoin: all products and categories, paired where they match
var fullJoined = products.FullJoin(
categories,
p => p.Category,
Expand All @@ -214,39 +190,31 @@ public static void LinqJoinsExample()
foreach (var (product, category) in fullJoined)
Console.WriteLine(
$"{product.Name ?? "(none)"}: {category.Description ?? "(none)"}");
// Laptop: Electronic devices
// Mouse: Electronic devices
// Orphan: (none)
// (none): Office furniture
// </LinqJoins>
}

static void EqualityComparerCreateExample()
{
// <EqualityComparerCreate>

// Create an equality comparer based on a key selector
var byName = EqualityComparer<(string Name, int Age)>.Create(p => p.Name);

var people = new HashSet<(string Name, int Age)>(byName)
{
("Alice", 30),
("Bob", 25),
("Alice", 40), // Duplicate by name — not added
("Alice", 40),
};
Console.WriteLine(people.Count); // 2
Console.WriteLine(people.Count);
// </EqualityComparerCreate>
}

static void RandomGenericExample()
{
// <RandomGeneric>
// Generate a random integer of any binary integer type
int i = Random.Shared.NextInteger<int>();
long l = Random.Shared.NextInteger<long>(0L, 100L);
byte b = Random.Shared.NextInteger<byte>(maxValue: (byte)10);
byte b = Random.Shared.NextInteger<byte>(maxValue: 10);

// Generate a random floating-point value of any IEEE-754 type
float f = Random.Shared.NextBinaryFloat<float>();
double d = Random.Shared.NextBinaryFloat<double>();
Half h = Random.Shared.NextBinaryFloat<Half>();
Expand All @@ -262,11 +230,9 @@ static void StringBuilderMoveChunksExample()
var source = new StringBuilder("Hello, ");
source.Append("World!");

// MoveChunks transfers all content from source to a new StringBuilder.
// After the call, source contains no characters.
StringBuilder dest = StringBuilder.MoveChunks(source);
Console.WriteLine(dest); // Hello, World!
Console.WriteLine(source.Length); // 0
Console.WriteLine(dest);
Console.WriteLine(source.Length);
// </StringBuilderMoveChunks>
}

Expand All @@ -285,7 +251,6 @@ static async IAsyncEnumerable<int> GenerateNumbers()
using var arrayStream = new MemoryStream();
PipeWriter arrayPipe = PipeWriter.Create(arrayStream);

// Write a JavaScript Object Notation (JSON) array: [0,1,2,3,4]
await JsonSerializer.SerializeAsyncEnumerable(
arrayPipe,
GenerateNumbers());
Expand All @@ -294,8 +259,6 @@ await JsonSerializer.SerializeAsyncEnumerable(
using var jsonlStream = new MemoryStream();
PipeWriter jsonlPipe = PipeWriter.Create(jsonlStream);

// Write canonical JSON Lines (JSONL). Each value is followed by \n.
// Output: 0\n1\n2\n3\n4\n
await JsonSerializer.SerializeAsyncEnumerable(
jsonlPipe,
GenerateNumbers(),
Expand All @@ -307,16 +270,13 @@ await JsonSerializer.SerializeAsyncEnumerable(
static void X25519KeyExchangeExample()
{
// <X25519KeyExchange>
// Generate key pairs for Alice and Bob
using X25519DiffieHellman alice = X25519DiffieHellman.GenerateKey();
using X25519DiffieHellman bob = X25519DiffieHellman.GenerateKey();

// Each party derives the shared secret using the other's public key
byte[] aliceShared = alice.DeriveRawSecretAgreement(bob);
byte[] bobShared = bob.DeriveRawSecretAgreement(alice);

// Both parties arrive at the same secret
Console.WriteLine(aliceShared.SequenceEqual(bobShared)); // True
Console.WriteLine(aliceShared.SequenceEqual(bobShared));
// </X25519KeyExchange>
}

Expand All @@ -325,10 +285,10 @@ static void NullableUnderlyingTypeExample()
// <NullableUnderlyingType>
Type nullableIntType = typeof(int?);
Type? underlying = nullableIntType.GetNullableUnderlyingType();
Console.WriteLine(underlying); // System.Int32
Console.WriteLine(underlying);

Type nonNullable = typeof(int);
Console.WriteLine(nonNullable.GetNullableUnderlyingType() is null); // True
Console.WriteLine(nonNullable.GetNullableUnderlyingType() is null);
// </NullableUnderlyingType>
}
}
Expand Down
Loading