Skip to main content
Wave
GitHub

muundo

Muhtasari​

Muundo katika lugha ya Wave ni kipengele muhimu cha mwandiko kwa kutangaza aina za data zilizoainishwa na mtumiaji. Kwa kutumia muundo, unaweza kuunganisha thamani za aina tofauti katika kitengo kimoja cha kimantiki, na kupitia hapa unaweza kuunda mifano ya miundo ya data ngumu kwa uwazi na usalama.

Miundo ya Wave hufanya kazi kama aina ya thamani (value type). Mashamba yote lazima yawe na aina dhahiri, na mashamba yote lazima yaanze wakati mzio wa muundo unapoundwa. Kupitia sheria hizi hali ya muundo inabakia kamili na inaweza kutabirika kila wakati.​

Mwandiko wa tamko la muundo​

Muundo unatangazwa kwa kutumia neno kuu struct. Jina la muundo linatumia noti ya PascalCase, na mwili wa muundo unaweza kueleza angalau uwanja mmoja.

Mashamba yanatangazwa katika muundo wa jina: aina;, na kila tamko la uwanja lazima liwe na sehemu.

struct Box {
    size: i32;
    weight: f32;
}

Wakati muundo unatangazwa, mpangilio wa mashamba yanayoandikwa hutumiwa kwa usawa na mpangilio wa mipangilio ya kumbukumbu. Ndani ya muundo huruhusiwa tu tamko la uwanja, huwezi kujumuisha kazi au mbinu. Mantiki ya uendeshaji inaelezewa tofauti nje ya muundo.​

Mwandiko wa uundaji wa muundo​

Miundo imeundwa katika muundo wa kitamshi kutumia jina la muundo. Kitamshi cha muundo ni JinaLaMuundo { jina_la_uwanja: thamani; ... } imeandikwa kwa muundo.

var b: Box = Box {
    size: 42;
    weight: 10.5;
};

Unapotengeneza muundo, mashamba yote yaliyoainishwa yanapaswa kuwa ya awali ili kuepuka hitilafu ya usanidi.

Ingawa mpangilio wa chini wa mashamba hauhitaji kufuata mpangilio wa ufafanuzi wa muundo, aina ya thamani iliyotengwa kwa kila uwanja lazima iwe sawa na aina iliyofafanuliwa katika muundo. Katika Wave, ubadilishaji wa aina ya kimya wakati wa uanzilishi wa uwanja wa muundo hairuhusiwi.

Nafasi ya uwanja wa muundo​

Sehemu za muundo hufikiwa kupitia alama ya nukta. Ufikiaji wa uwanja hutumia mlingano wa mbinu sawa ya kusoma na kuandika.

println("Size: {}", b.size);
println("Weight: {}", b.weight);

Ikiwa unajaribu kutumia jina la uwanja ambalo halipo, kutakuwa na hitilafu ya usanidi. Kwa sababu muundo ni aina ya thamani, ikiwa unapitisha muundo mzima au kama kigezo cha kazi, mashamba yote ndani ya muundo yanakiliwa pamoja.

Mbinu ya ufafanuzi wa muundo​

Lugha ya Wave haikubali kufafanua mbinu moja kwa moja ndani ya muundo. Badala yake, tumia neno kuu proto kubainisha mkusanyiko wa mbinu zinazohusishwa na muundo.

Kizuizi cha proto ni mkusanyiko wa mbinu zinazoendela kwa muundo maalum, na mbinu ambazo zimebainika ndani ya kizuizi zinatumika kama mbinu za muundo husika.

Mbinu hutumia self kama kigezo cha kwanza kufanikisha uidhinishaji wa mfano wa muundo. proto inawakilisha thamani ya jumla ya muundo, na inapitishwa kwa njia ya nakala ya thamani.

proto Box {
    fun print(self) {
        println("size={}, weight={}", self.size, self.weight);
    }

    fun added_size(self, x: i32) -> i32 {
        return self.size + x;
    }
}

Kizuizi cha proto hakiitaji kuwekwa kwenye faili sawa na ufafanuzi wa muundo, na unaweza kutumia vizuizi kadhaa vya proto kubainisha mbinu tofauti za muundo mmoja.

Utoaji wa mbinu hutumia alama ya nukta, na hufanya kazi kwa njia sawa na mwito wa mbinu wa kawaida.

b.print();
var n: i32 = b.added_size(5);

Matumizi ya muundo kama kigezo cha kazi​

Muundo unapopitishwa kama kigezo cha kazi, unashughulikiwa kwa kutumia mlinganyo wa nakala ya thamani. Hata ikiwa utafanya mabadiliko kwenye uwanja wa muundo ndani ya kazi, haiathiri mfano wa muundo ulioitwa.

fun calc(box: Box) -> i32 {
    return box.size * 2;
}

Hata ikiwa muundo utatumika kama thamani ya kurudi kwa kazi, kutakuwa na nakala ya thamani. Kitendo hiki huhakikisha data iliyo ndani ya muundo inajulikana kwa utulivu na uwezo wa utabiri.

Muundo uliopachikwa (Nested Structure)​

Katika Wave, unaweza kutumia muundo mwingine ndani ya uwanja wa aina ya muundo. Kwa kuwa muundo ni aina kamili, unaweza kupachika muundo mwingine kwa uhuru ndani ya muundo.

struct Position {
    x: i32;
    y: i32;
}

struct Player {
    name: str;
    pos: Position;
}

Shamba la miundo iliyopachikwa hutumiwa kwa kusema kwa nukta.

var p: Player = Player {
    name: "Alice";
    pos: Position { x: 10; y: 20; };
};

println("Player X: {}", p.pos.x);
println("Player Y: {}", p.pos.y);

Ndani ya miundo sanifu, unaweza kuchanganya miundo mingine. Katika hali hii, sheria za uanzishaji wa amana zinaweza kutumika sawa.

Safu ya Miundo​

Muundo unaweza kutumika kama aina ya kipengee cha safu. Marudio ya safu katika Wave hutumia muundo wa array<aina, urefu>, na aina ya muundo hufafanuliwa vilevile.

var players: array<Player, 3> = [
    Player { name: "A"; pos: Position { x: 1; y: 2; }; },
    Player { name: "B"; pos: Position { x: 3; y: 4; }; },
    Player { name: "C"; pos: Position { x: 5; y: 6; }; }
];

Unapopata kipengee cha safu ya muundo, kwanza tumia indeksi ya safu, kisha ufikie shamba la ndani la muundo kupitia alama ya nukta.

println("Second Player X: {}", players[1].pos.x);

Je, msingi wa uendeshaji wa muundo unapatikana​

Miundo ya Wave haihusishi moja kwa moja katika uendeshaji au usanisi wa hesabu, kwa sababu ina aina iliyoainishwa na mtumiaji.

Ikiwa unahitaji kulinganisha kwa usawa, kupanga, hashing, au uendeshaji wa hesabu wa muundo, inahitaji kuelezea kwa wazi opereseni hiyo kwa kutumia 'proto' ya bendi. Wave haitoi waendeshaji wa ndani kwa miundo, na ina kanuni kwamba operesheni zote zinapaswa kufafanuliwa kwa uwazi.