authorgravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2025-07-20 17:21:33-07:00
committergravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2025-07-22 09:41:43-07:00
log2ac81c76e3d176d4ac0c568d195d5b979078a938
tree0790efae8f995fd977e40333700f7871be192629
parentaf0a02a2de8fad56029cccbfeb6254a2c2169b51

std.Io: add deprecation warnings

1 files changed, 25 insertions(+), 16 deletions(-)

lib/std/Io.zig+25-16
...@@ -435,25 +435,33 @@ pub fn GenericWriter(...@@ -435,25 +435,33 @@ pub fn GenericWriter(
435pub const AnyReader = @import("Io/DeprecatedReader.zig");435pub const AnyReader = @import("Io/DeprecatedReader.zig");
436/// Deprecated in favor of `Writer`.436/// Deprecated in favor of `Writer`.
437pub const AnyWriter = @import("Io/DeprecatedWriter.zig");437pub const AnyWriter = @import("Io/DeprecatedWriter.zig");
438438/// Deprecated in favor of `File.Reader` and `File.Writer`.
439pub const SeekableStream = @import("Io/seekable_stream.zig").SeekableStream;439pub const SeekableStream = @import("Io/seekable_stream.zig").SeekableStream;
440440/// Deprecated in favor of `Writer`.
441pub const BufferedWriter = @import("Io/buffered_writer.zig").BufferedWriter;441pub const BufferedWriter = @import("Io/buffered_writer.zig").BufferedWriter;
442/// Deprecated in favor of `Writer`.
442pub const bufferedWriter = @import("Io/buffered_writer.zig").bufferedWriter;443pub const bufferedWriter = @import("Io/buffered_writer.zig").bufferedWriter;
443444/// Deprecated in favor of `Reader`.
444pub const BufferedReader = @import("Io/buffered_reader.zig").BufferedReader;445pub const BufferedReader = @import("Io/buffered_reader.zig").BufferedReader;
446/// Deprecated in favor of `Reader`.
445pub const bufferedReader = @import("Io/buffered_reader.zig").bufferedReader;447pub const bufferedReader = @import("Io/buffered_reader.zig").bufferedReader;
448/// Deprecated in favor of `Reader`.
446pub const bufferedReaderSize = @import("Io/buffered_reader.zig").bufferedReaderSize;449pub const bufferedReaderSize = @import("Io/buffered_reader.zig").bufferedReaderSize;
447450/// Deprecated in favor of `Reader`.
448pub const FixedBufferStream = @import("Io/fixed_buffer_stream.zig").FixedBufferStream;451pub const FixedBufferStream = @import("Io/fixed_buffer_stream.zig").FixedBufferStream;
452/// Deprecated in favor of `Reader`.
449pub const fixedBufferStream = @import("Io/fixed_buffer_stream.zig").fixedBufferStream;453pub const fixedBufferStream = @import("Io/fixed_buffer_stream.zig").fixedBufferStream;
450454/// Deprecated in favor of `Reader.Limited`.
451pub const LimitedReader = @import("Io/limited_reader.zig").LimitedReader;455pub const LimitedReader = @import("Io/limited_reader.zig").LimitedReader;
456/// Deprecated in favor of `Reader.Limited`.
452pub const limitedReader = @import("Io/limited_reader.zig").limitedReader;457pub const limitedReader = @import("Io/limited_reader.zig").limitedReader;
453458/// Deprecated with no replacement; inefficient pattern
454pub const CountingWriter = @import("Io/counting_writer.zig").CountingWriter;459pub const CountingWriter = @import("Io/counting_writer.zig").CountingWriter;
460/// Deprecated with no replacement; inefficient pattern
455pub const countingWriter = @import("Io/counting_writer.zig").countingWriter;461pub const countingWriter = @import("Io/counting_writer.zig").countingWriter;
462/// Deprecated with no replacement; inefficient pattern
456pub const CountingReader = @import("Io/counting_reader.zig").CountingReader;463pub const CountingReader = @import("Io/counting_reader.zig").CountingReader;
464/// Deprecated with no replacement; inefficient pattern
457pub const countingReader = @import("Io/counting_reader.zig").countingReader;465pub const countingReader = @import("Io/counting_reader.zig").countingReader;
458466
459pub const BitReader = @import("Io/bit_reader.zig").BitReader;467pub const BitReader = @import("Io/bit_reader.zig").BitReader;
...@@ -464,9 +472,9 @@ pub const bitWriter = @import("Io/bit_writer.zig").bitWriter;...@@ -464,9 +472,9 @@ pub const bitWriter = @import("Io/bit_writer.zig").bitWriter;
464472
465pub const tty = @import("Io/tty.zig");473pub const tty = @import("Io/tty.zig");
466474
467/// A Writer that doesn't write to anything.475/// Deprecated in favor of `Writer.Discarding`.
468pub const null_writer: NullWriter = .{ .context = {} };476pub const null_writer: NullWriter = .{ .context = {} };
469477/// Deprecated in favor of `Writer.Discarding`.
470pub const NullWriter = GenericWriter(void, error{}, dummyWrite);478pub const NullWriter = GenericWriter(void, error{}, dummyWrite);
471fn dummyWrite(context: void, data: []const u8) error{}!usize {479fn dummyWrite(context: void, data: []const u8) error{}!usize {
472 _ = context;480 _ = context;
...@@ -882,13 +890,14 @@ test {...@@ -882,13 +890,14 @@ test {
882 _ = Reader;890 _ = Reader;
883 _ = Reader.Limited;891 _ = Reader.Limited;
884 _ = Writer;892 _ = Writer;
885 _ = @import("Io/bit_reader.zig");893 _ = BitReader;
886 _ = @import("Io/bit_writer.zig");894 _ = BitWriter;
887 _ = @import("Io/buffered_reader.zig");895 _ = BufferedReader;
888 _ = @import("Io/buffered_writer.zig");896 _ = BufferedWriter;
889 _ = @import("Io/counting_writer.zig");897 _ = CountingWriter;
890 _ = @import("Io/counting_reader.zig");898 _ = CountingReader;
891 _ = @import("Io/fixed_buffer_stream.zig");899 _ = FixedBufferStream;
892 _ = @import("Io/seekable_stream.zig");900 _ = SeekableStream;
901 _ = tty;
893 _ = @import("Io/test.zig");902 _ = @import("Io/test.zig");
894}903}