.. module:: texts

Paraules en un text
-------------------

Dissenya les funcions següents i desa-les al mòdul :mod:`texts`
(fitxer :file:`texts.py`).

.. function:: compta_paraules_linia(linia, paraules)

   `linia` és el text d'una línia (:class:`str`).

   `paraules` és una llista de paraules.

   Retorna un *string* que conté parelles formades per una paraula de
   `paraules` i el nombre de vegades que surt la paraula a `linia`. Hi
   ha d'haver totes les paraules de `paraules` que surten algun
   cop a `linia` i en el mateix ordre en què estan a `paraules`.

   Cal comptar les paraules tant si apareixen senceres com si són un
   tros d'una paraula més llarga. Les paraules poden aparèixer tant a
   `linia` com a `paraules` amb qualsevol combinació de lletres
   majúscules i minúscules. Al resultat, han d'aparèixer en
   minúscules.

   Per exemple:

   .. literalinclude:: test-compta_paraules_linia.txt
      :language: pycon
      :start-after: ---- inici
      :end-before: ---- fi

   Trobaràs més tests al fitxer
   :download:`test-compta_paraules_linia.txt`.

|

.. function:: escriu_paraules_linies(nftext, paraules, nfresultat)

   `nftext` és el nom d'un fitxer que conté un text.

   `paraules` és una llista de paraules.

   `nfresultat` és el nom del fitxer on s'ha d'escriure el resultat.

   Escriu al fitxer `nfresultat` una línia per cada línia del fitxer
   `nftext` que contingui alguna de les paraules de la llista
   `paraules`.

   El format de les línies del fitxer `nfresultat` ha de ser: el
   número de línia del fitxer `nftext` a què correspon separat per un
   espai en blanc de les parelles formades per una paraula de
   `paraules` i el nombre de vegades que surt la paraula a `linia`. El
   format d'aquestes parelles ha de ser el mateix que el resultat de
   la funció :func:`~compta_paraules_linia`.

   Per exemple:

   .. literalinclude:: test-escriu_paraules_linies.txt
      :language: pycon
      :start-after: ---- inici
      :end-before: ---- fi

   Trobaràs més tests al fitxer
   :download:`test-escriu_paraules_linies.txt`.