zig network

นามธรรมเครือข่าย Zig

เลเยอร์นามธรรมเครือข่ายขนาดเล็กรอบ TCP และ UDP

คุณสมบัติ

• ใช้พื้นผิว API ขั้นต่ำสำหรับเครือข่ายพื้นฐาน
• สร้างนามธรรมข้ามแพลตฟอร์ม
• รองรับ I/O แบบบล็อกและไม่บล็อกผ่าน select / poll
• รองรับมัลติคาสต์ UDP

การใช้งาน

ใช้กับตัวจัดการแพ็คเกจ

build.zig.zon :

.{
    . name = "appname" ,
    . version = "0.0.0" ,
    . dependencies = .{
        . network = .{
            . url = "https://github.com/MasterQ32/zig-network/archive/<COMMIT_HASH_HERE>.tar.gz" ,
            . hash = "HASH_GOES_HERE" ,
        },
    },
}

(หากต้องการรับแฮช โปรดลบบรรทัดที่มี .hash ออก จากนั้นคอมไพเลอร์จะแจ้งให้คุณทราบว่าบรรทัดใดที่จะใส่กลับ)

build.zig :

 exe . addModule ( "network" , b . dependency ( "network" , .{}). module ( "network" ));

ตัวอย่างการใช้งาน

 const network = @import ( "network" );

test "Connect to an echo server" {
    try network . init ();
    defer network . deinit ();

    const sock = try network . connectToHost ( std . heap . page_allocator , "tcpbin.com" , 4242 , .tcp );
    defer sock . close ();

    const msg = "Hi from socket! n " ;
    try sock . writer (). writeAll ( msg );

    var buf : [ 128 ] u8 = undefined ;
    std . debug . print ( "Echo: {}" , .{ buf [0 .. try sock . reader (). readAll ( buf [0 .. msg . len ])]});
}

ดู async.zig สำหรับตัวอย่างที่สมบูรณ์ยิ่งขึ้นเกี่ยวกับวิธีใช้ I/O แบบอะซิงโครนัสเพื่อสร้างเซิร์ฟเวอร์ TCP ขนาดเล็ก

เรียกใช้ตัวอย่าง

สร้างตัวอย่างทั้งหมด:

$ zig build examples

สร้างตัวอย่างเฉพาะ:

$ zig build sync-examples

เพื่อทดสอบตัวอย่างเช่น echo :

$ ./zig-out/bin/echo 3000

ในเทอร์มินัลอื่น

$ nc localhost 3000
hello
hello
how are you
how are you

หมายเหตุ

บน Windows การเรียกใช้ฟังก์ชันการรับและส่งเป็นแบบอะซิงโครนัสและทำงานร่วมกับลูปเหตุการณ์ไลบรารีมาตรฐานเมื่อ io_mode = .evented ถูกตั้งค่าในไฟล์รูทของโปรแกรมของคุณ
สายอื่นๆ (เชื่อมต่อ ฟัง ยอมรับ ฯลฯ) กำลังบล็อกอยู่