diff --git a/lessons/ro/chapter_6.yaml b/lessons/ro/chapter_6.yaml new file mode 100644 index 000000000..afe3425ee --- /dev/null +++ b/lessons/ro/chapter_6.yaml @@ -0,0 +1,189 @@ +- title: Capitolul 6 - Text + content_markdown: > + Acum că înțelegem puțin modul în care Rust gestionează memoria, suntem pregătiti să discutăm + mai detaliat despre folosirea textelor. + + Limbajul Rust acorda multă importanță folosirii textelor în diverse limbi și modului în care sunt reprezentate + acestea la nivel de octeți, lucruri cu care s-ar putea să nu fiți familiarizați din alte limbaje. + + Acestea fiind spuse, Rust dispune de numeroase unelte pentru gestionarea lor. +- title: Șiruri de caractere literale + content_markdown: > + Șirurile de caractere literale (în engleză *string literals*) sunt întotdeauna reprezentate + folosind codificarea **utf-8** al setului de caracatere Unicode. + + + Șirurile de caractere literale sunt de tipul `&'static str`: + + * `&` înseamnă că referentiaza o locație din memorie, neavând `&mut` compilatorul + nu va permite modificări. + + * `'static` înseamnă că datele șirului vor fi disponibile până la sfârșitul + programului (nu se dă `drop` niciodată). + + * `str` înseamnă o secvență de octeți ce formează întotdeauna un text valid in formatul **utf-8** + + Detalii legate de memorie: + + * Compilatorul de Rust probabil va pune șirul de caractere în segmentul de date al + memoriei programului. + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20%7B%0A%20%20%20%20let%20a%3A%20%26'static%20str%20%3D%20%22hi%20%F0%9F%A6%80%22%3B%0A%20%20%20%20println!(%22%7B%7D%20%7B%7D%22%2C%20a%2C%20a.len())%3B%0A%7D%0A +- title: Ce este utf-8 + content_markdown: "Pe măsură ce tot mai multe limbi au început a fi folosite pe calculatoare, lumea a avut nevoie de modalități de reprezentare a mai multor caractere de text\ndecat ASCII permitea (1 byte permitea numai 256 de caractere). \n\nA fost introdus **utf-8**, având o lungime variabilă de bytes (1-4 bytes), lucru ce a crescut considerabil gama de caractere posibile.\n\nUn avantaj al caracterelor de dimensiuni variabile este că textul nu mai are octeți inutili pentru caractere ASCII foarte comune (necesitând doar 1 octet în **utf-8**).\n\nUn dezavantaj al caracterelor de dimensiuni variabile este faptul că căutarea caracterelor nu se mai poate face rapid \n(** timp constant O(1)**) cu o simplă indexare (exemplu: `my_text[3]` pentru a obține al patrulea caracter). Este posibil ca\ncaracterele anterioare să aibă lățimi variabile, modificând locul în care începe de fapt al 4-lea caracter în secvența de octeți.\n\nTrebuie în schimb să parcurgem o secvență **utf-8** de octeți pentru a înțelege unde încep de fapt caracterele Unicode (** timp liniar **O(n)**).\n\nFerris: \"În mare parte, doar mă bucur că am **utf-8** pentru a reprezenta emoticoane cu prietenii mei subacvatici.\"\n\n\U0001F420\U0001F419\U0001F41F\U0001F42C\U0001F40B\n" +- title: Secvențe Escape + content_markdown: > + Este o provocare să reprezinți vizual anumite caractere, așa că secvențele escape (în engleză *escape codes*) + ne permit să punem un simbol în locul lor. + + + Rust suportă codurile de escape comune ale limbajelor bazate pe C: + + * `\n` - newline + + * `\r` - carriage return + + * `\t` - tab + + * `\\\` - backslash + + * `\0` - nul + + * `\'` - ghilimele singulare + + + Lista completă există + [aici](https://doc.rust-lang.org/reference/tokens.html). + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20%7B%0A%20%20%20%20let%20a%3A%20%26'static%20str%20%3D%20%22Ferris%20spune%3A%5Ct%5C%22salut%5C%22%22%3B%0A%20%20%20%20println!(%22%7B%7D%22%2Ca)%3B%0A%7D%0A +- title: Șiruri de caractere literale pe mai multe linii + content_markdown: | + Șirurile de caractere din Rust sunt în mod implicit pe mai multe linii. + + Folosiți un `\` la sfârșitul rândului dacă nu doriți să se facă o întrerupere de rând. + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20%7B%0A%20%20%20%20let%20haiku%3A%20%26'static%20str%20%3D%20%22%0A%20%20%20%20%20%20%20%20I%20write%2C%20erase%2C%20rewrite%0A%20%20%20%20%20%20%20%20Erase%20again%2C%20and%20then%0A%20%20%20%20%20%20%20%20A%20poppy%20blooms.%0A%20%20%20%20%20%20%20%20-%20Katsushika%20Hokusai%22%3B%0A%20%20%20%20println!(%22%7B%7D%22%2C%20haiku)%3B%0A%20%20%20%20%0A%20%20%20%20%0A%20%20%20%20println!(%22salutare%20%5C%0A%20%20%20%20lume%22)%20%2F%2F%20observati%20cum%20spatierea%20de%20dinainte%20de%20%22l%22%20este%20ignorata%0A%7D%0A +- title: Șiruri de caractere literale brute + content_markdown: > + Șiruri de caractere brute (în engleză *raw strings*) ne permit scrierea unei secvente de caractere, + cuvânt cu cuvânt, începând cu `r#"` și terminând cu `"#`. Acest lucru ne permite să inserăm + + caractere care altfel ne-ar putea face să confundăm un șir de caractere normal cu unul literal + (cum ar fi ghilimele duble și backslash-urile). + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20%7B%0A%20%20%20%20let%20a%3A%20%26'static%20str%20%3D%20r%23%22%0A%20%20%20%20%20%20%20%20%3Cdiv%20class%3D%22sfat%22%3E%0A%20%20%20%20%20%20%20%20%20%20%20%20Sirurile%20de%20caractere%20brute%20sunt%20folositoare%20in%20unele%20situatii.%0A%20%20%20%20%20%20%20%20%3C%2Fdiv%3E%0A%20%20%20%20%20%20%20%20%22%23%3B%0A%20%20%20%20println!(%22%7B%7D%22%2C%20a)%3B%0A%7D%0A +- title: Șiruri de caractere literale din fisiere + content_markdown: > + Dacă aveți un text foarte mare, luați în considerare utilizarea macroului `include_str!` pentru + a include text din fișiere locale în programul dumneavoastră: + + + ```rust + + let salut_html = include_str!("salut.html"); + + ``` +- title: Subșiruri de caractere + content_markdown: > + Un subșir de caractere (în engleză *string slice*) este o referință la o secvență de octeți din memorie ce trebuie + întotdeauna să fie în format utf-8 valid. + + Un subșir al unui subșir (în engleză *sub-slice*) de `str`, trebuie să fie, de asemenea, în format utf-8 valid. + + + Metode comune ale `&str`: + + * `len` obține lungimea șirului literal în octeți (nu numărul de caractere). + + * `starts_with`/`ends_with` pentru teste de bază. + + * `is_empty` returnează *true* dacă lungimea este zero. + + * `find` returnează un `Option` al primei poziții dintr-un text. + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20%7B%0A%20%20%20%20let%20a%20%3D%20%22salut%20%F0%9F%A6%80%22%3B%0A%20%20%20%20println!(%22%7B%7D%22%2C%20a.len())%3B%0A%20%20%20%20let%20primul_cuvant%20%3D%20%26a%5B0..5%5D%3B%0A%20%20%20%20let%20al_doilea_cuvant%20%3D%20%26a%5B6..10%5D%3B%0A%20%20%20%20%2F%2F%20let%20jumatate_de_crab%20%3D%20%26a%5B6..8%5D%3B%20E%C8%98UEAZ%C4%82%0A%20%20%20%20%2F%2F%20Rust%20nu%20accepta%20subsiruri%20formate%20din%20caractere%20Unicode%20invalide%0A%20%20%20%20println!(%22%7B%7D%20%7B%7D%22%2C%20primul_cuvant%2C%20al_doilea_cuvant)%3B%0A%7D%0A +- title: Tipul `char` + content_markdown: > + Cu atâtea dificultăți în lucrul cu Unicode, Rust oferă o modalitate de a + prelua o secvență de octeți utf-8 ca un vector de caractere de tip `char`. + + + Un `char` are întotdeauna o lungime de 4 octeți (ceea ce permite o căutare eficientă după caractere individuale). + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20%7B%0A%20%20%20%20%2F%2F%20colecteaza%20caracterele%20ca%20vector%20de%20char-uri%0A%20%20%20%20let%20chars%20%3D%20%22salut%20%F0%9F%A6%80%22.chars().collect%3A%3A%3CVec%3Cchar%3E%3E()%3B%0A%20%20%20%20println!(%22%7B%7D%22%2C%20chars.len())%3B%20%2F%2F%20ar%20trebui%20sa%20fie%207%0A%20%20%20%20%2F%2F%20cum%20un%20char%20ocupa%204%20biti%2C%20putem%20converti%20la%20u32%0A%20%20%20%20println!(%22%7B%7D%22%2C%20chars%5B3%5D%20as%20u32)%3B%0A%7D%0A +- title: Șiruri de caractere + content_markdown: > + Un șir de caractere (în engleză *string*) este o structură care deține o secvență de octeți utf-8 în memoria heap. + + + Deoarece memoria sa se află în heap, aceasta poate fi extinsă, modificată etc. în moduri în care șirurile + de caractere literale nu pot fi modificate. + + + Metode comune: + + + * `push_str` pentru a adăuga mai mulți octeți utf-8 la sfârșitul unui șir de caractere. + + * `replace` pentru a înlocui secvențe de octeți utf-8 cu altele. + + * `to_lowercase`/`to_uppercase` pentru a schimba între majuscule și minuscule. + + * `trim` pentru eliminarea spatiilor. + + + Atunci când un șir de caractere este eliminat (drop), este eliminată și memoria heap a acestuia. + + + Șirile de caractere au un operator `+` care extinde șirul cu un `&str`. (Șirul din stânga este `consumat`, iar buffer-ul lui + este refolosit pentru a stoca valoarea finală. Șirul din dreapta este doar împrumutat pentru a efectua concatenarea.) + dar s-ar putea să nu fie atât de ergonomic pe cât sperați. + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20%7B%0A%20%20%20%20let%20mut%20salutarelume%20%3D%20String%3A%3Afrom(%22salutare%22)%3B%0A%20%20%20%20salutarelume.push_str(%22%20lume%22)%3B%0A%20%20%20%20salutarelume%20%3D%20salutarelume%20%2B%20%22!%22%3B%0A%20%20%20%20println!(%22%7B%7D%22%2C%20salutarelume)%3B%0A%7D%0A +- title: Text ca parametru de funcție + content_markdown: > + Șirurile de caractere (literale) sunt în general transmise către funcții sub forma unui subșir. + + Acest lucru oferă o mare flexibilitate în majoritatea scenariilor, cand nu este nevoie + să transmiteți de fapt proprietatea (ownership). + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20spune_tare(msg%3A%26str)%7B%0A%20%20%20%20println!(%22%7B%7D!!!%22%2Cmsg.to_string().to_uppercase())%3B%0A%7D%0A%0Afn%20main()%20%7B%0A%20%20%20%20%2F%2F%20spune_tare%20poate%20imprumuta%20un%20%26'static%20str%20ca%20%26str%0A%20%20%20%20spune_tare(%22salut%22)%3B%0A%20%20%20%20%2F%2F%20spune_tare%20poate%2C%20de%20asemenea%2C%20imprumuta%20un%20String%20ca%20%26str%0A%20%20%20%20spune_tare(%26String%3A%3Afrom(%22la%20revedere%22))%3B%0A%7D%0A +- title: Construirea șirurilor de caractere + content_markdown: | + `concat` și `join` sunt două moduri simple, dar eficiente de a construi șiruri de caractere. + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20%7B%0A%20%20%20%20let%20salutarelume%20%3D%20%5B%22salutare%22%2C%20%22%20%22%2C%20%22lume%22%2C%20%22!%22%5D.concat()%3B%0A%20%20%20%20let%20abc%20%3D%20%5B%22a%22%2C%20%22b%22%2C%20%22c%22%5D.join(%22%2C%22)%3B%0A%20%20%20%20println!(%22%7B%7D%22%2C%20salutarelume)%3B%0A%20%20%20%20println!(%22%7B%7D%22%2Cabc)%3B%0A%7D%0A +- title: Formatarea șirurilor de caractere + content_markdown: > + Macroul `format!` ne permite să creăm un șir de caractere prin definirea unui șir parametrizat + cu poziții pentru locul și modul în care trebuie plasate valorile (exemplu: `{}`). + + + `format!` utilizează aceleași șiruri parametrizate ca și `println!`. + + + Capabilitățile acestei funcții sunt de o amploare prea mare pentru *Turul limbajului Rust*; + consultați documentația [aici](https://doc.rust-lang.org/std/fmt/). + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20%7B%0A%20%20%20%20let%20a%20%3D%2042%3B%0A%20%20%20%20let%20f%20%3D%20format!(%22secretul%20vietii%3A%20%7B%7D%22%2Ca)%3B%0A%20%20%20%20println!(%22%7B%7D%22%2Cf)%3B%0A%7D%0A +- title: Convertirea șirurilor de caractere + content_markdown: | + Multe tipuri pot fi convertite într-un șir de caractere folosind `to_string`. + + Funcția generică `parse` poate fi utilizată pentru a converti șiruri de caractere (literale) + într-o valoare tipizată. Această funcție returnează un `Result` deoarece ar putea eșua. + code: >- + https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&code=fn%20main()%20-%3E%20Result%3C()%2C%20std%3A%3Anum%3A%3AParseIntError%3E%20%7B%0A%20%20%20%20let%20a%20%3D%2042%3B%0A%20%20%20%20let%20a_string%20%3D%20a.to_string()%3B%0A%20%20%20%20let%20b%20%3D%20a_string.parse%3A%3A%3Ci32%3E()%3F%3B%0A%20%20%20%20println!(%22%7B%7D%20%7B%7D%22%2C%20a%2C%20b)%3B%0A%20%20%20%20Ok(())%0A%7D%0A +- title: Capitolul 6 - Concluzie + content_markdown: > + Acum cunoașteți elementele de bază ale textului! După cum ați văzut, Unicode face lucrul + cu textul puțin mai complicat, dar biblioteca standard + + are o mulțime de funcționalități care facilitează gestionarea acestuia. + + + Până acum, am privit limbajul Rust în mare parte prin prisma unei paradigme procedurale + (adică doar funcții și date), + + dar este momentul să vorbim acum despre trăsături și despre capacitățile dezvăluite de + paradigma orientată pe obiecte a limbajului Rust.