| ... | ... | @@ -269,6 +269,39 @@ pub fn copyBackwards(comptime T: type, dest: []T, source: []const T) void { |
| 269 | 269 | } |
| 270 | 270 | } |
| 271 | 271 | |
| 272 | /// Copy `source` into `dest`, excluding the sentinel. |
| 273 | /// |
| 274 | /// Asserts no overlap. Asserts `dest.len` greater or equal to source len. Returns number of elements copied, |
| 275 | /// not counting the sentinel. |
| 276 | pub fn copySentinel(comptime T: type, comptime s: T, dest: []T, source: [*:s]const T) usize { |
| 277 | const i = findSentinel(T, s, source); |
| 278 | @memcpy(dest[0..i], source[0..i]); |
| 279 | return i; |
| 280 | } |
| 281 | |
| 282 | test copySentinel { |
| 283 | var dst: [11]u8 = @splat(0xff); |
| 284 | const n = copySentinel(u8, 0, &dst, "hello this\x00is my null-terminated string"); |
| 285 | try testing.expectEqualStrings("hello this\xff", &dst); |
| 286 | try testing.expectEqual(n, 10); |
| 287 | } |
| 288 | |
| 289 | /// Copy `source` into `dest`, including the sentinel. |
| 290 | /// |
| 291 | /// Asserts no overlap. Asserts `dest.len` greater or equal to source len, including room for the sentinel. |
| 292 | /// Returns number of elements copied, including the sentinel. |
| 293 | pub fn copySentinelInclusive(comptime T: type, comptime s: T, dest: []T, source: [*:s]const T) usize { |
| 294 | const i = findSentinel(T, s, source) + 1; |
| 295 | @memcpy(dest[0..i], source[0..i]); |
| 296 | return i; |
| 297 | } |
| 298 | |
| 299 | test copySentinelInclusive { |
| 300 | var dst: [12]u8 = @splat(0xff); |
| 301 | const n = copySentinelInclusive(u8, 0, &dst, "hello this\x00is my null-terminated string"); |
| 302 | try testing.expectEqualStrings("hello this\x00\xff", &dst); |
| 303 | try testing.expectEqual(n, 11); |
| 304 | } |
| 272 | 305 | /// Generally, Zig users are encouraged to explicitly initialize all fields of a struct explicitly rather than using this function. |
| 273 | 306 | /// However, it is recognized that there are sometimes use cases for initializing all fields to a "zero" value. For example, when |
| 274 | 307 | /// interfacing with a C API where this practice is more common and relied upon. If you are performing code review and see this |
| ... | ... | @@ -733,6 +766,19 @@ test lessThan { |
| 733 | 766 | try testing.expect(lessThan(u8, "", "a")); |
| 734 | 767 | } |
| 735 | 768 | |
| 769 | /// Returns `true` if `lhs < rhs`; `false` otherwise, operating on null-terminated arrays. |
| 770 | pub fn lessThanZ(comptime T: type, lhs: [*:0]const T, rhs: [*:0]const T) bool { |
| 771 | return orderZ(T, lhs, rhs) == .lt; |
| 772 | } |
| 773 | |
| 774 | test lessThanZ { |
| 775 | try testing.expect(lessThanZ(u8, "abcd", "bee")); |
| 776 | try testing.expect(!lessThanZ(u8, "abc", "abc")); |
| 777 | try testing.expect(lessThanZ(u8, "abc", "abc0")); |
| 778 | try testing.expect(!lessThanZ(u8, "", "")); |
| 779 | try testing.expect(lessThanZ(u8, "", "a")); |
| 780 | } |
| 781 | |
| 736 | 782 | const use_vectors = switch (builtin.zig_backend) { |
| 737 | 783 | // These backends don't support vectors yet. |
| 738 | 784 | .stage2_aarch64, |
Andrew Kelley <andrew@ziglang.org> 2026-09-08 20:46:21+02:00