add pdf
This commit is contained in:
stsh
parent
f86c03e000
commit
674695e82a
Binary file not shown.
|
Before Width: | Height: | Size: 28 KiB |
101
LICRcyr2utf8.xdy
101
LICRcyr2utf8.xdy
|
|
@ -1,101 +0,0 @@
|
||||||
;; -*- coding: utf-8; mode: Lisp; -*-
|
|
||||||
;; style file for xindy
|
|
||||||
;; filename: LICRcyr2utf8.xdy
|
|
||||||
;; description: style file for xindy which maps back LaTeX Internal
|
|
||||||
;; Character Representation of Cyrillic to utf-8
|
|
||||||
;; usage: for use with pdflatex produced .idx files.
|
|
||||||
;; Contributed by the Sphinx team, July 2018.
|
|
||||||
(merge-rule "\IeC {\'\CYRG }" "Ѓ" :string)
|
|
||||||
(merge-rule "\IeC {\'\CYRK }" "Ќ" :string)
|
|
||||||
(merge-rule "\IeC {\'\cyrg }" "ѓ" :string)
|
|
||||||
(merge-rule "\IeC {\'\cyrk }" "ќ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRA }" "А" :string)
|
|
||||||
(merge-rule "\IeC {\CYRB }" "Б" :string)
|
|
||||||
(merge-rule "\IeC {\CYRC }" "Ц" :string)
|
|
||||||
(merge-rule "\IeC {\CYRCH }" "Ч" :string)
|
|
||||||
(merge-rule "\IeC {\CYRD }" "Д" :string)
|
|
||||||
(merge-rule "\IeC {\CYRDJE }" "Ђ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRDZE }" "Ѕ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRDZHE }" "Џ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRE }" "Е" :string)
|
|
||||||
(merge-rule "\IeC {\CYREREV }" "Э" :string)
|
|
||||||
(merge-rule "\IeC {\CYRERY }" "Ы" :string)
|
|
||||||
(merge-rule "\IeC {\CYRF }" "Ф" :string)
|
|
||||||
(merge-rule "\IeC {\CYRG }" "Г" :string)
|
|
||||||
(merge-rule "\IeC {\CYRGUP }" "Ґ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRH }" "Х" :string)
|
|
||||||
(merge-rule "\IeC {\CYRHRDSN }" "Ъ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRI }" "И" :string)
|
|
||||||
(merge-rule "\IeC {\CYRIE }" "Є" :string)
|
|
||||||
(merge-rule "\IeC {\CYRII }" "І" :string)
|
|
||||||
(merge-rule "\IeC {\CYRISHRT }" "Й" :string)
|
|
||||||
(merge-rule "\IeC {\CYRJE }" "Ј" :string)
|
|
||||||
(merge-rule "\IeC {\CYRK }" "К" :string)
|
|
||||||
(merge-rule "\IeC {\CYRL }" "Л" :string)
|
|
||||||
(merge-rule "\IeC {\CYRLJE }" "Љ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRM }" "М" :string)
|
|
||||||
(merge-rule "\IeC {\CYRN }" "Н" :string)
|
|
||||||
(merge-rule "\IeC {\CYRNJE }" "Њ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRO }" "О" :string)
|
|
||||||
(merge-rule "\IeC {\CYRP }" "П" :string)
|
|
||||||
(merge-rule "\IeC {\CYRR }" "Р" :string)
|
|
||||||
(merge-rule "\IeC {\CYRS }" "С" :string)
|
|
||||||
(merge-rule "\IeC {\CYRSFTSN }" "Ь" :string)
|
|
||||||
(merge-rule "\IeC {\CYRSH }" "Ш" :string)
|
|
||||||
(merge-rule "\IeC {\CYRSHCH }" "Щ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRT }" "Т" :string)
|
|
||||||
(merge-rule "\IeC {\CYRTSHE }" "Ћ" :string)
|
|
||||||
(merge-rule "\IeC {\CYRU }" "У" :string)
|
|
||||||
(merge-rule "\IeC {\CYRUSHRT }" "Ў" :string)
|
|
||||||
(merge-rule "\IeC {\CYRV }" "В" :string)
|
|
||||||
(merge-rule "\IeC {\CYRYA }" "Я" :string)
|
|
||||||
(merge-rule "\IeC {\CYRYI }" "Ї" :string)
|
|
||||||
(merge-rule "\IeC {\CYRYO }" "Ё" :string)
|
|
||||||
(merge-rule "\IeC {\CYRYU }" "Ю" :string)
|
|
||||||
(merge-rule "\IeC {\CYRZ }" "З" :string)
|
|
||||||
(merge-rule "\IeC {\CYRZH }" "Ж" :string)
|
|
||||||
(merge-rule "\IeC {\cyra }" "а" :string)
|
|
||||||
(merge-rule "\IeC {\cyrb }" "б" :string)
|
|
||||||
(merge-rule "\IeC {\cyrc }" "ц" :string)
|
|
||||||
(merge-rule "\IeC {\cyrch }" "ч" :string)
|
|
||||||
(merge-rule "\IeC {\cyrd }" "д" :string)
|
|
||||||
(merge-rule "\IeC {\cyrdje }" "ђ" :string)
|
|
||||||
(merge-rule "\IeC {\cyrdze }" "ѕ" :string)
|
|
||||||
(merge-rule "\IeC {\cyrdzhe }" "џ" :string)
|
|
||||||
(merge-rule "\IeC {\cyre }" "е" :string)
|
|
||||||
(merge-rule "\IeC {\cyrerev }" "э" :string)
|
|
||||||
(merge-rule "\IeC {\cyrery }" "ы" :string)
|
|
||||||
(merge-rule "\IeC {\cyrf }" "ф" :string)
|
|
||||||
(merge-rule "\IeC {\cyrg }" "г" :string)
|
|
||||||
(merge-rule "\IeC {\cyrgup }" "ґ" :string)
|
|
||||||
(merge-rule "\IeC {\cyrh }" "х" :string)
|
|
||||||
(merge-rule "\IeC {\cyrhrdsn }" "ъ" :string)
|
|
||||||
(merge-rule "\IeC {\cyri }" "и" :string)
|
|
||||||
(merge-rule "\IeC {\cyrie }" "є" :string)
|
|
||||||
(merge-rule "\IeC {\cyrii }" "і" :string)
|
|
||||||
(merge-rule "\IeC {\cyrishrt }" "й" :string)
|
|
||||||
(merge-rule "\IeC {\cyrje }" "ј" :string)
|
|
||||||
(merge-rule "\IeC {\cyrk }" "к" :string)
|
|
||||||
(merge-rule "\IeC {\cyrl }" "л" :string)
|
|
||||||
(merge-rule "\IeC {\cyrlje }" "љ" :string)
|
|
||||||
(merge-rule "\IeC {\cyrm }" "м" :string)
|
|
||||||
(merge-rule "\IeC {\cyrn }" "н" :string)
|
|
||||||
(merge-rule "\IeC {\cyrnje }" "њ" :string)
|
|
||||||
(merge-rule "\IeC {\cyro }" "о" :string)
|
|
||||||
(merge-rule "\IeC {\cyrp }" "п" :string)
|
|
||||||
(merge-rule "\IeC {\cyrr }" "р" :string)
|
|
||||||
(merge-rule "\IeC {\cyrs }" "с" :string)
|
|
||||||
(merge-rule "\IeC {\cyrsftsn }" "ь" :string)
|
|
||||||
(merge-rule "\IeC {\cyrsh }" "ш" :string)
|
|
||||||
(merge-rule "\IeC {\cyrshch }" "щ" :string)
|
|
||||||
(merge-rule "\IeC {\cyrt }" "т" :string)
|
|
||||||
(merge-rule "\IeC {\cyrtshe }" "ћ" :string)
|
|
||||||
(merge-rule "\IeC {\cyru }" "у" :string)
|
|
||||||
(merge-rule "\IeC {\cyrushrt }" "ў" :string)
|
|
||||||
(merge-rule "\IeC {\cyrv }" "в" :string)
|
|
||||||
(merge-rule "\IeC {\cyrya }" "я" :string)
|
|
||||||
(merge-rule "\IeC {\cyryi }" "ї" :string)
|
|
||||||
(merge-rule "\IeC {\cyryo }" "ё" :string)
|
|
||||||
(merge-rule "\IeC {\cyryu }" "ю" :string)
|
|
||||||
(merge-rule "\IeC {\cyrz }" "з" :string)
|
|
||||||
(merge-rule "\IeC {\cyrzh }" "ж" :string)
|
|
||||||
|
|
@ -1,239 +0,0 @@
|
||||||
;; style file for xindy
|
|
||||||
;; filename: LICRlatin2utf8.xdy
|
|
||||||
;; description: style file for xindy which maps back LaTeX Internal
|
|
||||||
;; Character Representation of letters (as arising in .idx index
|
|
||||||
;; file) to UTF-8 encoding for correct sorting by xindy.
|
|
||||||
;; usage: for use with the pdflatex engine,
|
|
||||||
;; *not* for use with xelatex or lualatex.
|
|
||||||
;;
|
|
||||||
;; This is based upon xindy's distributed file tex/inputenc/utf8.xdy.
|
|
||||||
;; The modifications include:
|
|
||||||
;;
|
|
||||||
;; - Updates for compatibility with current LaTeX macro encoding.
|
|
||||||
;;
|
|
||||||
;; - Systematic usage of the \IeC {...} mark-up, because mark-up in
|
|
||||||
;; tex/inputenc/utf8.xdy was using it on seemingly random basis, and
|
|
||||||
;; Sphinx coercing of xindy usability for both Latin and Cyrillic scripts
|
|
||||||
;; with pdflatex requires its systematic presence here.
|
|
||||||
;;
|
|
||||||
;; - Support for some extra letters: Ÿ, Ŋ, ŋ, Œ, œ, IJ, ij, ȷ and ẞ.
|
|
||||||
;;
|
|
||||||
;; Indeed Sphinx needs to support for pdflatex engine all Unicode letters
|
|
||||||
;; available in TeX T1 font encoding. The above letters are found in
|
|
||||||
;; that encoding but not in the Latin1, 2, 3 charsets which are those
|
|
||||||
;; covered by original tex/inputenc/utf8.xdy.
|
|
||||||
;;
|
|
||||||
;; - There is a problem that ȷ is not supported out-of-the box by LaTeX
|
|
||||||
;; with inputenc, one must add explicitly
|
|
||||||
;; \DeclareUnicodeCharacter{0237}{\j}
|
|
||||||
;; to preamble of LaTeX document. However this character is not supported
|
|
||||||
;; by the TeX "times" font used by default by Sphinx for pdflatex engine.
|
|
||||||
;;
|
|
||||||
;; **Update**: since LaTeX 2018/12/01, the \j as well as \SS, \k{} and
|
|
||||||
;; \.{} need no extra user declaration anymore.
|
|
||||||
;;
|
|
||||||
;; - ẞ needs \DeclareUnicodeCharacter{1E9E}{\SS} (but ß needs no extra set-up).
|
|
||||||
;;
|
|
||||||
;; - U+02DB (˛) and U+02D9 (˙) are also not supported by inputenc
|
|
||||||
;; out of the box and require
|
|
||||||
;; \DeclareUnicodeCharacter{02DB}{\k{}}
|
|
||||||
;; \DeclareUnicodeCharacter{02D9}{\.{}}
|
|
||||||
;; to be added to preamble.
|
|
||||||
;;
|
|
||||||
;; - U+0127 ħ and U+0126 Ħ are absent from TeX T1+TS1 font encodings.
|
|
||||||
;;
|
|
||||||
;; - Characters Ŋ and ŋ are not supported by TeX font "times" used by
|
|
||||||
;; default by Sphinx for pdflatex engine but they are supported by
|
|
||||||
;; some TeX fonts, in particular by the default LaTeX font for T1
|
|
||||||
;; encoding.
|
|
||||||
;;
|
|
||||||
;; - " and ~ must be escaped as ~" and resp. ~~ in xindy merge rules.
|
|
||||||
;;
|
|
||||||
;; Contributed by the Sphinx team, July 2018.
|
|
||||||
;;
|
|
||||||
;; See sphinx.xdy for superior figures, as they are escaped by LaTeX writer.
|
|
||||||
(merge-rule "\IeC {\textonesuperior }" "¹" :string)
|
|
||||||
(merge-rule "\IeC {\texttwosuperior }" "²" :string)
|
|
||||||
(merge-rule "\IeC {\textthreesuperior }" "³" :string)
|
|
||||||
(merge-rule "\IeC {\'a}" "á" :string)
|
|
||||||
(merge-rule "\IeC {\'A}" "Á" :string)
|
|
||||||
(merge-rule "\IeC {\`a}" "à" :string)
|
|
||||||
(merge-rule "\IeC {\`A}" "À" :string)
|
|
||||||
(merge-rule "\IeC {\^a}" "â" :string)
|
|
||||||
(merge-rule "\IeC {\^A}" "Â" :string)
|
|
||||||
(merge-rule "\IeC {\~"a}" "ä" :string)
|
|
||||||
(merge-rule "\IeC {\~"A}" "Ä" :string)
|
|
||||||
(merge-rule "\IeC {\~~a}" "ã" :string)
|
|
||||||
(merge-rule "\IeC {\~~A}" "Ã" :string)
|
|
||||||
(merge-rule "\IeC {\c c}" "ç" :string)
|
|
||||||
(merge-rule "\IeC {\c C}" "Ç" :string)
|
|
||||||
(merge-rule "\IeC {\'c}" "ć" :string)
|
|
||||||
(merge-rule "\IeC {\'C}" "Ć" :string)
|
|
||||||
(merge-rule "\IeC {\^c}" "ĉ" :string)
|
|
||||||
(merge-rule "\IeC {\^C}" "Ĉ" :string)
|
|
||||||
(merge-rule "\IeC {\.c}" "ċ" :string)
|
|
||||||
(merge-rule "\IeC {\.C}" "Ċ" :string)
|
|
||||||
(merge-rule "\IeC {\c s}" "ş" :string)
|
|
||||||
(merge-rule "\IeC {\c S}" "Ş" :string)
|
|
||||||
(merge-rule "\IeC {\c t}" "ţ" :string)
|
|
||||||
(merge-rule "\IeC {\c T}" "Ţ" :string)
|
|
||||||
(merge-rule "\IeC {\-}" "" :string); soft hyphen
|
|
||||||
(merge-rule "\IeC {\textdiv }" "÷" :string)
|
|
||||||
(merge-rule "\IeC {\'e}" "é" :string)
|
|
||||||
(merge-rule "\IeC {\'E}" "É" :string)
|
|
||||||
(merge-rule "\IeC {\`e}" "è" :string)
|
|
||||||
(merge-rule "\IeC {\`E}" "È" :string)
|
|
||||||
(merge-rule "\IeC {\^e}" "ê" :string)
|
|
||||||
(merge-rule "\IeC {\^E}" "Ê" :string)
|
|
||||||
(merge-rule "\IeC {\~"e}" "ë" :string)
|
|
||||||
(merge-rule "\IeC {\~"E}" "Ë" :string)
|
|
||||||
(merge-rule "\IeC {\^g}" "ĝ" :string)
|
|
||||||
(merge-rule "\IeC {\^G}" "Ĝ" :string)
|
|
||||||
(merge-rule "\IeC {\.g}" "ġ" :string)
|
|
||||||
(merge-rule "\IeC {\.G}" "Ġ" :string)
|
|
||||||
(merge-rule "\IeC {\^h}" "ĥ" :string)
|
|
||||||
(merge-rule "\IeC {\^H}" "Ĥ" :string)
|
|
||||||
(merge-rule "\IeC {\H o}" "ő" :string)
|
|
||||||
(merge-rule "\IeC {\H O}" "Ő" :string)
|
|
||||||
(merge-rule "\IeC {\textacutedbl }" "˝" :string)
|
|
||||||
(merge-rule "\IeC {\H u}" "ű" :string)
|
|
||||||
(merge-rule "\IeC {\H U}" "Ű" :string)
|
|
||||||
(merge-rule "\IeC {\ae }" "æ" :string)
|
|
||||||
(merge-rule "\IeC {\AE }" "Æ" :string)
|
|
||||||
(merge-rule "\IeC {\textcopyright }" "©" :string)
|
|
||||||
(merge-rule "\IeC {\c \ }" "¸" :string)
|
|
||||||
(merge-rule "\IeC {\dh }" "ð" :string)
|
|
||||||
(merge-rule "\IeC {\DH }" "Ð" :string)
|
|
||||||
(merge-rule "\IeC {\dj }" "đ" :string)
|
|
||||||
(merge-rule "\IeC {\DJ }" "Đ" :string)
|
|
||||||
(merge-rule "\IeC {\guillemotleft }" "«" :string)
|
|
||||||
(merge-rule "\IeC {\guillemotright }" "»" :string)
|
|
||||||
(merge-rule "\IeC {\'\i }" "í" :string)
|
|
||||||
(merge-rule "\IeC {\`\i }" "ì" :string)
|
|
||||||
(merge-rule "\IeC {\^\i }" "î" :string)
|
|
||||||
(merge-rule "\IeC {\~"\i }" "ï" :string)
|
|
||||||
(merge-rule "\IeC {\i }" "ı" :string)
|
|
||||||
(merge-rule "\IeC {\^\j }" "ĵ" :string)
|
|
||||||
(merge-rule "\IeC {\k {}}" "˛" :string)
|
|
||||||
(merge-rule "\IeC {\l }" "ł" :string)
|
|
||||||
(merge-rule "\IeC {\L }" "Ł" :string)
|
|
||||||
(merge-rule "\IeC {\nobreakspace }" " " :string)
|
|
||||||
(merge-rule "\IeC {\o }" "ø" :string)
|
|
||||||
(merge-rule "\IeC {\O }" "Ø" :string)
|
|
||||||
(merge-rule "\IeC {\textsterling }" "£" :string)
|
|
||||||
(merge-rule "\IeC {\textparagraph }" "¶" :string)
|
|
||||||
(merge-rule "\IeC {\ss }" "ß" :string)
|
|
||||||
(merge-rule "\IeC {\textsection }" "§" :string)
|
|
||||||
(merge-rule "\IeC {\textbrokenbar }" "¦" :string)
|
|
||||||
(merge-rule "\IeC {\textcent }" "¢" :string)
|
|
||||||
(merge-rule "\IeC {\textcurrency }" "¤" :string)
|
|
||||||
(merge-rule "\IeC {\textdegree }" "°" :string)
|
|
||||||
(merge-rule "\IeC {\textexclamdown }" "¡" :string)
|
|
||||||
(merge-rule "\IeC {\texthbar }" "ħ" :string)
|
|
||||||
(merge-rule "\IeC {\textHbar }" "Ħ" :string)
|
|
||||||
(merge-rule "\IeC {\textonehalf }" "½" :string)
|
|
||||||
(merge-rule "\IeC {\textonequarter }" "¼" :string)
|
|
||||||
(merge-rule "\IeC {\textordfeminine }" "ª" :string)
|
|
||||||
(merge-rule "\IeC {\textordmasculine }" "º" :string)
|
|
||||||
(merge-rule "\IeC {\textperiodcentered }" "·" :string)
|
|
||||||
(merge-rule "\IeC {\textquestiondown }" "¿" :string)
|
|
||||||
(merge-rule "\IeC {\textregistered }" "®" :string)
|
|
||||||
(merge-rule "\IeC {\textthreequarters }" "¾" :string)
|
|
||||||
(merge-rule "\IeC {\textyen }" "¥" :string)
|
|
||||||
(merge-rule "\IeC {\th }" "þ" :string)
|
|
||||||
(merge-rule "\IeC {\TH }" "Þ" :string)
|
|
||||||
(merge-rule "\IeC {\'I}" "Í" :string)
|
|
||||||
(merge-rule "\IeC {\`I}" "Ì" :string)
|
|
||||||
(merge-rule "\IeC {\^I}" "Î" :string)
|
|
||||||
(merge-rule "\IeC {\~"I}" "Ï" :string)
|
|
||||||
(merge-rule "\IeC {\.I}" "İ" :string)
|
|
||||||
(merge-rule "\IeC {\^J}" "Ĵ" :string)
|
|
||||||
(merge-rule "\IeC {\k a}" "ą" :string)
|
|
||||||
(merge-rule "\IeC {\k A}" "Ą" :string)
|
|
||||||
(merge-rule "\IeC {\k e}" "ę" :string)
|
|
||||||
(merge-rule "\IeC {\k E}" "Ę" :string)
|
|
||||||
(merge-rule "\IeC {\'l}" "ĺ" :string)
|
|
||||||
(merge-rule "\IeC {\'L}" "Ĺ" :string)
|
|
||||||
(merge-rule "\IeC {\textlnot }" "¬" :string)
|
|
||||||
(merge-rule "\IeC {\textmu }" "µ" :string)
|
|
||||||
(merge-rule "\IeC {\'n}" "ń" :string)
|
|
||||||
(merge-rule "\IeC {\'N}" "Ń" :string)
|
|
||||||
(merge-rule "\IeC {\~~n}" "ñ" :string)
|
|
||||||
(merge-rule "\IeC {\~~N}" "Ñ" :string)
|
|
||||||
(merge-rule "\IeC {\'o}" "ó" :string)
|
|
||||||
(merge-rule "\IeC {\'O}" "Ó" :string)
|
|
||||||
(merge-rule "\IeC {\`o}" "ò" :string)
|
|
||||||
(merge-rule "\IeC {\`O}" "Ò" :string)
|
|
||||||
(merge-rule "\IeC {\^o}" "ô" :string)
|
|
||||||
(merge-rule "\IeC {\^O}" "Ô" :string)
|
|
||||||
(merge-rule "\IeC {\~"o}" "ö" :string)
|
|
||||||
(merge-rule "\IeC {\~"O}" "Ö" :string)
|
|
||||||
(merge-rule "\IeC {\~~o}" "õ" :string)
|
|
||||||
(merge-rule "\IeC {\~~O}" "Õ" :string)
|
|
||||||
(merge-rule "\IeC {\textpm }" "±" :string)
|
|
||||||
(merge-rule "\IeC {\r a}" "å" :string)
|
|
||||||
(merge-rule "\IeC {\r A}" "Å" :string)
|
|
||||||
(merge-rule "\IeC {\'r}" "ŕ" :string)
|
|
||||||
(merge-rule "\IeC {\'R}" "Ŕ" :string)
|
|
||||||
(merge-rule "\IeC {\r u}" "ů" :string)
|
|
||||||
(merge-rule "\IeC {\r U}" "Ů" :string)
|
|
||||||
(merge-rule "\IeC {\'s}" "ś" :string)
|
|
||||||
(merge-rule "\IeC {\'S}" "Ś" :string)
|
|
||||||
(merge-rule "\IeC {\^s}" "ŝ" :string)
|
|
||||||
(merge-rule "\IeC {\^S}" "Ŝ" :string)
|
|
||||||
(merge-rule "\IeC {\textasciidieresis }" "¨" :string)
|
|
||||||
(merge-rule "\IeC {\textasciimacron }" "¯" :string)
|
|
||||||
(merge-rule "\IeC {\.{}}" "˙" :string)
|
|
||||||
(merge-rule "\IeC {\textasciiacute }" "´" :string)
|
|
||||||
(merge-rule "\IeC {\texttimes }" "×" :string)
|
|
||||||
(merge-rule "\IeC {\u a}" "ă" :string)
|
|
||||||
(merge-rule "\IeC {\u A}" "Ă" :string)
|
|
||||||
(merge-rule "\IeC {\u g}" "ğ" :string)
|
|
||||||
(merge-rule "\IeC {\u G}" "Ğ" :string)
|
|
||||||
(merge-rule "\IeC {\textasciibreve }" "˘" :string)
|
|
||||||
(merge-rule "\IeC {\'u}" "ú" :string)
|
|
||||||
(merge-rule "\IeC {\'U}" "Ú" :string)
|
|
||||||
(merge-rule "\IeC {\`u}" "ù" :string)
|
|
||||||
(merge-rule "\IeC {\`U}" "Ù" :string)
|
|
||||||
(merge-rule "\IeC {\^u}" "û" :string)
|
|
||||||
(merge-rule "\IeC {\^U}" "Û" :string)
|
|
||||||
(merge-rule "\IeC {\~"u}" "ü" :string)
|
|
||||||
(merge-rule "\IeC {\~"U}" "Ü" :string)
|
|
||||||
(merge-rule "\IeC {\u u}" "ŭ" :string)
|
|
||||||
(merge-rule "\IeC {\u U}" "Ŭ" :string)
|
|
||||||
(merge-rule "\IeC {\v c}" "č" :string)
|
|
||||||
(merge-rule "\IeC {\v C}" "Č" :string)
|
|
||||||
(merge-rule "\IeC {\v d}" "ď" :string)
|
|
||||||
(merge-rule "\IeC {\v D}" "Ď" :string)
|
|
||||||
(merge-rule "\IeC {\v e}" "ě" :string)
|
|
||||||
(merge-rule "\IeC {\v E}" "Ě" :string)
|
|
||||||
(merge-rule "\IeC {\v l}" "ľ" :string)
|
|
||||||
(merge-rule "\IeC {\v L}" "Ľ" :string)
|
|
||||||
(merge-rule "\IeC {\v n}" "ň" :string)
|
|
||||||
(merge-rule "\IeC {\v N}" "Ň" :string)
|
|
||||||
(merge-rule "\IeC {\v r}" "ř" :string)
|
|
||||||
(merge-rule "\IeC {\v R}" "Ř" :string)
|
|
||||||
(merge-rule "\IeC {\v s}" "š" :string)
|
|
||||||
(merge-rule "\IeC {\v S}" "Š" :string)
|
|
||||||
(merge-rule "\IeC {\textasciicaron }" "ˇ" :string)
|
|
||||||
(merge-rule "\IeC {\v t}" "ť" :string)
|
|
||||||
(merge-rule "\IeC {\v T}" "Ť" :string)
|
|
||||||
(merge-rule "\IeC {\v z}" "ž" :string)
|
|
||||||
(merge-rule "\IeC {\v Z}" "Ž" :string)
|
|
||||||
(merge-rule "\IeC {\'y}" "ý" :string)
|
|
||||||
(merge-rule "\IeC {\'Y}" "Ý" :string)
|
|
||||||
(merge-rule "\IeC {\~"y}" "ÿ" :string)
|
|
||||||
(merge-rule "\IeC {\'z}" "ź" :string)
|
|
||||||
(merge-rule "\IeC {\'Z}" "Ź" :string)
|
|
||||||
(merge-rule "\IeC {\.z}" "ż" :string)
|
|
||||||
(merge-rule "\IeC {\.Z}" "Ż" :string)
|
|
||||||
;; letters not in Latin1, 2, 3 but available in TeX T1 font encoding
|
|
||||||
(merge-rule "\IeC {\~"Y}" "Ÿ" :string)
|
|
||||||
(merge-rule "\IeC {\NG }" "Ŋ" :string)
|
|
||||||
(merge-rule "\IeC {\ng }" "ŋ" :string)
|
|
||||||
(merge-rule "\IeC {\OE }" "Œ" :string)
|
|
||||||
(merge-rule "\IeC {\oe }" "œ" :string)
|
|
||||||
(merge-rule "\IeC {\IJ }" "IJ" :string)
|
|
||||||
(merge-rule "\IeC {\ij }" "ij" :string)
|
|
||||||
(merge-rule "\IeC {\j }" "ȷ" :string)
|
|
||||||
(merge-rule "\IeC {\SS }" "ẞ" :string)
|
|
||||||
607
LatinRules.xdy
607
LatinRules.xdy
|
|
@ -1,607 +0,0 @@
|
||||||
;; style file for xindy
|
|
||||||
;; filename: LatinRules.xdy
|
|
||||||
;;
|
|
||||||
;; It is based upon xindy's files lang/general/utf8.xdy and
|
|
||||||
;; lang/general/utf8-lang.xdy which implement
|
|
||||||
;; "a general sorting order for Western European languages"
|
|
||||||
;;
|
|
||||||
;; The aim for Sphinx is to be able to index in a Cyrillic document
|
|
||||||
;; also terms using the Latin alphabets, inclusive of letters
|
|
||||||
;; with diacritics. To this effect the xindy rules from lang/general
|
|
||||||
;; got manually re-coded to avoid collisions with the encoding
|
|
||||||
;; done by xindy for sorting words in Cyrillic languages, which was
|
|
||||||
;; observed not to use bytes with octal encoding 0o266 or higher.
|
|
||||||
;;
|
|
||||||
;; So here we use only 0o266 or higher bytes.
|
|
||||||
;; (Ŋ, ŋ, IJ, and ij are absent from
|
|
||||||
;; lang/general/utf8.xdy and not included here)
|
|
||||||
;; Contributed by the Sphinx team, 2018.
|
|
||||||
|
|
||||||
(define-letter-group "A" :prefixes ("¶"))
|
|
||||||
(define-letter-group "B" :after "A" :prefixes ("·"))
|
|
||||||
(define-letter-group "C" :after "B" :prefixes ("¸"))
|
|
||||||
(define-letter-group "D" :after "C" :prefixes ("¹"))
|
|
||||||
(define-letter-group "E" :after "D" :prefixes ("º"))
|
|
||||||
(define-letter-group "F" :after "E" :prefixes ("»"))
|
|
||||||
(define-letter-group "G" :after "F" :prefixes ("¼"))
|
|
||||||
(define-letter-group "H" :after "G" :prefixes ("½"))
|
|
||||||
(define-letter-group "I" :after "H" :prefixes ("¾"))
|
|
||||||
(define-letter-group "J" :after "I" :prefixes ("¿"))
|
|
||||||
(define-letter-group "K" :after "J" :prefixes ("À"))
|
|
||||||
(define-letter-group "L" :after "K" :prefixes ("Á"))
|
|
||||||
(define-letter-group "M" :after "L" :prefixes ("Â"))
|
|
||||||
(define-letter-group "N" :after "M" :prefixes ("Ã"))
|
|
||||||
(define-letter-group "O" :after "N" :prefixes ("Ä"))
|
|
||||||
(define-letter-group "P" :after "O" :prefixes ("È"))
|
|
||||||
(define-letter-group "Q" :after "P" :prefixes ("Ê"))
|
|
||||||
(define-letter-group "R" :after "Q" :prefixes ("Ë"))
|
|
||||||
(define-letter-group "S" :after "R" :prefixes ("Ð"))
|
|
||||||
(define-letter-group "T" :after "S" :prefixes ("Ú"))
|
|
||||||
(define-letter-group "U" :after "T" :prefixes ("à"))
|
|
||||||
(define-letter-group "V" :after "U" :prefixes ("å"))
|
|
||||||
(define-letter-group "W" :after "V" :prefixes ("æ"))
|
|
||||||
(define-letter-group "X" :after "W" :prefixes ("ë"))
|
|
||||||
(define-letter-group "Y" :after "X" :prefixes ("í"))
|
|
||||||
(define-letter-group "Z" :after "Y" :prefixes ("ð"))
|
|
||||||
|
|
||||||
(define-rule-set "sphinx-xy-alphabetize"
|
|
||||||
|
|
||||||
:rules (("À" "¶" :string)
|
|
||||||
("Ä‚" "¶" :string)
|
|
||||||
("â" "¶" :string)
|
|
||||||
("Ä" "¶" :string)
|
|
||||||
("Ã " "¶" :string)
|
|
||||||
("Ã…" "¶" :string)
|
|
||||||
("Ã" "¶" :string)
|
|
||||||
("Ã<>" "¶" :string)
|
|
||||||
("á" "¶" :string)
|
|
||||||
("ã" "¶" :string)
|
|
||||||
("Â" "¶" :string)
|
|
||||||
("ă" "¶" :string)
|
|
||||||
("Ã¥" "¶" :string)
|
|
||||||
("Ä…" "¶" :string)
|
|
||||||
("ä" "¶" :string)
|
|
||||||
("Ä„" "¶" :string)
|
|
||||||
("æ" "¶º" :string)
|
|
||||||
("Æ" "¶º" :string)
|
|
||||||
("ć" "¸" :string)
|
|
||||||
("ĉ" "¸" :string)
|
|
||||||
("ç" "¸" :string)
|
|
||||||
("ÄŒ" "¸" :string)
|
|
||||||
("Ä<>" "¸" :string)
|
|
||||||
("Ĉ" "¸" :string)
|
|
||||||
("Ç" "¸" :string)
|
|
||||||
("Ć" "¸" :string)
|
|
||||||
("Ä<>" "¹" :string)
|
|
||||||
("Ä<>" "¹" :string)
|
|
||||||
("ÄŽ" "¹" :string)
|
|
||||||
("Ä‘" "¹" :string)
|
|
||||||
("ê" "º" :string)
|
|
||||||
("Ę" "º" :string)
|
|
||||||
("Äš" "º" :string)
|
|
||||||
("ë" "º" :string)
|
|
||||||
("Ä›" "º" :string)
|
|
||||||
("é" "º" :string)
|
|
||||||
("È" "º" :string)
|
|
||||||
("Ë" "º" :string)
|
|
||||||
("É" "º" :string)
|
|
||||||
("è" "º" :string)
|
|
||||||
("Ê" "º" :string)
|
|
||||||
("Ä™" "º" :string)
|
|
||||||
("Ä<>" "¼" :string)
|
|
||||||
("ÄŸ" "¼" :string)
|
|
||||||
("Äž" "¼" :string)
|
|
||||||
("Äœ" "¼" :string)
|
|
||||||
("Ä¥" "½" :string)
|
|
||||||
("Ĥ" "½" :string)
|
|
||||||
("Ã<>" "¾" :string)
|
|
||||||
("Ã<>" "¾" :string)
|
|
||||||
("ï" "¾" :string)
|
|
||||||
("ÃŽ" "¾" :string)
|
|
||||||
("î" "¾" :string)
|
|
||||||
("ı" "¾" :string)
|
|
||||||
("Ä°" "¾" :string)
|
|
||||||
("Ã" "¾" :string)
|
|
||||||
("ÃŒ" "¾" :string)
|
|
||||||
("ì" "¾" :string)
|
|
||||||
("Ä´" "¿" :string)
|
|
||||||
("ĵ" "¿" :string)
|
|
||||||
("Å‚" "Á" :string)
|
|
||||||
("Å<>" "Á" :string)
|
|
||||||
("ľ" "Á" :string)
|
|
||||||
("Ľ" "Á" :string)
|
|
||||||
("Å„" "Ã" :string)
|
|
||||||
("Ń" "Ã" :string)
|
|
||||||
("ñ" "Ã" :string)
|
|
||||||
("ň" "Ã" :string)
|
|
||||||
("Ñ" "Ã" :string)
|
|
||||||
("Ň" "Ã" :string)
|
|
||||||
("Õ" "Ä" :string)
|
|
||||||
("Å<>" "Ä" :string)
|
|
||||||
("ó" "Ä" :string)
|
|
||||||
("ö" "Ä" :string)
|
|
||||||
("ô" "Ä" :string)
|
|
||||||
("Å‘" "Ä" :string)
|
|
||||||
("Ø" "Ä" :string)
|
|
||||||
("Ö" "Ä" :string)
|
|
||||||
("õ" "Ä" :string)
|
|
||||||
("Ô" "Ä" :string)
|
|
||||||
("ø" "Ä" :string)
|
|
||||||
("Ó" "Ä" :string)
|
|
||||||
("Ã’" "Ä" :string)
|
|
||||||
("ò" "Ä" :string)
|
|
||||||
("œ" "ĺ" :string)
|
|
||||||
("Œ" "ĺ" :string)
|
|
||||||
("Ř" "Ë" :string)
|
|
||||||
("Å™" "Ë" :string)
|
|
||||||
("Å”" "Ë" :string)
|
|
||||||
("Å•" "Ë" :string)
|
|
||||||
("Å<>" "Ð" :string)
|
|
||||||
("Åš" "Ð" :string)
|
|
||||||
("È™" "Ð" :string)
|
|
||||||
("ÅŸ" "Ð" :string)
|
|
||||||
("Åœ" "Ð" :string)
|
|
||||||
("Å›" "Ð" :string)
|
|
||||||
("Ș" "Ð" :string)
|
|
||||||
("Å¡" "Ð" :string)
|
|
||||||
("Åž" "Ð" :string)
|
|
||||||
("Å " "Ð" :string)
|
|
||||||
("ß" "ÐÐ" :string)
|
|
||||||
("Èš" "Ú" :string)
|
|
||||||
("Ť" "Ú" :string)
|
|
||||||
("È›" "Ú" :string)
|
|
||||||
("Å¥" "Ú" :string)
|
|
||||||
("û" "à" :string)
|
|
||||||
("Å" "à" :string)
|
|
||||||
("ů" "à" :string)
|
|
||||||
("ű" "à" :string)
|
|
||||||
("ù" "à" :string)
|
|
||||||
("Ŭ" "à" :string)
|
|
||||||
("Ù" "à" :string)
|
|
||||||
("Å°" "à" :string)
|
|
||||||
("Ãœ" "à" :string)
|
|
||||||
("Å®" "à" :string)
|
|
||||||
("ú" "à" :string)
|
|
||||||
("Ú" "à" :string)
|
|
||||||
("Û" "à" :string)
|
|
||||||
("ü" "à" :string)
|
|
||||||
("ÿ" "í" :string)
|
|
||||||
("Ã<>" "í" :string)
|
|
||||||
("Ÿ" "í" :string)
|
|
||||||
("ý" "í" :string)
|
|
||||||
("Å»" "ð" :string)
|
|
||||||
("Ž" "ð" :string)
|
|
||||||
("Ź" "ð" :string)
|
|
||||||
("ž" "ð" :string)
|
|
||||||
("ż" "ð" :string)
|
|
||||||
("ź" "ð" :string)
|
|
||||||
("a" "¶" :string)
|
|
||||||
("A" "¶" :string)
|
|
||||||
("b" "·" :string)
|
|
||||||
("B" "·" :string)
|
|
||||||
("c" "¸" :string)
|
|
||||||
("C" "¸" :string)
|
|
||||||
("d" "¹" :string)
|
|
||||||
("D" "¹" :string)
|
|
||||||
("e" "º" :string)
|
|
||||||
("E" "º" :string)
|
|
||||||
("F" "»" :string)
|
|
||||||
("f" "»" :string)
|
|
||||||
("G" "¼" :string)
|
|
||||||
("g" "¼" :string)
|
|
||||||
("H" "½" :string)
|
|
||||||
("h" "½" :string)
|
|
||||||
("i" "¾" :string)
|
|
||||||
("I" "¾" :string)
|
|
||||||
("J" "¿" :string)
|
|
||||||
("j" "¿" :string)
|
|
||||||
("K" "À" :string)
|
|
||||||
("k" "À" :string)
|
|
||||||
("L" "Á" :string)
|
|
||||||
("l" "Á" :string)
|
|
||||||
("M" "Â" :string)
|
|
||||||
("m" "Â" :string)
|
|
||||||
("n" "Ã" :string)
|
|
||||||
("N" "Ã" :string)
|
|
||||||
("O" "Ä" :string)
|
|
||||||
("o" "Ä" :string)
|
|
||||||
("p" "È" :string)
|
|
||||||
("P" "È" :string)
|
|
||||||
("Q" "Ê" :string)
|
|
||||||
("q" "Ê" :string)
|
|
||||||
("r" "Ë" :string)
|
|
||||||
("R" "Ë" :string)
|
|
||||||
("S" "Ð" :string)
|
|
||||||
("s" "Ð" :string)
|
|
||||||
("t" "Ú" :string)
|
|
||||||
("T" "Ú" :string)
|
|
||||||
("u" "à" :string)
|
|
||||||
("U" "à" :string)
|
|
||||||
("v" "å" :string)
|
|
||||||
("V" "å" :string)
|
|
||||||
("W" "æ" :string)
|
|
||||||
("w" "æ" :string)
|
|
||||||
("x" "ë" :string)
|
|
||||||
("X" "ë" :string)
|
|
||||||
("Y" "í" :string)
|
|
||||||
("y" "í" :string)
|
|
||||||
("z" "ð" :string)
|
|
||||||
("Z" "ð" :string)
|
|
||||||
))
|
|
||||||
|
|
||||||
(define-rule-set "sphinx-xy-resolve-diacritics"
|
|
||||||
|
|
||||||
:rules (("Ĥ" "£" :string)
|
|
||||||
("ó" "£" :string)
|
|
||||||
("ľ" "£" :string)
|
|
||||||
("Ř" "£" :string)
|
|
||||||
("Ä<>" "£" :string)
|
|
||||||
("Ä<>" "£" :string)
|
|
||||||
("Äš" "£" :string)
|
|
||||||
("Ä¥" "£" :string)
|
|
||||||
("ÄŒ" "£" :string)
|
|
||||||
("Ä´" "£" :string)
|
|
||||||
("Ä›" "£" :string)
|
|
||||||
("ž" "£" :string)
|
|
||||||
("ÄŽ" "£" :string)
|
|
||||||
("Å™" "£" :string)
|
|
||||||
("Ž" "£" :string)
|
|
||||||
("ı" "£" :string)
|
|
||||||
("Ť" "£" :string)
|
|
||||||
("á" "£" :string)
|
|
||||||
("Ä<>" "£" :string)
|
|
||||||
("Ã<>" "£" :string)
|
|
||||||
("ň" "£" :string)
|
|
||||||
("Å " "£" :string)
|
|
||||||
("Ň" "£" :string)
|
|
||||||
("ĵ" "£" :string)
|
|
||||||
("Å¥" "£" :string)
|
|
||||||
("Ó" "£" :string)
|
|
||||||
("ý" "£" :string)
|
|
||||||
("Äœ" "£" :string)
|
|
||||||
("Ú" "£" :string)
|
|
||||||
("Ľ" "£" :string)
|
|
||||||
("Å¡" "£" :string)
|
|
||||||
("Ã<>" "£" :string)
|
|
||||||
("ú" "£" :string)
|
|
||||||
("Åš" "¤" :string)
|
|
||||||
("ć" "¤" :string)
|
|
||||||
("Å<>" "¤" :string)
|
|
||||||
("Å‚" "¤" :string)
|
|
||||||
("Å„" "¤" :string)
|
|
||||||
("À" "¤" :string)
|
|
||||||
("Ź" "¤" :string)
|
|
||||||
("Ã " "¤" :string)
|
|
||||||
("Ń" "¤" :string)
|
|
||||||
("Ä<>" "¤" :string)
|
|
||||||
("ÿ" "¤" :string)
|
|
||||||
("Å›" "¤" :string)
|
|
||||||
("Äž" "¤" :string)
|
|
||||||
("ÄŸ" "¤" :string)
|
|
||||||
("Ù" "¤" :string)
|
|
||||||
("Ä°" "¤" :string)
|
|
||||||
("Ä‘" "¤" :string)
|
|
||||||
("ù" "¤" :string)
|
|
||||||
("Èš" "¤" :string)
|
|
||||||
("é" "¤" :string)
|
|
||||||
("Å•" "¤" :string)
|
|
||||||
("Ć" "¤" :string)
|
|
||||||
("È›" "¤" :string)
|
|
||||||
("ò" "¤" :string)
|
|
||||||
("ź" "¤" :string)
|
|
||||||
("Ã’" "¤" :string)
|
|
||||||
("Ÿ" "¤" :string)
|
|
||||||
("Å”" "¤" :string)
|
|
||||||
("É" "¤" :string)
|
|
||||||
("ĉ" "¥" :string)
|
|
||||||
("ô" "¥" :string)
|
|
||||||
("Ã<>" "¥" :string)
|
|
||||||
("Å<>" "¥" :string)
|
|
||||||
("Å»" "¥" :string)
|
|
||||||
("Ä‚" "¥" :string)
|
|
||||||
("Åœ" "¥" :string)
|
|
||||||
("ñ" "¥" :string)
|
|
||||||
("Å" "¥" :string)
|
|
||||||
("Ã" "¥" :string)
|
|
||||||
("È" "¥" :string)
|
|
||||||
("Ô" "¥" :string)
|
|
||||||
("Ŭ" "¥" :string)
|
|
||||||
("ż" "¥" :string)
|
|
||||||
("Ñ" "¥" :string)
|
|
||||||
("è" "¥" :string)
|
|
||||||
("Ĉ" "¥" :string)
|
|
||||||
("ă" "¥" :string)
|
|
||||||
("â" "¦" :string)
|
|
||||||
("û" "¦" :string)
|
|
||||||
("ê" "¦" :string)
|
|
||||||
("Õ" "¦" :string)
|
|
||||||
("õ" "¦" :string)
|
|
||||||
("È™" "¦" :string)
|
|
||||||
("ç" "¦" :string)
|
|
||||||
("Â" "¦" :string)
|
|
||||||
("Ê" "¦" :string)
|
|
||||||
("Û" "¦" :string)
|
|
||||||
("Ç" "¦" :string)
|
|
||||||
("ì" "¦" :string)
|
|
||||||
("ÃŒ" "¦" :string)
|
|
||||||
("Ș" "¦" :string)
|
|
||||||
("ö" "§" :string)
|
|
||||||
("Ö" "§" :string)
|
|
||||||
("ÅŸ" "§" :string)
|
|
||||||
("ů" "§" :string)
|
|
||||||
("ë" "§" :string)
|
|
||||||
("ã" "§" :string)
|
|
||||||
("î" "§" :string)
|
|
||||||
("ÃŽ" "§" :string)
|
|
||||||
("Ã" "§" :string)
|
|
||||||
("Åž" "§" :string)
|
|
||||||
("Å®" "§" :string)
|
|
||||||
("Ë" "§" :string)
|
|
||||||
("ï" "¨" :string)
|
|
||||||
("Å<>" "¨" :string)
|
|
||||||
("Ã<>" "¨" :string)
|
|
||||||
("Ę" "¨" :string)
|
|
||||||
("Å‘" "¨" :string)
|
|
||||||
("Ãœ" "¨" :string)
|
|
||||||
("Ã…" "¨" :string)
|
|
||||||
("ü" "¨" :string)
|
|
||||||
("Ä™" "¨" :string)
|
|
||||||
("Ã¥" "¨" :string)
|
|
||||||
("Ä" "©" :string)
|
|
||||||
("ű" "©" :string)
|
|
||||||
("Ø" "©" :string)
|
|
||||||
("ø" "©" :string)
|
|
||||||
("Å°" "©" :string)
|
|
||||||
("ä" "©" :string)
|
|
||||||
("Ä„" "ª" :string)
|
|
||||||
("Ä…" "ª" :string)
|
|
||||||
("Å“" "ÿ" :string)
|
|
||||||
("ß" "ÿ" :string)
|
|
||||||
("Æ" "ÿ" :string)
|
|
||||||
("Å’" "ÿ" :string)
|
|
||||||
("æ" "ÿ" :string)
|
|
||||||
("e" "¢" :string)
|
|
||||||
("t" "¢" :string)
|
|
||||||
("L" "¢" :string)
|
|
||||||
("Y" "¢" :string)
|
|
||||||
("J" "¢" :string)
|
|
||||||
("a" "¢" :string)
|
|
||||||
("p" "¢" :string)
|
|
||||||
("u" "¢" :string)
|
|
||||||
("j" "¢" :string)
|
|
||||||
("b" "¢" :string)
|
|
||||||
("G" "¢" :string)
|
|
||||||
("U" "¢" :string)
|
|
||||||
("F" "¢" :string)
|
|
||||||
("H" "¢" :string)
|
|
||||||
("i" "¢" :string)
|
|
||||||
("z" "¢" :string)
|
|
||||||
("c" "¢" :string)
|
|
||||||
("l" "¢" :string)
|
|
||||||
("A" "¢" :string)
|
|
||||||
("Q" "¢" :string)
|
|
||||||
("w" "¢" :string)
|
|
||||||
("D" "¢" :string)
|
|
||||||
("R" "¢" :string)
|
|
||||||
("d" "¢" :string)
|
|
||||||
("s" "¢" :string)
|
|
||||||
("r" "¢" :string)
|
|
||||||
("k" "¢" :string)
|
|
||||||
("v" "¢" :string)
|
|
||||||
("m" "¢" :string)
|
|
||||||
("P" "¢" :string)
|
|
||||||
("y" "¢" :string)
|
|
||||||
("K" "¢" :string)
|
|
||||||
("q" "¢" :string)
|
|
||||||
("S" "¢" :string)
|
|
||||||
("I" "¢" :string)
|
|
||||||
("C" "¢" :string)
|
|
||||||
("M" "¢" :string)
|
|
||||||
("Z" "¢" :string)
|
|
||||||
("T" "¢" :string)
|
|
||||||
("W" "¢" :string)
|
|
||||||
("B" "¢" :string)
|
|
||||||
("h" "¢" :string)
|
|
||||||
("x" "¢" :string)
|
|
||||||
("X" "¢" :string)
|
|
||||||
("f" "¢" :string)
|
|
||||||
("E" "¢" :string)
|
|
||||||
("V" "¢" :string)
|
|
||||||
("N" "¢" :string)
|
|
||||||
("O" "¢" :string)
|
|
||||||
("o" "¢" :string)
|
|
||||||
("g" "¢" :string)
|
|
||||||
("n" "¢" :string)
|
|
||||||
))
|
|
||||||
|
|
||||||
(define-rule-set "sphinx-xy-resolve-case"
|
|
||||||
|
|
||||||
:rules (("Ú" "8" :string)
|
|
||||||
("Ÿ" "8" :string)
|
|
||||||
("Ç" "8" :string)
|
|
||||||
("Ĉ" "8" :string)
|
|
||||||
("Å”" "8" :string)
|
|
||||||
("Ľ" "8" :string)
|
|
||||||
("Å®" "8" :string)
|
|
||||||
("Ã<>" "8" :string)
|
|
||||||
("É" "8" :string)
|
|
||||||
("Ë" "8" :string)
|
|
||||||
("Ș" "8" :string)
|
|
||||||
("Ì" "8" :string)
|
|
||||||
("Ê" "8" :string)
|
|
||||||
("Ň" "8" :string)
|
|
||||||
("Ä„" "8" :string)
|
|
||||||
("Å " "8" :string)
|
|
||||||
("Û" "8" :string)
|
|
||||||
("Åž" "8" :string)
|
|
||||||
("Ć" "8" :string)
|
|
||||||
("Ã’" "8" :string)
|
|
||||||
("Ĝ" "8" :string)
|
|
||||||
("Ñ" "8" :string)
|
|
||||||
("Ó" "8" :string)
|
|
||||||
("ÃŽ" "8" :string)
|
|
||||||
("Ã<>" "8" :string)
|
|
||||||
("Ã" "8" :string)
|
|
||||||
("Èš" "8" :string)
|
|
||||||
("Ã…" "8" :string)
|
|
||||||
("Äž" "8" :string)
|
|
||||||
("Ü" "8" :string)
|
|
||||||
("È" "8" :string)
|
|
||||||
("Ô" "8" :string)
|
|
||||||
("Ä°" "8" :string)
|
|
||||||
("Å°" "8" :string)
|
|
||||||
("Ù" "8" :string)
|
|
||||||
("Ŭ" "8" :string)
|
|
||||||
("Â" "8" :string)
|
|
||||||
("Ť" "8" :string)
|
|
||||||
("Ń" "8" :string)
|
|
||||||
("ÄŽ" "8" :string)
|
|
||||||
("Ź" "8" :string)
|
|
||||||
("Ž" "8" :string)
|
|
||||||
("Ä<>" "8" :string)
|
|
||||||
("Ŝ" "8" :string)
|
|
||||||
("Č" "8" :string)
|
|
||||||
("Ä´" "8" :string)
|
|
||||||
("Ö" "8" :string)
|
|
||||||
("Ø" "8" :string)
|
|
||||||
("Å»" "8" :string)
|
|
||||||
("Å<>" "8" :string)
|
|
||||||
("Ä‚" "8" :string)
|
|
||||||
("Äš" "8" :string)
|
|
||||||
("Å<>" "8" :string)
|
|
||||||
("Õ" "8" :string)
|
|
||||||
("Ę" "8" :string)
|
|
||||||
("Ã<>" "8" :string)
|
|
||||||
("À" "8" :string)
|
|
||||||
("Ĥ" "8" :string)
|
|
||||||
("Ä" "8" :string)
|
|
||||||
("Åš" "8" :string)
|
|
||||||
("Ř" "8" :string)
|
|
||||||
("Ã<>" "8" :string)
|
|
||||||
("Å’" "89" :string)
|
|
||||||
("Æ" "89" :string)
|
|
||||||
("ì" "9" :string)
|
|
||||||
("è" "9" :string)
|
|
||||||
("Ä…" "9" :string)
|
|
||||||
("Å¡" "9" :string)
|
|
||||||
("ú" "9" :string)
|
|
||||||
("Ã¥" "9" :string)
|
|
||||||
("ă" "9" :string)
|
|
||||||
("Ä™" "9" :string)
|
|
||||||
("ü" "9" :string)
|
|
||||||
("ź" "9" :string)
|
|
||||||
("ò" "9" :string)
|
|
||||||
("Å¥" "9" :string)
|
|
||||||
("È›" "9" :string)
|
|
||||||
("ĵ" "9" :string)
|
|
||||||
("Å•" "9" :string)
|
|
||||||
("ż" "9" :string)
|
|
||||||
("ä" "9" :string)
|
|
||||||
("ý" "9" :string)
|
|
||||||
("ù" "9" :string)
|
|
||||||
("á" "9" :string)
|
|
||||||
("é" "9" :string)
|
|
||||||
("Ä<>" "9" :string)
|
|
||||||
("ň" "9" :string)
|
|
||||||
("Å›" "9" :string)
|
|
||||||
("ø" "9" :string)
|
|
||||||
("Ã" "9" :string)
|
|
||||||
("Ä‘" "9" :string)
|
|
||||||
("ı" "9" :string)
|
|
||||||
("ÄŸ" "9" :string)
|
|
||||||
("î" "9" :string)
|
|
||||||
("ã" "9" :string)
|
|
||||||
("Ã " "9" :string)
|
|
||||||
("Å™" "9" :string)
|
|
||||||
("Å‘" "9" :string)
|
|
||||||
("ů" "9" :string)
|
|
||||||
("È™" "9" :string)
|
|
||||||
("ÿ" "9" :string)
|
|
||||||
("ë" "9" :string)
|
|
||||||
("Å" "9" :string)
|
|
||||||
("ç" "9" :string)
|
|
||||||
("ű" "9" :string)
|
|
||||||
("ñ" "9" :string)
|
|
||||||
("õ" "9" :string)
|
|
||||||
("Ä›" "9" :string)
|
|
||||||
("ÅŸ" "9" :string)
|
|
||||||
("ž" "9" :string)
|
|
||||||
("Ä<>" "9" :string)
|
|
||||||
("Å<>" "9" :string)
|
|
||||||
("Å„" "9" :string)
|
|
||||||
("û" "9" :string)
|
|
||||||
("Å‚" "9" :string)
|
|
||||||
("Ä<>" "9" :string)
|
|
||||||
("Ä¥" "9" :string)
|
|
||||||
("ê" "9" :string)
|
|
||||||
("ô" "9" :string)
|
|
||||||
("ĉ" "9" :string)
|
|
||||||
("â" "9" :string)
|
|
||||||
("ć" "9" :string)
|
|
||||||
("ï" "9" :string)
|
|
||||||
("ö" "9" :string)
|
|
||||||
("ľ" "9" :string)
|
|
||||||
("ó" "9" :string)
|
|
||||||
("æ" "99" :string)
|
|
||||||
("ß" "99" :string)
|
|
||||||
("Å“" "99" :string)
|
|
||||||
("N" "8" :string)
|
|
||||||
("V" "8" :string)
|
|
||||||
("O" "8" :string)
|
|
||||||
("X" "8" :string)
|
|
||||||
("E" "8" :string)
|
|
||||||
("P" "8" :string)
|
|
||||||
("K" "8" :string)
|
|
||||||
("T" "8" :string)
|
|
||||||
("Z" "8" :string)
|
|
||||||
("M" "8" :string)
|
|
||||||
("C" "8" :string)
|
|
||||||
("I" "8" :string)
|
|
||||||
("S" "8" :string)
|
|
||||||
("B" "8" :string)
|
|
||||||
("W" "8" :string)
|
|
||||||
("D" "8" :string)
|
|
||||||
("R" "8" :string)
|
|
||||||
("H" "8" :string)
|
|
||||||
("F" "8" :string)
|
|
||||||
("Q" "8" :string)
|
|
||||||
("A" "8" :string)
|
|
||||||
("G" "8" :string)
|
|
||||||
("U" "8" :string)
|
|
||||||
("J" "8" :string)
|
|
||||||
("Y" "8" :string)
|
|
||||||
("L" "8" :string)
|
|
||||||
("o" "9" :string)
|
|
||||||
("n" "9" :string)
|
|
||||||
("g" "9" :string)
|
|
||||||
("x" "9" :string)
|
|
||||||
("f" "9" :string)
|
|
||||||
("y" "9" :string)
|
|
||||||
("q" "9" :string)
|
|
||||||
("h" "9" :string)
|
|
||||||
("w" "9" :string)
|
|
||||||
("s" "9" :string)
|
|
||||||
("d" "9" :string)
|
|
||||||
("v" "9" :string)
|
|
||||||
("k" "9" :string)
|
|
||||||
("r" "9" :string)
|
|
||||||
("m" "9" :string)
|
|
||||||
("z" "9" :string)
|
|
||||||
("c" "9" :string)
|
|
||||||
("i" "9" :string)
|
|
||||||
("l" "9" :string)
|
|
||||||
("b" "9" :string)
|
|
||||||
("j" "9" :string)
|
|
||||||
("a" "9" :string)
|
|
||||||
("p" "9" :string)
|
|
||||||
("u" "9" :string)
|
|
||||||
("t" "9" :string)
|
|
||||||
("e" "9" :string)
|
|
||||||
))
|
|
||||||
|
|
||||||
(use-rule-set :run 0
|
|
||||||
:rule-set ("sphinx-xy-alphabetize"))
|
|
||||||
(use-rule-set :run 1
|
|
||||||
:rule-set ("sphinx-xy-resolve-diacritics"))
|
|
||||||
(use-rule-set :run 2
|
|
||||||
:rule-set ("sphinx-xy-resolve-case"))
|
|
||||||
BIN
MVC_pattern.png
BIN
MVC_pattern.png
Binary file not shown.
|
Before Width: | Height: | Size: 7.7 KiB |
81
Makefile
81
Makefile
|
|
@ -1,81 +0,0 @@
|
||||||
# Makefile for Sphinx LaTeX output
|
|
||||||
|
|
||||||
ALLDOCS = $(basename $(wildcard *.tex))
|
|
||||||
ALLPDF = $(addsuffix .pdf,$(ALLDOCS))
|
|
||||||
ALLDVI = $(addsuffix .dvi,$(ALLDOCS))
|
|
||||||
ALLPS = $(addsuffix .ps,$(ALLDOCS))
|
|
||||||
|
|
||||||
# Prefix for archive names
|
|
||||||
ARCHIVEPREFIX =
|
|
||||||
# Additional LaTeX options
|
|
||||||
LATEXOPTS =
|
|
||||||
# format: pdf or dvi
|
|
||||||
FMT = pdf
|
|
||||||
|
|
||||||
LATEX = latex
|
|
||||||
PDFLATEX = pdflatex
|
|
||||||
MAKEINDEX = makeindex
|
|
||||||
|
|
||||||
|
|
||||||
all: $(ALLPDF)
|
|
||||||
all-pdf: $(ALLPDF)
|
|
||||||
all-dvi: $(ALLDVI)
|
|
||||||
all-ps: $(ALLPS)
|
|
||||||
|
|
||||||
all-pdf-ja:
|
|
||||||
for f in *.pdf *.png *.gif *.jpg *.jpeg; do extractbb $$f; done
|
|
||||||
for f in *.tex; do pdflatex -kanji=utf8 $(LATEXOPTS) $$f; done
|
|
||||||
for f in *.tex; do pdflatex -kanji=utf8 $(LATEXOPTS) $$f; done
|
|
||||||
for f in *.tex; do pdflatex -kanji=utf8 $(LATEXOPTS) $$f; done
|
|
||||||
-for f in *.idx; do mendex -U -f -d "`basename $$f .idx`.dic" -s python.ist $$f; done
|
|
||||||
for f in *.tex; do pdflatex -kanji=utf8 $(LATEXOPTS) $$f; done
|
|
||||||
for f in *.tex; do pdflatex -kanji=utf8 $(LATEXOPTS) $$f; done
|
|
||||||
for f in *.dvi; do dvipdfmx $$f; done
|
|
||||||
|
|
||||||
zip: all-$(FMT)
|
|
||||||
mkdir $(ARCHIVEPREFIX)docs-$(FMT)
|
|
||||||
cp $(ALLPDF) $(ARCHIVEPREFIX)docs-$(FMT)
|
|
||||||
zip -q -r -9 $(ARCHIVEPREFIX)docs-$(FMT).zip $(ARCHIVEPREFIX)docs-$(FMT)
|
|
||||||
rm -r $(ARCHIVEPREFIX)docs-$(FMT)
|
|
||||||
|
|
||||||
tar: all-$(FMT)
|
|
||||||
mkdir $(ARCHIVEPREFIX)docs-$(FMT)
|
|
||||||
cp $(ALLPDF) $(ARCHIVEPREFIX)docs-$(FMT)
|
|
||||||
tar cf $(ARCHIVEPREFIX)docs-$(FMT).tar $(ARCHIVEPREFIX)docs-$(FMT)
|
|
||||||
rm -r $(ARCHIVEPREFIX)docs-$(FMT)
|
|
||||||
|
|
||||||
gz: tar
|
|
||||||
gzip -9 < $(ARCHIVEPREFIX)docs-$(FMT).tar > $(ARCHIVEPREFIX)docs-$(FMT).tar.gz
|
|
||||||
|
|
||||||
bz2: tar
|
|
||||||
bzip2 -9 -k $(ARCHIVEPREFIX)docs-$(FMT).tar
|
|
||||||
|
|
||||||
xz: tar
|
|
||||||
xz -9 -k $(ARCHIVEPREFIX)docs-$(FMT).tar
|
|
||||||
|
|
||||||
# The number of LaTeX runs is quite conservative, but I don't expect it
|
|
||||||
# to get run often, so the little extra time won't hurt.
|
|
||||||
%.dvi: %.tex
|
|
||||||
$(LATEX) $(LATEXOPTS) '$<'
|
|
||||||
$(LATEX) $(LATEXOPTS) '$<'
|
|
||||||
$(LATEX) $(LATEXOPTS) '$<'
|
|
||||||
-$(MAKEINDEX) -s python.ist '$(basename $<).idx'
|
|
||||||
$(LATEX) $(LATEXOPTS) '$<'
|
|
||||||
$(LATEX) $(LATEXOPTS) '$<'
|
|
||||||
|
|
||||||
%.pdf: %.tex
|
|
||||||
$(PDFLATEX) $(LATEXOPTS) '$<'
|
|
||||||
$(PDFLATEX) $(LATEXOPTS) '$<'
|
|
||||||
$(PDFLATEX) $(LATEXOPTS) '$<'
|
|
||||||
-$(MAKEINDEX) -s python.ist '$(basename $<).idx'
|
|
||||||
$(PDFLATEX) $(LATEXOPTS) '$<'
|
|
||||||
$(PDFLATEX) $(LATEXOPTS) '$<'
|
|
||||||
|
|
||||||
%.ps: %.dvi
|
|
||||||
dvips '$<'
|
|
||||||
|
|
||||||
clean:
|
|
||||||
rm -f *.log *.ind *.aux *.toc *.syn *.idx *.out *.ilg *.pla *.ps *.tar *.tar.gz *.tar.bz2 *.tar.xz $(ALLPDF) $(ALLDVI)
|
|
||||||
|
|
||||||
.PHONY: all all-pdf all-dvi all-ps clean zip tar gz bz2 xz
|
|
||||||
.PHONY: all-pdf-ja
|
|
||||||
|
|
@ -1,84 +0,0 @@
|
||||||
# 01 - Erste Schritte mit C
|
|
||||||
|
|
||||||
___
|
|
||||||
## 1. Übersicht
|
|
||||||
|
|
||||||
In diesem Praktikum erstellen Sie mehrere kleine C-Programme, in denen Sie Input- und Output-Funktionen der C Standard Library verwenden.
|
|
||||||
|
|
||||||
Arbeiten Sie in Zweiergruppen und diskutieren Sie ihre Lösungsansätze miteinander, bevor Sie diese umsetzen.
|
|
||||||
|
|
||||||
Bevor Sie mit den Programmieraufgaben beginnen, setzen Sie eine virtuelle Maschine mit der vorbereiteten Praktikumsumgebung auf.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 2. Lernziele
|
|
||||||
In diesem Praktikum schreiben Sie selbst von Grund auf einige einfache C-Programme und wenden verschiedene Kontrollstrukturen an.
|
|
||||||
|
|
||||||
- Sie können mit *#include* Funktionen der C Standard Library einbinden
|
|
||||||
- Sie können mit *#define* Macros definieren und diese anwenden
|
|
||||||
- Sie wenden die *Input-* und *Output-Funktionen* von C an, um Tastatur-Input einzulesen und formatierte Ausgaben zu machen.
|
|
||||||
- Sie verwenden die Kommandozeile, um ihren Sourcecode in ein ausführbares Programm umzuwandeln.
|
|
||||||
- Sie wenden for-und while-Loops sowie if-then-else-Verzweigungen an.
|
|
||||||
- Sie setzen eine Programmieraufgabe selbständig in ein funktionierendes Programm um.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 3. Aufgabe 1: virtuelle Maschine
|
|
||||||
Im Moodle-Kurs "Systemnahe Programmierung" finden Sie unter "Praktika" eine Installationsanleitung für die virtuelle Maschine, die wir Ihnen zur Verfügung stellen. Die virtuelle Maschine enthält ein Ubuntu Linux-Betriebssystem und die für das Praktikum benötigten Frameworks.
|
|
||||||
|
|
||||||
Folgen sie der Anleitung, um die virtuelle Maschine auf ihrem Rechner zu installieren.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 4. Aufgabe 2: Hello World
|
|
||||||
Schreiben Sie ein C-Programm, das "Hello World" auf die Standardausgabe schreibt. Verwenden Sie die printf-Funktion aus der Standard Library. In den Vorlesungsfolien finden Sie bei Bedarf eine Vorlage.
|
|
||||||
|
|
||||||
Erstellen sie das Source-File mit einem beliebigen Editor, sie benötigen nicht unbedingt eine IDE. Speichern Sie das Source-File mit der Endung `.c`.
|
|
||||||
|
|
||||||
Um ihr Source-File zu kompilieren, verwenden Sie den GNU Compiler auf der Kommandozeile:
|
|
||||||
``` sh
|
|
||||||
$> gcc hello.c
|
|
||||||
```
|
|
||||||
|
|
||||||
Der Compiler übersetzt ihr Programm in eine ausführbare Datei `a.out`, die Sie mit
|
|
||||||
|
|
||||||
``` sh
|
|
||||||
$> ./a.out
|
|
||||||
```
|
|
||||||
|
|
||||||
ausführen können. Sie können den Namen der ausführbaren Datei wählen, indem Sie die Option `-o` verwenden:
|
|
||||||
|
|
||||||
``` sh
|
|
||||||
$> gcc hello.c -o hello
|
|
||||||
```
|
|
||||||
|
|
||||||
erzeugt die ausführbare Datei `hello`.
|
|
||||||
|
|
||||||
Verwenden Sie die Option `-Wall`, um alle Warnungen des Compilers auszugeben. Dies weist Sie auf allfällige Programmierfehler hin.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 5. Aufgabe 3: Tabellenausgabe
|
|
||||||
Schreiben Sie ein Programm in C, das von `stdin` einen Umrechnungsfaktor zwischen CHF und Bitcoin einliest und danach eine Tabelle von Franken- und Bitcoin-Beträgen ausgibt. Die Tabelle soll sauber formatiert sein, z.B. so:
|
|
||||||
```
|
|
||||||
Enter conversion rate (1.00 BTC -> CHF): 43158.47
|
|
||||||
200 CHF <--> 0.00463 BTC
|
|
||||||
400 CHF <--> 0.00927 BTC
|
|
||||||
600 CHF <--> 0.01390 BTC
|
|
||||||
800 CHF <--> 0.01854 BTC
|
|
||||||
1000 CHF <--> 0.02317 BTC
|
|
||||||
1200 CHF <--> 0.02780 BTC
|
|
||||||
1400 CHF <--> 0.03244 BTC
|
|
||||||
1600 CHF <--> 0.03707 BTC
|
|
||||||
```
|
|
||||||
|
|
||||||
- Verwenden Sie eine Schleife und die `printf`-Funktion für die Tabellenausgabe
|
|
||||||
- Definieren Sie ein Makro `NUM_ROWS`, um an zentraler Stelle im Source-Code zu definieren, wie viele Einträge die Tabelle in der Ausgabe haben soll.
|
|
||||||
- Lesen Sie den Umrechnungsfaktor mit der `scanf`-Funktion als `double` von der Kommandozeile ein.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 6. Aufgabe 4: Zeichen und Wörter zählen
|
|
||||||
Schreiben Sie ein C-Programm, welches die Zeichen und Wörter einer mit der Tastatur eingegebenen Zeile zählt. Wortzwischenräume sind entweder Leerzeichen (' ') oder Tabulatoren ('\t'). Die Eingabe der Zeile mit einem newline-character ('\n') abgeschlossen. Danach soll ihr Programm die Anzahl Zeichen und die Anzahl Wörter ausgeben und terminieren.
|
|
||||||
- Verwenden Sie die `char getchar(void)` Funktion aus der `stdio.h` Library, um die Zeichen einzeln einzulesen. Die Funktion `getchar` kehrt nicht gleich bei Eingabe des ersten Zeichens zurück, sondern puffert die Daten, bis die Eingabe einer kompletten Zeile mit Return abgeschlossen wird. Dann wird das erste Zeichen aus dem Puffer zurückgegeben und mit weiteren Aufrufen von getchar können die nachfolgenden Zeichen aus dem Puffer gelesen werden. Gibt `getchar` das Zeichen `\n` zurück, ist die Zeile komplett zurückgegeben und der Puffer ist wieder leer.
|
|
||||||
- Setzen Sie eine Schleife ein, die beim Zeichen '\n' terminiert.
|
|
||||||
- Benutzen Sie if-then-else-Strukturen um die Wörter zu zählen.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 7. Bewertung
|
|
||||||
Die gegebenenfalls gestellten Theorieaufgaben und der funktionierende Programmcode müssen der Praktikumsbetreuung gezeigt werden. Die Lösungen müssen mündlich erklärt werden.
|
|
||||||
Binary file not shown.
|
|
@ -1,228 +0,0 @@
|
||||||
# 02: Funktionen, Datentyp "enum"
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
(Copyright Bild: xkcd.com)
|
|
||||||
|
|
||||||
___
|
|
||||||
## 1. Übersicht
|
|
||||||
In diesem Praktikum sind zwei Themen im Fokus: Funktionen und der Datentyp enum.
|
|
||||||
|
|
||||||
Funktionen sind der wesentlichste Bestandteil der C Programmierung welcher eine strukturierte Programmierung ermöglicht:
|
|
||||||
* Eine Funktion ein Teil eines C Codes, der eine spezielle Aufgabe ausführt. Sie kann aus dem Hauptprogramm, oder aus anderen Funktionen, aufgerufen werden.
|
|
||||||
* Jede Funktion besitzt einen eindeutigen Namen, eine eindeutige Signatur (Typen und Reihenfolge der Parameter) und einen Rückgabewert (int falls nichts angegeben wird).
|
|
||||||
* Eine Funktion kann Werte aus dem aufrufendem Kontext übernehmen und bei Bedarf einen Wert an den aufrufenden Kontext zurückliefern.
|
|
||||||
Beispiel einer Additions-Funktion:
|
|
||||||
```
|
|
||||||
#include <stdio.h>
|
|
||||||
|
|
||||||
/* Funktionsdeklaration */
|
|
||||||
int add(int a, int b);
|
|
||||||
|
|
||||||
int main(void) {
|
|
||||||
int aa = 1, bb = 2, cc;
|
|
||||||
printf("%aa + %bb = %cc", aa, bb, add(aa, bb););
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Funktionsdefinition */
|
|
||||||
int add(int a, int b) {
|
|
||||||
return a + b;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
Der Daten typt enum wird verwendet um die Lesbarkeit von Programmen zu erhöhen:
|
|
||||||
|
|
||||||
Beispiel eines enum:
|
|
||||||
```
|
|
||||||
enum Ampeln = {rot =1, gelb, gruen};
|
|
||||||
|
|
||||||
int main(void) {
|
|
||||||
Ampeln ampel1;
|
|
||||||
if (ampel1 == rot) {...}
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
___
|
|
||||||
## 2. Lernziele
|
|
||||||
|
|
||||||
In diesem Praktikum lernen Sie Funktionen zu definieren und aufzurufen, sowie enum anzuwenden.
|
|
||||||
* Sie können ein Programm schreiben welches aus mehreren Funktionen besteht.
|
|
||||||
* Sie können Funktionen deklarieren, definieren und aufrufen.
|
|
||||||
* Sie können enum Typen definieren und deren Werte bestimmen und abfragen.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 3. Aufgaben
|
|
||||||
|
|
||||||
```{eval-rst}
|
|
||||||
.. figure:: kalender-108_v-ARDFotogalerie.jpg
|
|
||||||
:width: 600px
|
|
||||||
:name: kalender-108_v-ARDFotogalerie
|
|
||||||
:align: center
|
|
||||||
```
|
|
||||||
|
|
||||||
(Copyright Bild: www.planet-wissen.de)
|
|
||||||
|
|
||||||
### 3.1 Aufgabe 1 Tage pro Monat
|
|
||||||
In der ersten Aufgabe berechnen Sie die Tag pro Monat einer beliebigen Kombination Monat / Jahr.
|
|
||||||
Erweitern Sie dazu das Programm um folgende Aspekte:
|
|
||||||
* Bereichsprüfung von Jahr und Monat
|
|
||||||
* Funktion istSchaltjahr, welche berechnet, ob das Jahr eine Schaljahr ist
|
|
||||||
* Funktion tageProMonat, welche die Anzahl Tage des gegebenen Monats und Jahres berechnet.
|
|
||||||
|
|
||||||
Vorgaben:
|
|
||||||
* Die Funktion istSchaltjahr nimmt ein Integer (jahr) entgegen und gibt 1 im Falle eiens Schltjahres und 0 im andreren Fall zurück
|
|
||||||
* Die Funktion tageProMonat nimmt zwei integer (monat und jahr) entgegeben und gibt die Anzahl Tage als Integer zurück
|
|
||||||
* Die Jahreszahl, welche den Funktionen übergeben wird, muss überprüft werden und grösser gleich 1599 und kleiner als 10000 sein
|
|
||||||
* Der übergebene Monat muss grösser als 0 und kleine als 13 sein.
|
|
||||||
|
|
||||||
Die Regeln für die Schaltjahrberechnung:
|
|
||||||
* Schaltjahre sind alle Jahre, die durch 4 teilbar sind.
|
|
||||||
* Eine Ausnahme bilden die Jahrhunderte (1600, 1700…). Diese sind keine Schltjahre.
|
|
||||||
* zu den 100er gibt es ebenfalls Ausnahmen: Diese sind immer Schaltjahre, wenn sie durch 400 teilbar sind
|
|
||||||
... also zum Beispiel 1600 ist eines, nicht jedoch 1700. Weiterführende Details finden Sie unter https://de.wikipedia.org/wiki/Gregorianischer_Kalender
|
|
||||||
|
|
||||||
Gegeben ist die main Funktion des Programms. Ergänzen Sie die enum Definition und die fehlenden Funktionen:
|
|
||||||
* gibIntWert: Die Funktion soll einen Int Wert zurückgeben. Der Bereich, wie auch Fehleingaben sollen sollen berücksichtigt werden. (atoi unfd fgets sind hier hilfreich)
|
|
||||||
* istSchaltjahr: Die Funktion gibt 1 im Falle eines Schltjahr und o im anderen Falle zurück.
|
|
||||||
* tageProMonat: Die Funktion gibt den die Tage des Monats für das definierte Jahr zurück. Verwenden Sie die Switchanweisung , sowie den enum Datentypen
|
|
||||||
|
|
||||||
```
|
|
||||||
int main (int argc, char *argv[]) {
|
|
||||||
|
|
||||||
int monat, jahr;
|
|
||||||
|
|
||||||
// Monat einlesen und Bereich ueberpruefen
|
|
||||||
monat = gibIntWert("Monat", 1, 12);
|
|
||||||
jahr = gibIntWert("Jahr", 1600, 9999);
|
|
||||||
|
|
||||||
// Ausgabe zum Test
|
|
||||||
printf("Monat: %d, Jahr: %d \n", monat, jahr);
|
|
||||||
|
|
||||||
// Ausgabe zum Test (hier mit dem ternaeren Operator "?:")
|
|
||||||
printf("%d ist %s Schaltjahr\n", jahr, istSchaltjahr(jahr) ? "ein" : "kein");
|
|
||||||
|
|
||||||
// Ausgabe
|
|
||||||
printf("Der Monat %02d-%d hat %d Tage.\n", monat, jahr, tageProMonat(jahr, monat));
|
|
||||||
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Tipp: Angenommen Sie verwenden den enum month_t { JAN=1, FEB, MAR, APR, MAI, JUN, JUL, AUG, SEP, OKT, NOV, DEZ };
|
|
||||||
Dann können Sie im Programm direkt die Konstanten verwenden:
|
|
||||||
```
|
|
||||||
if (m == 2) ... // schlecht lesbar
|
|
||||||
if (monat == 2) ... // besserer Variablenname
|
|
||||||
if (monat == FEB) ... // am besten lesbar
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
Als Abnahme müssen die Tests unverändert ohne Fehler ausgeführt werden (`make test`)
|
|
||||||
___
|
|
||||||
### 3.2 Aufgabe 2 Bestimmen des Wochentags
|
|
||||||
Erweitern Sie das vorgegebene zweite Programm Gerüst an den bezeichneten Stellen so, dass das Programm von der Kommando Zeile ein Argument entgegennimmt, es auf Gültigkeit überprüft und schliesslich den Wochentag für das gegebene Datum berechnet und ausgibt.
|
|
||||||
Prüfen Sie die Umsetzung beider Teilaufgaben mittels make test.
|
|
||||||
#### 3.2.1 Teilaufgabe Argumente Parsen und auf Korrektheit prüfen
|
|
||||||
Das Argument stellt ein gültiges Datum unseres Gregorianischen Kalenders dar (d.h. ein Datum ab Donnerstag, den 15. Oktober 1582, mit der Gregorianischen Schaltjahr Regel).
|
|
||||||
Wenn kein Argument gegeben ist oder wenn das eingegebene Datum nicht gültig ist, soll das Programm einem Hilfetext auf stderr ausgeben und mit EXIT_FAILURE Exit Code terminieren. Wenn ein gültiges Datum erkannt wurde terminiert das Programm mit Exit Code EXIT_SUCCESS.
|
|
||||||
##### 3.2.1.1 Argument Format
|
|
||||||
Das Format des Kommando Zeilen Arguments soll yyyy-mm-dd sein, wobei yyyy für das vier-stellige Jahr, mm für einen 1-2-stelligen Monat (1…12) und dd für einen Tag des Monats, begin-nend mit 01. Z.B. 2020-02-29.
|
|
||||||
##### 3.2.1.2 Korrektes Datum
|
|
||||||
Das Datum muss alle folgenden Bedingungen erfüllen damit es als korrekt erkannt wird:
|
|
||||||
* Obergrenze für ein «sinnvolles» Datum ist das Jahr 9999
|
|
||||||
* es muss Gregorianisch sein, d.h. ab 15. Oktober 1582 (inklusive)
|
|
||||||
* es darf nur Monate von 1 für Januar bis 12 für Dezember beinhalten
|
|
||||||
* der Tag muss grösser oder gleich 1 sein
|
|
||||||
* der Tag darf nicht grösser als 31 sein für Monate mit einer Länge von 31 Tagen
|
|
||||||
* der Tag darf nicht grösser als 30 sein für Monate mit einer Länge von 30 Tagen
|
|
||||||
* der Tag darf für den Februar nicht grösser sein als 29 für ein Schaltjahr
|
|
||||||
* der Tag darf für den Februar nicht grösser sein als 28 für ein Nicht-Schaltjahr
|
|
||||||
|
|
||||||
##### 3.2.1.3 Vorgaben an die Umsetzung
|
|
||||||
1. Definieren Sie einen enum Typen mit (typedef) Namen month_t dessen Werte die Englischen 3-Zeichen Abkürzungen der Monate sind, nämlich Jan, Feb, … Dec und stellen Sie sicher dass die Abkürzungen für die uns geläufigen Monatsnummer stehen.
|
|
||||||
2. Definierend Sie einen struct Typen mit (typedef) Namen date_t und den int Elementen year, month, day. Lesen Sie das Argument (falls vorhanden) via sscanf und dem Formatstring "%d-%d-%d" in die drei Elemente einer Date Variable. Siehe dazu die Hinweise im Anhang.
|
|
||||||
3. Für die Berechnung der Monatslänge implementieren Sie die Hilfsfunktion is_leap_year(date_t date) (nach obigen Vorgaben). Der Return Wert 0 bedeutet «Kein Schaltjahr», 1 bedeutet «Schaltjahr».
|
|
||||||
4. Implementieren Sie die Funktion `int get_month_length(date_t date)`. Diese soll für den Monat des Datums die Monatslänge (was dem letzten Tag des Monats ent-spricht) ausgeben – geben Sie 0 für ungültige Monatswerte zurück.
|
|
||||||
5. Schliesslich implementieren Sie die Funktion int is_gregorian_date(date_t date) welche prüft, ob ein gegebenes Datum im Bereich 15. Oktober 1582 und dem Jahr 9999 ist (0 = nein, 1 = ja).
|
|
||||||
6. Implementieren Sie eine Funktion int is_valid_date(date_t date), welche obige Bedingungen für ein gültiges Datum umsetzt. Der Return Wert 0 bedeutet «Kein gültiges Datum», 1 bedeutet «Gültiges Datum». Benutzen Sie für die Prüfung des Datums die `month_t` Werte wo immer möglich und sinnvoll. Verwenden Sie die oben implemen-tierten Hilfsfunktionen.
|
|
||||||
##### 3.2.1.4 Hinweise
|
|
||||||
Beachten Sie die Kommentare im Code für die geforderten Implementierungs-Details.
|
|
||||||
#### 3.2.2 Teilaufgabe Wochentag Berechnung
|
|
||||||
Schreiben Sie eine Funktion welche zu einem Datum den Wochentag berechnet.
|
|
||||||
Die Formel wird Georg Glaeser zugeschrieben, möglicherweise angelehnt an eine Formel von Carl Friedrich Gauss.
|
|
||||||
|
|
||||||
```{eval-rst}
|
|
||||||
.. figure:: Wochentagsberechnung.jpg
|
|
||||||
:width: 600px
|
|
||||||
:name: Wochentagsberechnung
|
|
||||||
:align: center
|
|
||||||
```
|
|
||||||
(Quelle: https://de.wikipedia.org/wiki/Wochentagsberechnung)
|
|
||||||
|
|
||||||
Hier ist eine für C abgewandelte Variante davon.
|
|
||||||
```
|
|
||||||
weekday = ((day + (13 * m - 1) / 5 + y + y / 4 + c / 4 - 2 * c) % 7 + 7) % 7
|
|
||||||
alle Zahlen sind int Werte und alles basiert auf int-Arithmetik
|
|
||||||
m = 1 + (month + 9) % 12
|
|
||||||
a = year - 1 (für month < Mar), ansonsten year
|
|
||||||
y = a % 100
|
|
||||||
c = a / 100
|
|
||||||
```
|
|
||||||
Erweitern sie das Programm so, dass vor dem erfolgreichen Terminieren des Programms fol-gende Zeile (inklusive Zeilenumbruch) ausgegeben wird: yyyy-mm-dd is a Ddd, wobei yyyy für das Jahr, mm für die Nummer des Monats (01…12) und dd für den Tag im Monat (01…). Z.B. 2020-02-29 is a Sat.
|
|
||||||
Vorgaben an die Umsetzung
|
|
||||||
1. Definieren Sie einen enum Typen mit (typedef) Namen weekday_t dessen Werte die Englischen 3-Zeichen Abkürzungen der Tage sind, nämlich Sun, Mon, … Sat und stel-len Sie sicher dass die Abkürzungen für die Werte 0…6 stehen.
|
|
||||||
2. Schreiben Sie eine Funktion weekday_t calculate_weekday(date_t date) nach der Beschreibung der obigen Formel. Das date Argument ist als gültig angenom-men, d.h. es ist ein Programmier-Fehler, wenn das Programm diese Funktion mit einem ungültigen Datum aufruft. Machen Sie dafür als erste Codezeile in der Funktion eine Zu-sicherung (assert(is_valid_date(date));)
|
|
||||||
3. Schreiben Sie eine Funktion void print_weekday(weekday_t day), welche für jeden gülteigen Tag eine Zeile auf stdout schreibt mit den Englischen 3-Zeichen Ab-kürzungen für den Wochentag, z.B. Sonntag: Sun, Montag: Mon, etc. Wenn ein ungülti-ger Wert für day erkannt wird, soll assert(!"day is out-of-range"); aufgeru-fen werden.
|
|
||||||
Hinweise
|
|
||||||
• Für interessierte, siehe: https://de.wikipedia.org/wiki/Wochentagsberechnung
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
## 4. Bewertung
|
|
||||||
|
|
||||||
Die gegebenenfalls gestellten Theorieaufgaben und der funktionierende Programmcode müssen der Praktikumsbetreuung gezeigt werden. Die Lösungen müssen mündlich erklärt werden können.
|
|
||||||
| Aufgabe | Kriterium | Gewicht |
|
|
||||||
| :-- | :-- | :-- |
|
|
||||||
| alle | Sie können das funktionierende Programm inklusive funktionierende Tests demonstrieren und erklären. | |
|
|
||||||
| gibIntWert | Eingabe, Bereichsüberprüfung korrekt | 1 |
|
|
||||||
| istSchaltjahr | Funktion korrekt | 1 |
|
|
||||||
| TageProMonat | Funktion korrekt | 1 |
|
|
||||||
| Aufgabe 2 | Fehlenden Teile ergänzt und lauffähig | 1 |
|
|
||||||
___
|
|
||||||
## 5. Anhang
|
|
||||||
|
|
||||||
### 5.1 Sprach Element
|
|
||||||
|
|
||||||
```int main(int argc, char *argv[]) {
|
|
||||||
...
|
|
||||||
} argc: Anzahl Einträge in argv.
|
|
||||||
argv: Array von Command Line Argumenten.
|
|
||||||
argv[0]: wie das Programm gestartet wurde
|
|
||||||
argv[1]: erstes Argument
|
|
||||||
…
|
|
||||||
argv[argc-1]: letztes Argument
|
|
||||||
int a = 0;
|
|
||||||
int b = 0;
|
|
||||||
int c = 0;
|
|
||||||
int res = sscanf(argv[1]
|
|
||||||
, "%d-%d-%d"
|
|
||||||
, &a, &b, &c
|
|
||||||
);
|
|
||||||
if (res != 3) {
|
|
||||||
// Fehler Behandlung...
|
|
||||||
// ...
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 5.2 Beschreibung
|
|
||||||
Siehe man 3 sscanf.
|
|
||||||
Die Funktion sscanf gibt die Anzahl erfolgreich erkannte Argumente zurück. Unbedingt prüfen und angemessen darauf reagieren.
|
|
||||||
Die gelesenen Werte werden in a, b und c, gespeichert, dazu müssen Sie die Adresse der Variablen übergeben. Mehr Details dazu werden später erklärt.
|
|
||||||
fprintf(stderr, "Usage: %s…\n", argv[0]); Siehe man 3 fprintf.
|
|
||||||
Schreibt formatierten Text auf den stderr Stream.
|
|
||||||
|
|
||||||
___
|
|
||||||
Version: 15.02.2022
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 15 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 37 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 68 KiB |
|
|
@ -1,11 +0,0 @@
|
||||||
import os
|
|
||||||
import grip
|
|
||||||
import pdfkit
|
|
||||||
|
|
||||||
os.chdir(r"C:\Users\bazz\Documents\GitHub\snp\praktika\P03_Bounding_Box")
|
|
||||||
f_md = r".\README.md"
|
|
||||||
f_html = r".\REAMDE.html"
|
|
||||||
f_pdf = r".\README.pdf"
|
|
||||||
|
|
||||||
grip.render_content(f_md)
|
|
||||||
pdfkit.from_file(f_html, f_pdf)
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 7.3 KiB |
Binary file not shown.
|
|
@ -1,64 +0,0 @@
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <strings.h>
|
|
||||||
|
|
||||||
/** Aufgabe 1:
|
|
||||||
enum Typ "textFlags" deklarieren mit den einzelnene Werten
|
|
||||||
- ITALICS = 00000001 // = 1
|
|
||||||
- BOLD = 00000010 // = 2
|
|
||||||
- UNDERLINE = 00000100 // = 4
|
|
||||||
*/
|
|
||||||
|
|
||||||
enum textFlags { ITALICS = 1, BOLD = 2, UNDERLINE = 4 };
|
|
||||||
|
|
||||||
/** Aufgabe 2
|
|
||||||
Funktion Flag Einlesen
|
|
||||||
*/
|
|
||||||
|
|
||||||
void menu (void) {
|
|
||||||
(void) printf("\nBitte geben Sie die gewuenschten Flags ein\n");
|
|
||||||
(void) printf("(Ugueltige Eingaben fuehren zum Abbruch.)\n");
|
|
||||||
(void) printf("Kursiv: tippen Sie die 1\n");
|
|
||||||
(void) printf("Fett: tippen Sie die 2\n");
|
|
||||||
(void) printf("Unterstrichen: tippen Sie die 3\n");
|
|
||||||
(void) printf("Abbrechen: tippen Sie die 0\n");
|
|
||||||
(void) printf("Ihre Wahl: ");
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
int flagEinlesen() {
|
|
||||||
fflush(stdin);
|
|
||||||
int flag = fgetc(stdin) - '0';
|
|
||||||
if (flag < 1 || flag > 3) { flag = 0; }
|
|
||||||
return flag;
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
void displayFlags(int flags) {
|
|
||||||
printf("Gesetzte Flags: %d\n", flags);
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Vorgegebener Programm-Rumpf */
|
|
||||||
int main(void) {
|
|
||||||
int oneFlag, flags = 0;
|
|
||||||
do {
|
|
||||||
menu();
|
|
||||||
oneFlag = flagEinlesen();
|
|
||||||
switch (oneFlag) {
|
|
||||||
case 1:
|
|
||||||
printf("Wahl: 1, Flag: %d", oneFlag);
|
|
||||||
flags |= ITALICS;
|
|
||||||
break;
|
|
||||||
case 2:
|
|
||||||
printf("Wahl: 2, Flag: %d", oneFlag);
|
|
||||||
flags |= BOLD;
|
|
||||||
break;
|
|
||||||
case 3:
|
|
||||||
printf("Wahl: 3, Flag: %d", oneFlag);
|
|
||||||
flags |= UNDERLINE;
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
(void) displayFlags(flags);
|
|
||||||
} while (oneFlag != 0);
|
|
||||||
}
|
|
||||||
|
|
||||||
Binary file not shown.
|
|
@ -1,117 +0,0 @@
|
||||||
/**
|
|
||||||
* P02 Praktikum
|
|
||||||
*
|
|
||||||
* - Funktionen
|
|
||||||
* - Funktion Schaltjahr
|
|
||||||
* - Funktion Tage pro Monat
|
|
||||||
* - Funktion Wochentag
|
|
||||||
*
|
|
||||||
* @author ZHAW
|
|
||||||
* @version 1.0 - 08.02.2022
|
|
||||||
*/
|
|
||||||
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
|
|
||||||
|
|
||||||
int leseZahl(char *prompt, int min, int max) { // Datentyp angeben, Parameter angeben
|
|
||||||
char zahlString[11];
|
|
||||||
int zahl;
|
|
||||||
|
|
||||||
do {
|
|
||||||
printf("%s", prompt);
|
|
||||||
fgets(zahlString, 10, stdin);
|
|
||||||
zahl = atoi(zahlString); // bei ungueltiger Zahl return 0
|
|
||||||
} while ((zahl < min) || (zahl > max));
|
|
||||||
return zahl; // return Zeile angeben
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
|
|
||||||
____ leseZahl(____) { // Datentyp angeben, Parameter angeben
|
|
||||||
char zahlString[11];
|
|
||||||
int zahl;
|
|
||||||
|
|
||||||
fgets(zahlString, 10, stdin);
|
|
||||||
zahl = atoi(zahlString); // bei ungueltiger Zahl return 0
|
|
||||||
___________________ // return Zeile angeben
|
|
||||||
|
|
||||||
}
|
|
||||||
*/
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
/* Konstante Werte fuer die Monate */
|
|
||||||
enum { JAN=1, FEB, MAR, APR, MAI, JUN, JUL, AUG, SEP, OKT, NOV, DEZ };
|
|
||||||
|
|
||||||
|
|
||||||
int main (void) {
|
|
||||||
|
|
||||||
//
|
|
||||||
// Variablen definieren
|
|
||||||
//
|
|
||||||
int monat, jahr;
|
|
||||||
char *prompt;
|
|
||||||
|
|
||||||
int istSchaltjahr = 0; // 0: kein Schaltjahr, sonst Schaltjahr
|
|
||||||
int tageProMonat = 0; // Ergebnis spaeter in dieser Variablen
|
|
||||||
|
|
||||||
|
|
||||||
//
|
|
||||||
// Monat und Jahr einlesen
|
|
||||||
//
|
|
||||||
|
|
||||||
//printf("Monat: ");
|
|
||||||
//scanf("%d", &monat);
|
|
||||||
//printf("Jahr: ");
|
|
||||||
//scanf("%d", &jahr);
|
|
||||||
|
|
||||||
prompt = "Monat: ";
|
|
||||||
monat = leseZahl(prompt, 1, 12);
|
|
||||||
prompt = "Jahr: ";
|
|
||||||
jahr = leseZahl(prompt, 1, 3000);
|
|
||||||
|
|
||||||
// Ausgabe zum Test
|
|
||||||
// printf("Monat: %d, Jahr: %d \n", monat, jahr);
|
|
||||||
|
|
||||||
|
|
||||||
//
|
|
||||||
// Monate mit 30 und 31 Tagen behandeln
|
|
||||||
//
|
|
||||||
switch (monat) {
|
|
||||||
|
|
||||||
case JAN: case MAR: case MAI: case JUL: case AUG: case OKT: case DEZ:
|
|
||||||
tageProMonat = 31;
|
|
||||||
break;
|
|
||||||
|
|
||||||
case APR: case JUN: case SEP: case NOV:
|
|
||||||
tageProMonat = 30;
|
|
||||||
break;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Monat ist 2: Auf Schaltjahr ueberpruefen
|
|
||||||
//
|
|
||||||
case FEB:
|
|
||||||
if (jahr % 4 == 0 && (jahr % 100 != 0 || jahr % 400 == 0)) {
|
|
||||||
tageProMonat = 29;
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
tageProMonat = 28;
|
|
||||||
}
|
|
||||||
break;
|
|
||||||
|
|
||||||
//
|
|
||||||
// Anderer Monat: Fehler
|
|
||||||
//
|
|
||||||
default:
|
|
||||||
printf("Der Monat muss zwischen 1 und 12 sein.\n");
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
//
|
|
||||||
// Ergebnis ausgeben
|
|
||||||
//
|
|
||||||
printf("Der Monat %d.%d hat %d Tage.\n", monat, jahr, tageProMonat);
|
|
||||||
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 28 KiB |
|
|
@ -1,193 +0,0 @@
|
||||||
# 03 - Bit Operationen, Struct, Typedef
|
|
||||||
|
|
||||||
|
|
||||||
## 1. Bit Operationen
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Bit Operationen sind allgegenwärtig in den Computer-Wissenschaften und finden in vielen Disziplinen Anwendung. Folgend ein kleiner Auszug aus den wichtigsten Themen:
|
|
||||||
- **Bit Felder**: Sind die effizienteste Art, etwas darzustellen, dessen Zustand durch mehrere "wahr" oder "falsch" definiert werden kann. Besonders auf Systemen mit begrenzten Ressourcen sollte jede überflüssige Speicher-Allozierung vermieden werden.
|
|
||||||
|
|
||||||
Beispiel:
|
|
||||||
```c
|
|
||||||
// primary colors
|
|
||||||
#define BLUE 0b100
|
|
||||||
#define GREEN 0b010
|
|
||||||
#define RED 0b001
|
|
||||||
|
|
||||||
// mixed colors
|
|
||||||
#define BLACK 0 /* 000 */
|
|
||||||
#define YELLOW (RED | GREEN) /* 011 */
|
|
||||||
#define MAGENTA (RED | BLUE) /* 101 */
|
|
||||||
#define CYAN (GREEN | BLUE) /* 110 */
|
|
||||||
#define WHITE (RED | GREEN | BLUE) /* 111 */
|
|
||||||
```
|
|
||||||
[https://de.wikipedia.org/wiki/Bitfeld](https://de.wikipedia.org/wiki/Bitfeld)
|
|
||||||
|
|
||||||
- **Kommunikation**:
|
|
||||||
- **Prüfsummen/Paritätsbit**: Übertragungsfehler und Integrität können bis zu einem definiertem Grad erkannt werden. Je nach Komplexität der Berechnung können mehrere Fehler erkannt oder auch korrigiert werden.
|
|
||||||
[https://de.wikipedia.org/wiki/Parit%C3%A4tsbit](https://de.wikipedia.org/wiki/Parit%C3%A4tsbit), [https://de.wikipedia.org/wiki/Pr%C3%BCfsumme](https://de.wikipedia.org/wiki/Pr%C3%BCfsumme)
|
|
||||||
- **Stoppbit**: Markieren bei asynchronen seriellen Datenübertragungen das Ende bzw. Start eines definierten Blocks.
|
|
||||||
[https://de.wikipedia.org/wiki/Stoppbit](https://de.wikipedia.org/wiki/Stoppbit)
|
|
||||||
- **Datenflusssteuerung**: Unterschiedliche Verfahren, mit denen die Datenübertragung von Endgeräten an einem Datennetz, die nicht synchron arbeiten, so gesteuert wird, dass eine möglichst kontinuierliche Datenübermittlung ohne Verluste erfolgen kann.
|
|
||||||
[https://de.wikipedia.org/wiki/Datenflusssteuerung](https://de.wikipedia.org/wiki/Datenflusssteuerung)
|
|
||||||
- ...
|
|
||||||
|
|
||||||
- **Datenkompression**: Bei der Datenkompression wird versucht, redundante Informationen zu entfernen. Dazu werden die Daten in eine Darstellung überführt, mit der sich alle – oder zumindest die meisten – Information in kürzerer Form darstellen lassen.
|
|
||||||
[https://de.wikipedia.org/wiki/Datenkompression](https://de.wikipedia.org/wiki/Datenkompression)
|
|
||||||
- **Kryptographie**: Konzeption, Definition und Konstruktion von Informationssystemen, die widerstandsfähig gegen Manipulation und unbefugtes Lesen sind. [https://de.wikipedia.org/wiki/Verschl%C3%BCsselung](https://de.wikipedia.org/wiki/Verschl%C3%BCsselung)
|
|
||||||
- **Grafik-Programmierung**: XOR (oder ^) ist hier besonders interessant, weil eine zweite Eingabe derselben Eingabe die erste rückgängig macht (ein Beispiel dazu weiter unten: "Variablen tauschen, ohne Dritt-Variable
|
|
||||||
"). Ältere GUIs verwendeten dies für die Hervorhebung von Auswahlen und andere Überlagerungen, um kostspielige Neuzeichnungen zu vermeiden. Sie sind immer noch nützlich in langsamen Grafikprotokollen (z. B. Remote-Desktop).
|
|
||||||
|
|
||||||
### 1.1 Übungen
|
|
||||||
|
|
||||||
#### 1. Basis Operationen
|
|
||||||
Manipulationen von einzelnen Bits gehören zu den Basis Operationen und dienen als Grundlagen um weitere komplexere Konstrukte zu schaffen. Verfollständigen sie folgendes Beispiel mit den drei Basis Operationen:
|
|
||||||
```c
|
|
||||||
#include <stdlib.h>
|
|
||||||
|
|
||||||
int main() {
|
|
||||||
unsigned int number;
|
|
||||||
unsigned int bit = 3; // bit at position 3
|
|
||||||
|
|
||||||
// Setting a bit
|
|
||||||
number = ...; // solution: number |= 1 << bit;
|
|
||||||
|
|
||||||
// Clearing a bit
|
|
||||||
number = ...; // solution: number &= ~(1 << bit);
|
|
||||||
|
|
||||||
// Toggling a bit
|
|
||||||
number = ...; // solution; number ^= 1 << bit;
|
|
||||||
|
|
||||||
return EXIT_SUCCESS;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 2. Variablen tauschen (ohne Dritt-Variable)
|
|
||||||
Zwei Variablen zu vertauschen scheint ein einfach lösbares Problem zu sein. Eine offensichtliche Variante wäre mittels einer temporären Variablen:
|
|
||||||
```c
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <stdio.h>
|
|
||||||
|
|
||||||
int main(){
|
|
||||||
int a = 3;
|
|
||||||
int b = 4;
|
|
||||||
printf("a: %d; b: %d\n", a, b);
|
|
||||||
|
|
||||||
int temp = a;
|
|
||||||
a = b;
|
|
||||||
b = temp;
|
|
||||||
|
|
||||||
printf("a: %d; b: %d\n", a, b);
|
|
||||||
return EXIT_SUCCESS;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Es gibt aber auch eine Variante, die ohne zusätzliche Variable auskommt. Dabei wird die Tatsache, dass eine zweite XOR Operation eine erste XOR Operation rückgängig macht:
|
|
||||||
|
|
||||||
*0011 XOR 0100 = 0111*
|
|
||||||
|
|
||||||
*0111 XOR 0100 = 0011*
|
|
||||||
|
|
||||||
Somit kommt man von einem XOR Resultat (*0111*) wieder auf beide Anfangs Operanden zurück indem man einfach ein zweites Mal mit einem Operanden eine XOR Verknüpfung macht. Damit kann ein Operand als Zwischenspeicher dienen und man muss nicht extra eine Zusatzvariable verwenden.
|
|
||||||
|
|
||||||
Überlegen sie sich wie sie damit zwei Variablen vertauschen können ohne Zusatzvariable:
|
|
||||||
```c
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <stdio.h>
|
|
||||||
|
|
||||||
int main(){
|
|
||||||
int a = 3;
|
|
||||||
int b = 4;
|
|
||||||
printf("a: %d; b: %d\n", a, b);
|
|
||||||
|
|
||||||
|
|
||||||
...
|
|
||||||
|
|
||||||
/* Solutions:
|
|
||||||
// a == 0011; b == 0100
|
|
||||||
a ^= b; // a == 0111; b == 0100
|
|
||||||
b ^= a; // a == 0111; b == 0011
|
|
||||||
a ^= b; // a == 0100; b == 0011
|
|
||||||
*/
|
|
||||||
|
|
||||||
printf("a: %d; b: %d\n", a, b);
|
|
||||||
return EXIT_SUCCESS;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 3. Lower- / Uppercase
|
|
||||||
```c
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <stdio.h>
|
|
||||||
|
|
||||||
int main(){
|
|
||||||
char word[8] = "sREedEv";
|
|
||||||
char *wordptr = &word[0];
|
|
||||||
|
|
||||||
while(wordptr < &word[7]) {
|
|
||||||
printf("UPPERCASE: %c\n", *wordptr & '_'); // converts the char into uppercase regardless of the current casing
|
|
||||||
printf("LOWERCASE: %c\n", *wordptr | ' '); // converts the char into lowercase regardless of the current casing
|
|
||||||
wordptr++;
|
|
||||||
}
|
|
||||||
|
|
||||||
return EXIT_SUCCESS;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### 4. Prüfen auf 2-er Potenz
|
|
||||||
```c
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
|
|
||||||
int main(){
|
|
||||||
int a=32;
|
|
||||||
if(a > 0 && (a & (a - 1)) == 0){
|
|
||||||
printf("%d is a power of 2", a);
|
|
||||||
}
|
|
||||||
return EXIT_SUCCESS;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
___
|
|
||||||
## 2. Struct & typedef
|
|
||||||
|
|
||||||
### 2.1 Übungen
|
|
||||||
|
|
||||||
#### 1. Bit Operationen Rechner
|
|
||||||
- Bitweise Operationen mit 2 Operanden
|
|
||||||
- Rechnung wird als ein String über scanf dem Programm übergeben
|
|
||||||
- String wird in Token zerstückelt und in struct gespeichert:
|
|
||||||
```c
|
|
||||||
typedef struct {
|
|
||||||
unsigned int operand_1;
|
|
||||||
unsigned int operand_2;
|
|
||||||
char operation;
|
|
||||||
} Expression;
|
|
||||||
```
|
|
||||||
- Ausgabe in 3 verschiedenen Formaten:
|
|
||||||
```
|
|
||||||
Bin:
|
|
||||||
0000'0000'0000'0001
|
|
||||||
& 0000'0000'0000'0011
|
|
||||||
-------------------
|
|
||||||
0000'0000'0000'0001
|
|
||||||
|
|
||||||
Hex
|
|
||||||
0x01 & 0x03 = 0x01
|
|
||||||
|
|
||||||
Dec
|
|
||||||
1 & 3 = 1
|
|
||||||
```
|
|
||||||
|
|
||||||
___
|
|
||||||
## 4. Bewertung
|
|
||||||
|
|
||||||
Die gegebenenfalls gestellten Theorieaufgaben und der funktionierende Programmcode müssen der Praktikumsbetreuung gezeigt werden. Die Lösungen müssen mündlich erklärt werden können.
|
|
||||||
| Aufgabe | Kriterium | Gewicht |
|
|
||||||
| :-- | :-- | :-- |
|
|
||||||
| alle | Sie können das funktionierende Programm inklusive funktionierende Tests demonstrieren und erklären. | |
|
|
||||||
| gibIntWert | Eingabe, Bereichsüberprüfung korrekt | 1 |
|
|
||||||
| istSchaltjahr | Funktion korrekt | 1 |
|
|
||||||
| TageProMonat | Funktion korrekt | 1 |
|
|
||||||
| Aufgabe 2 | Fehlenden Teile ergänzt und lauffähig | 1 |
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 7.1 KiB |
Binary file not shown.
Binary file not shown.
|
|
@ -1,532 +0,0 @@
|
||||||
# 04 - Modularisieren von C Code
|
|
||||||
|
|
||||||
```{eval-rst}
|
|
||||||
.. figure:: zhaw_neg_P2945.jpg
|
|
||||||
:width: 100px
|
|
||||||
:name: logo
|
|
||||||
:align: right
|
|
||||||
```
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
```{eval-rst}
|
|
||||||
.. figure:: modularisieren_von_c_code.JPG
|
|
||||||
:width: 500px
|
|
||||||
:name: logo
|
|
||||||
:align: center
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## Inhalt
|
|
||||||
|
|
||||||
{ref}`04_introduction`
|
|
||||||
|
|
||||||
{ref}`04_learning_objectives`
|
|
||||||
|
|
||||||
{ref}`04_task_01`
|
|
||||||
|
|
||||||
{ref}`04_task_02`
|
|
||||||
|
|
||||||
{ref}`04_grading`
|
|
||||||
|
|
||||||
{ref}`04_appendix`
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
(04_introduction)=
|
|
||||||
## 1. Übersicht
|
|
||||||
|
|
||||||
In diesem Praktikum üben Sie modulare Programmierung indem Sie ein
|
|
||||||
Java Programm (bestehend aus drei Java Files) in ein entsprechendes C
|
|
||||||
Programm aus drei Modulen (aus je einem Header- und Implementations-
|
|
||||||
File) übersetzen. Sie passen das Makefile so an, dass die
|
|
||||||
entsprechenden Module mit kompiliert werden.
|
|
||||||
|
|
||||||
In der zweiten Aufgabe erstellen Sie Makefile Regeln für die drei
|
|
||||||
Schritte von den C Source Files zur graphischen Darstellung der
|
|
||||||
Abhängigkeiten.
|
|
||||||
|
|
||||||
```{eval-rst}
|
|
||||||
.. figure:: uebersicht.png
|
|
||||||
:width: 500px
|
|
||||||
:name: uebersicht
|
|
||||||
:align: center
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
Im Anhang ist eine Übersicht über die verwendeten File Formate gegeben.
|
|
||||||
|
|
||||||
|
|
||||||
(04_learning_objectives)=
|
|
||||||
## 2. Lernziele
|
|
||||||
|
|
||||||
In diesem Praktikum lernen Sie die Handgriffe um ein Programm zu modularisieren, d.h. in mehrere Module aufzuteilen.
|
|
||||||
|
|
||||||
* Sie wissen, dass ein Modul aus einem C-File und einem passenden
|
|
||||||
H-File besteht.
|
|
||||||
* Sie können Header Files korrekt strukturieren.
|
|
||||||
* Sie deklarieren im Header-File die öffentlichen Typen und Funktionen
|
|
||||||
eines Moduls.
|
|
||||||
* Sie wissen wie **Include Guards** anzuwenden sind.
|
|
||||||
* Sie können Module im `Makefile` zur Kompilation hinzufügen.
|
|
||||||
* Sie können `Makefile` Regeln schreiben.
|
|
||||||
|
|
||||||
Die Bewertung dieses Praktikums ist am Ende angegeben.
|
|
||||||
|
|
||||||
Erweitern Sie die vorgegebenen Code Gerüste, welche im `git`
|
|
||||||
Repository `snp-lab-code` verfügbar sind.
|
|
||||||
|
|
||||||
|
|
||||||
(04_task_01)=
|
|
||||||
## 3. Aufgabe 1: Modularisieren
|
|
||||||
Das zu ergänzende Programm dep2dot hat folgende Funktionalität:
|
|
||||||
|
|
||||||
Ergänzen Sie in **`modularize/src`** den Code in **`triangle.c`**,
|
|
||||||
**`read.h`**, **`read.c`**, **`rectang.h`** und **`rectang.c`** so
|
|
||||||
dass die Tests erfolgreich durchlaufen. Die C Implementation soll
|
|
||||||
dieselbe Funktionalität haben wie die gegebenen Java Files. Lehnen Sie
|
|
||||||
sich so nahe wie möglich an die Java Files an.
|
|
||||||
|
|
||||||
1. In den Header-Files implementieren Sie den Include-Guard und
|
|
||||||
deklarieren Sie die öffentlichen Funktionen und gegebenenfalls
|
|
||||||
**`#define`**.
|
|
||||||
2. In den Implementations-Files implementieren Sie die Funktionen.
|
|
||||||
|
|
||||||
Die drei Java Files liegen in **`modularize/java`**.
|
|
||||||
|
|
||||||
### Tipps
|
|
||||||
|
|
||||||
* Implementieren Sie die Symbole welche vollständig in Grossbuchstaben
|
|
||||||
geschrieben sind als **`#define`**.
|
|
||||||
* **`EOF`** kommt schon aus **`stdio.h`** und sollte deshalb nicht
|
|
||||||
mehr definiert werden.
|
|
||||||
* Jene **`#define`** welche von andern Modulen verwendet werden
|
|
||||||
kommen ins Header-File, die andern ins Implementations-File.
|
|
||||||
* Ein Grossteil des Java Codes aus den Methoden Bodies kann
|
|
||||||
eins-zu-eins in C übernommen werden. Listen Sie auf welche
|
|
||||||
Unterschiede es gibt:
|
|
||||||
|
|
||||||
<table>
|
|
||||||
<style>
|
|
||||||
table, th, td {
|
|
||||||
border: 1px solid black;
|
|
||||||
border-collapse: collapse;
|
|
||||||
}
|
|
||||||
table th:first-of-type {
|
|
||||||
width: 50%;
|
|
||||||
}
|
|
||||||
table th:nth-of-type(2) {
|
|
||||||
width: 50%;
|
|
||||||
}
|
|
||||||
</style>
|
|
||||||
<tr><th>Java</th><th>C</th></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
byte
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
boolean
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
|
|
||||||
```Java
|
|
||||||
true
|
|
||||||
```
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
false
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
System.out.print(…)
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
System.out.println(…)
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
System.in.read()
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
byte[] buffer = new byte[BUFFERSIZE];
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
public class rectang {
|
|
||||||
public boolean Rectangular(…)
|
|
||||||
{ … }
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
public class read {
|
|
||||||
public int getInt(...)
|
|
||||||
throws java.io.IOException
|
|
||||||
{ ... }
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
class triangle {
|
|
||||||
public static void main(String[] args)
|
|
||||||
throws java.io.IOException
|
|
||||||
{ ... }
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
read ReadInt = new read();
|
|
||||||
...
|
|
||||||
word = ReadInt.getInt(MAX_NUMBER);
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```Java
|
|
||||||
rectang Rect = new rectang();
|
|
||||||
...
|
|
||||||
if (Rect.Rectangular(a, b, c) == true) { ... }
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
```
|
|
||||||
System.out.println(
|
|
||||||
"-> Dreieck " + a + "-" + b + "-" + c
|
|
||||||
+ " ist rechtwinklig");
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td></td></tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
(04_task_02)=
|
|
||||||
## 4. Aufgabe 2: Makefile Regeln
|
|
||||||
|
|
||||||
Die folgenden drei Schritte erstellen von einem C Source File eine
|
|
||||||
graphische Darstellung der Abhängigkeiten:
|
|
||||||
|
|
||||||
1. `gcc ... -H .. file.c ... 2> file.dep` (Regeln im Makefile bereits vorhanden)
|
|
||||||
2. `dep2dot file.c <file.dep >file.dot` (in dieser Aufgabe zu erstellen)
|
|
||||||
3. `dot -Tpng file.dot >file.png` (in dieser Aufgabe zu erstellen)
|
|
||||||
|
|
||||||
Sie sollen für die Compiler-ähnlichen Programme `dep2dot` und `dot`
|
|
||||||
Makefile Regeln schreiben.
|
|
||||||
|
|
||||||
```{eval-rst}
|
|
||||||
.. figure:: uebersicht.png
|
|
||||||
:width: 500px
|
|
||||||
:name: uebersicht
|
|
||||||
:align: center
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
Das Programm `dep2dot` hat folgende Funktionalität:
|
|
||||||
|
|
||||||
|
|
||||||
1. Es liest von `stdin` die vom Compiler generierten
|
|
||||||
Abhängigkeits-Daten in Form des `dep` Formates ein.
|
|
||||||
2. Das erste und einzige Command Line Argument gibt das File an für
|
|
||||||
welches die von `stdin` gelesenen Abhängigkeiten gelten.
|
|
||||||
3. Auf `stdout` werden die Abhängigkeiten von `stdin` übersetzt als
|
|
||||||
`dot`-File Format ausgegeben.
|
|
||||||
|
|
||||||
Das Programm `dot` hat folgende Funktionalität:
|
|
||||||
1. Es liest die textuelle Beschreibung eines Graphen aus der
|
|
||||||
übergebenen Datei (erstes Argument) ein.
|
|
||||||
2. Auf `stdout` wird die grafische Darstellung der Beschreibung der
|
|
||||||
Eingabe-Datei im `png`-File Format ausgegeben.
|
|
||||||
|
|
||||||
Das `dep`-Format und das `dot`-Format sind im Anhang beschrieben.
|
|
||||||
|
|
||||||
Sie können die Funktionalität des Programms `dep2dot` kennen lernen,
|
|
||||||
indem Sie folgende Zeilen auf der Bash Shell ausführen. Das
|
|
||||||
`dep.input` File ist Teil der automatisierten Test Suite im
|
|
||||||
Verzeichnis `tests`:
|
|
||||||
|
|
||||||
|
|
||||||
```bash
|
|
||||||
bin/dep2dot dir/file <tests/dep.input >dep.dot
|
|
||||||
dot -Tpng dep.dot >dep.png
|
|
||||||
firefox dep.png
|
|
||||||
```
|
|
||||||
|
|
||||||
Als Resultat sollte Firefox folgende Graphik darstellen:
|
|
||||||
|
|
||||||
|
|
||||||
```{eval-rst}
|
|
||||||
.. figure:: dep_dot.png
|
|
||||||
:width: 150px
|
|
||||||
:name: dep_dot
|
|
||||||
:align: center
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Definieren Sie im `Makefile` Regeln, welche die einzelnen Schritte von
|
|
||||||
den Source Files zu den `png` Files ausführen.
|
|
||||||
|
|
||||||
|
|
||||||
Prüfen Sie schliesslich die Umsetzung Aufgabe mittels `make dep-clean
|
|
||||||
dep && firefox src/*.png.`
|
|
||||||
|
|
||||||
|
|
||||||
### 4.1 Neue Regeln hinzufügen
|
|
||||||
|
|
||||||
|
|
||||||
Führen Sie im `Makefile` an den angegebenen Stellen folgende
|
|
||||||
Ergänzungen durch
|
|
||||||
|
|
||||||
* definieren Sie eine Variable `DEPFILES` deren Inhalt die Liste alle
|
|
||||||
Einträge der Variable `SOURCES` ist, wobei bei allen die Endung `.c`
|
|
||||||
durch die Endung `.c.png` ersetzt ist
|
|
||||||
* fügen Sie zum `Pseudo-Target .PHONEY` das Target `dep` dazu – dies
|
|
||||||
besagt, dass das später folgenden Target `dep` nicht ein File
|
|
||||||
repräsentiert (ohne dieses Setting würde make gegebenenfalls nach
|
|
||||||
einem File mit Namen `dep` suchen um zu entscheiden ob es
|
|
||||||
inkrementell gebildet werden muss)
|
|
||||||
* schreiben Sie das Target `dep` gemäss der Beschreibung im Makefile
|
|
||||||
* schreiben Sie die Suffix Regel für die Übersetzung von `.png <-
|
|
||||||
.dot` gemäss Vorgabe im `Makefile` (als Inspiration, siehe auch die
|
|
||||||
`%.c.dep: %.c` Suffix Regel weiter unten im `Makefile`) – erklären
|
|
||||||
Sie was die Regel macht
|
|
||||||
* schreiben Sie die Suffix Regel für die Übersetzung von` .dot <-
|
|
||||||
.dep` gemäss Vorgabe im `Makefile` – erklären Sie was die Regel
|
|
||||||
macht
|
|
||||||
|
|
||||||
Die Umsetzung der obigen Änderungen sind erfolgreich, wenn Sie
|
|
||||||
folgende Shell Command Line erfolgreich ausführen können und in
|
|
||||||
Firefox die Abhängigkeiten der C-Files von den Inclu-de Files
|
|
||||||
dargestellt wird.
|
|
||||||
|
|
||||||
`make dep-clean dep && firefox src/*.png.`
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
(04_grading)=
|
|
||||||
## 5. Bewertung
|
|
||||||
|
|
||||||
Die gegebenenfalls gestellten Theorieaufgaben und der funktionierende Programmcode müssen der Praktikumsbetreuung gezeigt werden. Die Lösungen müssen mündlich erklärt werden.
|
|
||||||
|
|
||||||
| Aufgabe | Kriterium | Punkte |
|
|
||||||
| :-- | :-- | :-- |
|
|
||||||
| 1 | Sie können das funktionierende Programm inklusive funktionierende Tests demonstrieren und erklären. | |
|
|
||||||
| 1 | Module einbinden, Header Files schreiben | 2 |
|
|
||||||
| 2 | Sie können das funktionierende Makefile demonstrieren und erklären. | |
|
|
||||||
| 2 | Neue Regeln hinzufügen | 2 |
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
(04_appendix)=
|
|
||||||
## 6. Anhang
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### 6.1 Verwendete zusätzliche Sprach Elemente
|
|
||||||
|
|
||||||
<table><tr><td>
|
|
||||||
|
|
||||||
**Sprach Element**
|
|
||||||
|
|
||||||
</td><td>
|
|
||||||
|
|
||||||
**Beschreibung**
|
|
||||||
|
|
||||||
</td></tr>
|
|
||||||
<tr><td>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
```C
|
|
||||||
fprintf(stderr, "v=%d", v)
|
|
||||||
```
|
|
||||||
|
|
||||||
</td><td>
|
|
||||||
|
|
||||||
Formatierte Ausgabe auf den Standard Error Stream. Siehe ***man 3
|
|
||||||
stderr*** und ***man 3 fprintf***.
|
|
||||||
|
|
||||||
</td></tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
|
|
||||||
### 6.2 Verarbeitung und verwendete File Formate <a name="file_formats"></a>
|
|
||||||
|
|
||||||
Das Programm in diesem Praktikum ist Teil für die graphische
|
|
||||||
Darstellung von `#include` File Abhängigkeit von C Files.
|
|
||||||
|
|
||||||
Den ersten Schritt für die Darstellung der `#include` File
|
|
||||||
Abhängigkeiten bietet der Compiler. Der Compiler kann mittels der `-H`
|
|
||||||
Command Line Option auf `stderr` ein Text File generieren, welches die
|
|
||||||
tatsächlich verwendeten Header Files auflistet. Zusätzlich wird im
|
|
||||||
Resultat die Verschachtelungstiefe der Includes angegeben.
|
|
||||||
|
|
||||||
Im zweiten Schritt übersetzt das Programm (`dep2dot`) dieses
|
|
||||||
Praktikums solche Dependency Files (`dep`) in eine Text Repräsentation
|
|
||||||
der Abhängigkeiten (`dot`) welche in graphische Darstel-lung (`png`)
|
|
||||||
übersetzt werden kann.
|
|
||||||
|
|
||||||
Als Tool zur Übersetzung der `dot` Files in das `png` Format dient das
|
|
||||||
`dot` Tool. Dieses Tool muss gegebenenfalls installiert werden:
|
|
||||||
|
|
||||||
```sudo apt install graphviz```
|
|
||||||
|
|
||||||
Die `png` Files können dann z.B. in der Programm Dokumentation
|
|
||||||
integriert werden (Darstellung zu Test Zwecken z.B. mittels `firefox
|
|
||||||
file.png`).
|
|
||||||
|
|
||||||
|
|
||||||
#### 6.2.1 dep File
|
|
||||||
|
|
||||||
|
|
||||||
Siehe: `man gcc`
|
|
||||||
|
|
||||||
```bash
|
|
||||||
-H Print the name of each header file used, in addition to other
|
|
||||||
normal activities. Each name is indented to show how deep in the
|
|
||||||
#include stack it is. [...]
|
|
||||||
```
|
|
||||||
|
|
||||||
Das File wird auf `stderr` ausgegeben.
|
|
||||||
|
|
||||||
**Beispiel File** (für Abhängigkeiten des `main.c` Files des `dep2dot` Programms)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
. /usr/include/stdio.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/libc-header-start.h
|
|
||||||
... /usr/include/features.h
|
|
||||||
.... /usr/include/x86_64-linux-gnu/sys/cdefs.h
|
|
||||||
..... /usr/include/x86_64-linux-gnu/bits/wordsize.h
|
|
||||||
..... /usr/include/x86_64-linux-gnu/bits/long-double.h
|
|
||||||
.... /usr/include/x86_64-linux-gnu/gnu/stubs.h
|
|
||||||
..... /usr/include/x86_64-linux-gnu/gnu/stubs-64.h
|
|
||||||
.. /usr/lib/gcc/x86_64-linux-gnu/7/include/stddef.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/types.h
|
|
||||||
... /usr/include/x86_64-linux-gnu/bits/wordsize.h
|
|
||||||
... /usr/include/x86_64-linux-gnu/bits/typesizes.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/types/__FILE.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/types/FILE.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/libio.h
|
|
||||||
... /usr/include/x86_64-linux-gnu/bits/_G_config.h
|
|
||||||
.... /usr/lib/gcc/x86_64-linux-gnu/7/include/stddef.h
|
|
||||||
.... /usr/include/x86_64-linux-gnu/bits/types/__mbstate_t.h
|
|
||||||
... /usr/lib/gcc/x86_64-linux-gnu/7/include/stdarg.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/stdio_lim.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/sys_errlist.h
|
|
||||||
. /usr/include/stdlib.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/libc-header-start.h
|
|
||||||
.. /usr/lib/gcc/x86_64-linux-gnu/7/include/stddef.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/floatn.h
|
|
||||||
... /usr/include/x86_64-linux-gnu/bits/floatn-common.h
|
|
||||||
.... /usr/include/x86_64-linux-gnu/bits/long-double.h
|
|
||||||
.. /usr/include/x86_64-linux-gnu/bits/stdlib-float.h
|
|
||||||
. src/error.h
|
|
||||||
.. /usr/lib/gcc/x86_64-linux-gnu/7/include/stddef.h
|
|
||||||
. src/data.h
|
|
||||||
.. /usr/lib/gcc/x86_64-linux-gnu/7/include/stddef.h
|
|
||||||
. src/output.h
|
|
||||||
Multiple include guards may be useful for:
|
|
||||||
/usr/include/x86_64-linux-gnu/bits/stdlib-float.h
|
|
||||||
/usr/include/x86_64-linux-gnu/bits/sys_errlist.h
|
|
||||||
/usr/include/x86_64-linux-gnu/bits/typesizes.h
|
|
||||||
/usr/include/x86_64-linux-gnu/gnu/stubs-64.h
|
|
||||||
/usr/include/x86_64-linux-gnu/gnu/stubs.h
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
#### 6.2.2 dot File
|
|
||||||
|
|
||||||
**Graphviz** ist ein mächtiges Tool-Set welches Graphen, definiert in
|
|
||||||
einem `dot`-Text File, automatisch anordnet und in `png`, `gif` und
|
|
||||||
andere Formate übersetzt.
|
|
||||||
|
|
||||||
Siehe die offizielle Web-Page
|
|
||||||
[https://www.graphviz.org/](https://www.graphviz.org/).
|
|
||||||
|
|
||||||
Es gibt als Teil dieses Tool-Sets verschiedene Übersetzer. Der hier
|
|
||||||
verwendete ist der Basis-übersetzer: `dot`.
|
|
||||||
|
|
||||||
Das `dot`-File Format kennt viele Möglichkeiten die Knoten und Kanten
|
|
||||||
eines Graphen und de-ren Anordnung anzugeben.
|
|
||||||
|
|
||||||
Der Vorteil eines solchen Tool-Sets ist, dass man den Inhalt (den
|
|
||||||
Graphen) einfach definieren kann und sich nicht um das komplexe
|
|
||||||
Problem der ansprechenden Visualisierung kümmern muss.
|
|
||||||
|
|
||||||
**Beispiel File** (`dot -Tpng sample.dot > sample.png`)
|
|
||||||
|
|
||||||
```C
|
|
||||||
digraph G {
|
|
||||||
node [shape=box]
|
|
||||||
A [label="a.c"];
|
|
||||||
B [label="a.h"];
|
|
||||||
C [label="b.h"];
|
|
||||||
|
|
||||||
subgraph cluster_c0 {
|
|
||||||
label="main"; color=black;
|
|
||||||
A;
|
|
||||||
}
|
|
||||||
|
|
||||||
subgraph cluster_c1 {
|
|
||||||
label="others"; style=filled; col-or=lightgrey;
|
|
||||||
{ B; C; rank=same; }
|
|
||||||
}
|
|
||||||
|
|
||||||
A -> B;
|
|
||||||
A -> C;
|
|
||||||
B -> C;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
#### 6.2.3 png File
|
|
||||||
|
|
||||||
Das `png` Format ist ein verlustfrei komprimiertes Raster Graphik
|
|
||||||
Format. Es wird oft in Web Pages verwendet.
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
Version: 15.02.2022
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 3.3 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 4.3 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 392 KiB |
|
|
@ -1 +0,0 @@
|
||||||
<mxfile host="Electron" modified="2022-02-07T21:41:53.021Z" agent="5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/16.5.1 Chrome/96.0.4664.110 Electron/16.0.7 Safari/537.36" etag="nbLc9Vjb_iVSFHhKpDKu" version="16.5.1" type="device"><diagram id="L8fo7XVtsVLzhWI8Oabt" name="Page-1">7VnRcuIgFP2aPLoTiIn6WLXd7sx2ptPuTrf7RhM0TDG4BGvs1y9RYgLoGjPqVLtPkgtc4Jx74IKON5hkXzmaxncswtSBbpQ53tCBEAReR/7kloWyuK67sow5iZStNDySd1w0VNYZiXCqNRSMUUGmujFkSYJDodkQ52yuNxsxqo86RWNsGR5DRG3rE4lErKwg6JUVt5iMYzV0F6oVT1DRWK0kjVHE5hWTd+14A86YWJUm2QDTHL0Cl1W/my2164lxnIg6He5GrYenJLv986310P99tfj56oKW8vKG6EwtWE1WLAoEcBJd5UDKr5CiNCXhj5gkjtePxYRKI5BFzmZJhPOBXPkle9wQWtStHOLIwrmcOFjDIQMJswkWfCGbzEvAfQViXIG6sHFMkSBvunukeB+v3a1HuGdEDgxdFaR+EWoqRNtdV3eRshkPsepVBdhw1G3vcCQQH2NhOZKFyrJL05K/PbiE/7n0oUFBryGXpiMAT8ultxeXCUvwv0j86LQFro62Z6Jdl7ZOoDuC7dPSVmwlFd6oTZzk4Tt6kSelRhmiZJzkwpScYC4Nb5gLIk+iK1UxIVGU++hznJJ39LL0l9M7zZezXKDfd/zhmvDcAc40TtQxqTqXh1M1FLYHpB0fyrv7BcBuT4f+IJHR0p0WuigcsNEoxUdhst1EgBFK46XowDmr0RTR2aqxY3EYX4YY2zvEGLQ7UNcNOEhkGAoPTiVG//OK0TwaG2c0O8/YI4sxsDh8+QAkrq+lqx5ntsE25bR0dHztdj+vdk2eG2t3Z8AcWbu9z8vhwa4m5jPDqTkE9lPPPbBolCmK0OlKBWeveMAo4yW3I0KpYaqfMc1jIvDjFIX5mHOOpluCYkPGVCMsCri7vgY37NlbPNwQNp67PUI0SvbGH9r42zK6GPyt3H/DEXta/Bs9qdTbxHBGxK9K+Vm1ysvDrFIxXOy57cnpLfeXnYH1UVIb36DdvPI13S7r3h1PmdoA+16SXa6ireftoJ6iTeIOp2g7LVlcLvymIIBbD34zzagBv/ws/5ZaiaX8d8+7/gs=</diagram></mxfile>
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 7.1 KiB |
|
|
@ -1,127 +0,0 @@
|
||||||
# 04 - Modularisieren von C Code
|
|
||||||
|
|
||||||
___
|
|
||||||
## 1. Übersicht
|
|
||||||
|
|
||||||
In diesem Praktikum wird eine kleine Sammlung von Funktionen als Modul erstellt.
|
|
||||||
|
|
||||||
In der ersten Aufgabe schreiben Sie zu einem bestehenden C Programm die notwendigen Header Files plus passen das Makefile so an, dass die entsprechenden Module mit kompiliert werden.
|
|
||||||
|
|
||||||
In der zweiten Aufgabe erstellen Sie Makefile Regeln um aus Konfigurationsdateien graphischen Darstellungen zu erzeugen.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 2. Lernziele
|
|
||||||
|
|
||||||
In diesem Praktikum lernen Sie die Handgriffe um ein Programm zu modularisieren, d.h. in mehrere Module aufzuteilen.
|
|
||||||
|
|
||||||
- Sie wissen, dass ein Modul aus einem C-File und einem passenden H-File bestehen.
|
|
||||||
- Sie können Header Files korrekt strukturieren.
|
|
||||||
- Sie wissen wie **Include Guards** anzuwenden sind.
|
|
||||||
- Sie können Module im **Makefile** zur Kompilation hinzufügen.
|
|
||||||
- Sie können anhand einer Beschreibung Typen und Funktionen in den passenden Header Files deklarieren.
|
|
||||||
- Sie können **Makefile** Regeln schreiben.
|
|
||||||
|
|
||||||
Die Bewertung dieses Praktikums ist am Ende angegeben.
|
|
||||||
|
|
||||||
Erweitern Sie die vorgegebenen Code Gerüste, welche im **git** Repository **snp-lab-code** verfügbar sind.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 3. Aufgabe 1: Modularisieren
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### 3.1 Teilaufgabe Modules einbinden, Header Files schreiben
|
|
||||||
|
|
||||||
- src/objects.h
|
|
||||||
- 2 Datenstukturen definieren
|
|
||||||
- `struct point` mit 2 double für x und y Koordinate
|
|
||||||
- `struct line` mit 2 point
|
|
||||||
- src/functions.h und .c
|
|
||||||
- 2 Funktionen deklarieren und definieren
|
|
||||||
- Berechnung der Länge `get_length`einer Linie (Annahme: Koordinaten sind alle positiv)
|
|
||||||
- l = sqrt(h^ 2 + b^ 2)
|
|
||||||
- ev. muss hier in den Anhang `#include <math.h>`
|
|
||||||
- Berechnung der Steigung `get_slope` der Linie gegenüber dem Koordinatensystem
|
|
||||||
- m = h / b
|
|
||||||
- tests vorgeben
|
|
||||||
|
|
||||||
- src/objects.h
|
|
||||||
- Include Guard
|
|
||||||
- Includes
|
|
||||||
- Struct für Punkt und Linie
|
|
||||||
- Include Guard
|
|
||||||
- src/functions.h
|
|
||||||
- Include Guard
|
|
||||||
- Includes
|
|
||||||
- Deklarationen der Funktionen für Berechnung der Länge und Steigung
|
|
||||||
- Include Guard
|
|
||||||
- src/functions.c
|
|
||||||
- Includes
|
|
||||||
- Definitionen der Funktionen für Berechnung der Länge und Steigung
|
|
||||||
- Include Guard
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
## 4. Aufgabe 2: Makefile Regeln
|
|
||||||
|
|
||||||
Makefile ergänzen, damit Modul `functions` korrekt eingebunden und kompiliert wird.
|
|
||||||
|
|
||||||
1. Kompilieren Sie das ganze mittels **make clean default**. Es sollten keine Compiler Fehler auftreten.
|
|
||||||
|
|
||||||
### 4.1 Neue Regeln hinzufügen
|
|
||||||
|
|
||||||
- Vorraussetzung: tab2svg.sh aus Praktikum 3 wird um die Möglichkeit erweitert eine Linie zu zeichnen (`line:x1:y1:x2:y2:color`)
|
|
||||||
- Studierende erstellen
|
|
||||||
- mind. 2 Files `long.line` und `short.line` mit 2 unterschiedlichen Linien
|
|
||||||
- Makefile Regeln um aus einem File `.line` ein File `.svg` mit Hilfe des Scripts zu erstellen
|
|
||||||
- PHONY Regel `display` um beide `.svg` mit Firefox darzustellen
|
|
||||||
- Vorgabe: sie sollen eine Variable für die Input-Dateien nutzen
|
|
||||||
|
|
||||||
Nachdem das Programm in Aufgabe 1 umgesetzt ist, geht es nun darum, im **Makefile** Regeln zu definieren welche die einzelnen Schritte von den Source Files zu den **png** Files ausführen.
|
|
||||||
|
|
||||||
Prüfen Sie schliesslich die Umsetzung mittels `make display`.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 5. Aufgabe 3
|
|
||||||
- Studierende sollen Ausgabe von `make doc` analysieren und die Include Diagramme erklären können
|
|
||||||
```
|
|
||||||
make doc
|
|
||||||
firefox doc/index.html &
|
|
||||||
```
|
|
||||||
|
|
||||||
___
|
|
||||||
## 6. Bewertung
|
|
||||||
|
|
||||||
|
|
||||||
Die gegebenenfalls gestellten Theorieaufgaben und der funktionierende Programmcode müssen der Praktikumsbetreuung gezeigt werden. Die Lösungen müssen mündlich erklärt werden.
|
|
||||||
|
|
||||||
___
|
|
||||||
## 7. Erweiterung Doxyfile für Abhängigkeitsanalyse
|
|
||||||
|
|
||||||
```
|
|
||||||
--- /home/vagrant/huno/snp-new/snp/praktika/Shared/work/Doxyfile 2022-02-07 21:16:42.343302707 +0100
|
|
||||||
+++ /home/vagrant/snp/Doxyfile 2022-02-07 22:22:36.266839126 +0100
|
|
||||||
@@ -297,14 +297,14 @@
|
|
||||||
UML_LOOK = NO
|
|
||||||
UML_LIMIT_NUM_FIELDS = 10
|
|
||||||
TEMPLATE_RELATIONS = NO
|
|
||||||
-INCLUDE_GRAPH = NO
|
|
||||||
-INCLUDED_BY_GRAPH = NO
|
|
||||||
+INCLUDE_GRAPH = YES
|
|
||||||
+INCLUDED_BY_GRAPH = YES
|
|
||||||
CALL_GRAPH = NO
|
|
||||||
CALLER_GRAPH = NO
|
|
||||||
-GRAPHICAL_HIERARCHY = NO
|
|
||||||
-DIRECTORY_GRAPH = NO
|
|
||||||
+GRAPHICAL_HIERARCHY = YES
|
|
||||||
+DIRECTORY_GRAPH = YES
|
|
||||||
DOT_IMAGE_FORMAT = png
|
|
||||||
-INTERACTIVE_SVG = NO
|
|
||||||
+INTERACTIVE_SVG = YES
|
|
||||||
DOT_PATH =
|
|
||||||
DOTFILE_DIRS =
|
|
||||||
MSCFILE_DIRS =
|
|
||||||
```
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 54 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 1.7 KiB |
|
|
@ -1,32 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="160" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="80 210 160 140" height="140" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 50 L120 50 L120 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath3"
|
|
||||||
><path d="M0 0 L0 60 L30 60 L30 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(100,230)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(100,230)"
|
|
||||||
><rect fill="none" x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="11" font-size="30px" y="32.7917" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Control</text
|
|
||||||
></g
|
|
||||||
><g transform="translate(150,270)"
|
|
||||||
><path fill="none" d="M10.5 39.5 L10.5 10.5" clip-path="url(#clipPath3)"
|
|
||||||
/><path fill="none" d="M17 28.7417 L10.5 40 L4 28.7417" clip-path="url(#clipPath3)"
|
|
||||||
/></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 1.9 KiB |
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
Before Width: | Height: | Size: 3.1 KiB |
|
|
@ -1,52 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="160" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="80 130 160 250" height="250" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 50 L120 50 L120 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath3"
|
|
||||||
><path d="M0 0 L0 60 L30 60 L30 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(100,310)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(100,310)"
|
|
||||||
><rect fill="none" x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="19" font-size="30px" y="32.7917" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Model</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(100,230)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(100,230)"
|
|
||||||
><rect fill="none" x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="11" font-size="30px" y="32.7917" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Control</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(100,150)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(100,150)"
|
|
||||||
><rect fill="none" x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="27" font-size="30px" y="32.7917" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>View</text
|
|
||||||
></g
|
|
||||||
><g transform="translate(150,190)"
|
|
||||||
><path fill="none" d="M10.5 39.5 L10.5 10.5" clip-path="url(#clipPath3)"
|
|
||||||
/><path fill="none" d="M17 28.7417 L10.5 40 L4 28.7417" clip-path="url(#clipPath3)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(150,270)"
|
|
||||||
><path fill="none" d="M10.5 39.5 L10.5 10.5" clip-path="url(#clipPath3)"
|
|
||||||
/><path fill="none" d="M17 28.7417 L10.5 40 L4 28.7417" clip-path="url(#clipPath3)"
|
|
||||||
/></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 3.2 KiB |
|
|
@ -1,109 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
|
||||||
<diagram program="umlet" version="14.3.0">
|
|
||||||
<zoom_level>10</zoom_level>
|
|
||||||
<element>
|
|
||||||
<id>UMLClass</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>180</x>
|
|
||||||
<y>310</y>
|
|
||||||
<w>120</w>
|
|
||||||
<h>50</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>View
|
|
||||||
fontsize=30</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLClass</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>180</x>
|
|
||||||
<y>390</y>
|
|
||||||
<w>120</w>
|
|
||||||
<h>50</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Control
|
|
||||||
fontsize=30</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLClass</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>180</x>
|
|
||||||
<y>470</y>
|
|
||||||
<w>120</w>
|
|
||||||
<h>50</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Model
|
|
||||||
fontsize=30</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>230</x>
|
|
||||||
<y>430</y>
|
|
||||||
<w>30</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<-</panel_attributes>
|
|
||||||
<additional_attributes>10.0;40.0;10.0;10.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>230</x>
|
|
||||||
<y>350</y>
|
|
||||||
<w>30</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<-</panel_attributes>
|
|
||||||
<additional_attributes>10.0;40.0;10.0;10.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Text</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>320</x>
|
|
||||||
<y>320</y>
|
|
||||||
<w>210</w>
|
|
||||||
<h>40</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>//Text Element
|
|
||||||
View kennt Control,
|
|
||||||
Control aber nicht View
|
|
||||||
</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Text</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>320</x>
|
|
||||||
<y>400</y>
|
|
||||||
<w>210</w>
|
|
||||||
<h>40</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>//Text Element
|
|
||||||
Control kennt Model,
|
|
||||||
Model aber nicht Control.
|
|
||||||
|
|
||||||
</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Text</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>320</x>
|
|
||||||
<y>480</y>
|
|
||||||
<w>250</w>
|
|
||||||
<h>40</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>//Text Element
|
|
||||||
Das Main Programm kombiniert die
|
|
||||||
Komponenten nach obigen Vorgaben
|
|
||||||
und startet die Abarbeitung von Eingaben
|
|
||||||
über die View.
|
|
||||||
|
|
||||||
|
|
||||||
</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
</diagram>
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 7.7 KiB |
|
|
@ -1,80 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="430" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="160 290 430 250" height="250" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 40 L250 40 L250 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath3"
|
|
||||||
><path d="M0 0 L0 40 L210 40 L210 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath4"
|
|
||||||
><path d="M0 0 L0 50 L120 50 L120 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath5"
|
|
||||||
><path d="M0 0 L0 60 L30 60 L30 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g font-family="sans-serif" font-size="14px" transform="translate(320,480)"
|
|
||||||
><text x="5" xml:space="preserve" y="17.9688" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
>Das Main Programm kombiniert die</text
|
|
||||||
><text x="5" xml:space="preserve" y="33.9375" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
>Komponenten nach obigen Vorgaben</text
|
|
||||||
><text x="5" xml:space="preserve" y="49.9062" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
>und startet die Abarbeitung von Eingaben</text
|
|
||||||
><text x="5" xml:space="preserve" y="65.875" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
>über die View.</text
|
|
||||||
></g
|
|
||||||
><g font-family="sans-serif" font-size="14px" transform="translate(320,400)"
|
|
||||||
><text x="5" xml:space="preserve" y="17.9688" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
>Control kennt Model,</text
|
|
||||||
><text x="5" xml:space="preserve" y="33.9375" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
>Model aber nicht Control.</text
|
|
||||||
></g
|
|
||||||
><g font-family="sans-serif" font-size="14px" transform="translate(320,320)"
|
|
||||||
><text x="5" xml:space="preserve" y="17.9688" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
>View kennt Control,</text
|
|
||||||
><text x="5" xml:space="preserve" y="33.9375" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
>Control aber nicht View</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(180,470)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(180,470)"
|
|
||||||
><rect fill="none" x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath4)"
|
|
||||||
/><text x="19" font-size="30px" y="32.7917" clip-path="url(#clipPath4)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Model</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(180,390)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(180,390)"
|
|
||||||
><rect fill="none" x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath4)"
|
|
||||||
/><text x="11" font-size="30px" y="32.7917" clip-path="url(#clipPath4)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Control</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(180,310)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(180,310)"
|
|
||||||
><rect fill="none" x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath4)"
|
|
||||||
/><text x="27" font-size="30px" y="32.7917" clip-path="url(#clipPath4)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>View</text
|
|
||||||
></g
|
|
||||||
><g transform="translate(230,350)"
|
|
||||||
><path fill="none" d="M10.5 39.5 L10.5 10.5" clip-path="url(#clipPath5)"
|
|
||||||
/><path fill="none" d="M17 28.7417 L10.5 40 L4 28.7417" clip-path="url(#clipPath5)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(230,430)"
|
|
||||||
><path fill="none" d="M10.5 39.5 L10.5 10.5" clip-path="url(#clipPath5)"
|
|
||||||
/><path fill="none" d="M17 28.7417 L10.5 40 L4 28.7417" clip-path="url(#clipPath5)"
|
|
||||||
/></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 4.7 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 1.5 KiB |
|
|
@ -1,25 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="160" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="80 300 160 90" height="90" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 50 L120 50 L120 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(100,320)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(100,320)"
|
|
||||||
><rect fill="none" x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="19" font-size="30px" y="32.7917" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Model</text
|
|
||||||
></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 1.6 KiB |
Binary file not shown.
Binary file not shown.
|
|
@ -1,272 +0,0 @@
|
||||||
05 - SNP: TicTacToe
|
|
||||||
##############
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
.. image:: zhaw_neg_P2945.jpg
|
|
||||||
:width: 100px
|
|
||||||
:height: 100px
|
|
||||||
:scale: 25 %
|
|
||||||
:align: right
|
|
||||||
|
|
||||||
.. contents::
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Übersicht
|
|
||||||
*********
|
|
||||||
In diesem Praktikum erweitern Sie einen Programm Rahmen zu einem funktionierenden TicTacToe Spiel. Bei TicTacToe legen zwei Spieler abwechselnd auf einem 3x3 Brett einen Stein, bis ein Spieler mit einer horizontalen, vertikalen oder diagonalen Linie gewinnt, oder alle Felder besetzt sind.
|
|
||||||
|
|
||||||
.. image:: TicTacToe.svg
|
|
||||||
|
|
||||||
In der Aufgabe implementieren Sie die fehlenden Funktionen bis alle Tests erfolgreich durchlau-fen. Die gewählte Vorgehensweise ist somit TDD – Test-Driven-Development: es existieren zuerst Tests welche alle fehlschlagen. Schrittweise werden die Funktionen implementiert bis alle Tests erfolgreich durchlaufen.
|
|
||||||
|
|
||||||
Wenn die Tests erfolgreich durchlaufen, wird auch das Programm funktionieren und Sie können jemanden mit dem Spiel herausfordern 😉.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Lernziele
|
|
||||||
*********
|
|
||||||
In diesem Praktikum lernen Sie den Zugriff auf Arrays.
|
|
||||||
|
|
||||||
* Sie können anhand einer Beschreibung im Code die fehlenden Funktionen implementieren wo auf Arrays zugegriffen wird.
|
|
||||||
|
|
||||||
Die Bewertung dieses Praktikums ist am Ende angegeben.
|
|
||||||
|
|
||||||
Erweitern Sie die vorgegebenen Code Gerüste, welche im git Repository snp-lab-code verfügbar sind.
|
|
||||||
|
|
||||||
|
|
||||||
Aufgabe: TicTacToe
|
|
||||||
******************
|
|
||||||
Das zu ergänzende Programm tic-tac-toe hat folgende Funktionalität:
|
|
||||||
#. es stellt ein 3x3 TicTacToe Spielbrett auf dem Terminal dar
|
|
||||||
#. es liest von stdin eine Ziffer 0…9 ein, wobei 0 für Programm-Terminieren, die übrigen Ziffern für die Wahl eines Feldes stehen
|
|
||||||
#. der erste Spielzug wird von Spieler A geführt, danach wechselt das Programm zwischen den Spielern A und B
|
|
||||||
# bei Gewinn oder bei vollem Brett ist das Spiel vorbei
|
|
||||||
|
|
||||||
Wenn die Aufgabe erfolgreich umgesetzt ist, können Sie das Spiel ausführen:
|
|
||||||
```bash
|
|
||||||
bin/tic-tac-toe
|
|
||||||
```
|
|
||||||
|
|
||||||
Als Abnahme müssen die Tests unverändert ohne Fehler ausgeführt werden (``make test``).
|
|
||||||
|
|
||||||
Die Architektur des Programms folgt dem MVC – Model-View-Control Paradigma. Dieses Paradigma besagt, dass die View (Eingabe und Darstellung) über Control (Vermittler) das Modell (die eigentliche Programm-Logik) steuert und darstellt. Dabei sind folgende Abhängigkeiten gegeben:
|
|
||||||
|
|
||||||
.. image:: MVC_pattern.svg
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Test-Driven-Development
|
|
||||||
=======================
|
|
||||||
|
|
||||||
Das Programm besteht aus folgenden Files:
|
|
||||||
|
|
||||||
.. list-table::
|
|
||||||
|
|
||||||
* - Datei
|
|
||||||
- ToDo
|
|
||||||
* - Makefile
|
|
||||||
- -
|
|
||||||
* - tests/tests.c
|
|
||||||
- -
|
|
||||||
* - src/main.c
|
|
||||||
- -
|
|
||||||
* - src/view.h
|
|
||||||
- -
|
|
||||||
* - src/view.c
|
|
||||||
- -
|
|
||||||
* - src/control.h
|
|
||||||
- -
|
|
||||||
* - src/control.c
|
|
||||||
- -
|
|
||||||
* - src/model.h
|
|
||||||
- -
|
|
||||||
* - src/model.c
|
|
||||||
- siehe unten
|
|
||||||
|
|
||||||
|
|
||||||
1. Führen Sie ``make test`` aus::
|
|
||||||
|
|
||||||
Suite: lab test
|
|
||||||
Test: test_model_init
|
|
||||||
init_model:... 0/0 FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_get_state ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_get_winner ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_can_move ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_move ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_get_win_line ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
|
|
||||||
Run Summary: Type Total Ran Passed Failed Inactive
|
|
||||||
suites 1 1 n/a 0 0
|
|
||||||
tests 6 6 0 6 0
|
|
||||||
asserts 6 6 0 6 n/a
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
2. Konzentrieren Sie sich auf den ersten Test der fehlschlägt. Dies ist ein Unit Test, welcher die Funktion **model_init()** prüft. Suchen Sie die Funktion in **src/model.h** und **src/model.c**.
|
|
||||||
Was ist die geforderte Funktionalität und wie ist sie implementiert?
|
|
||||||
Suchen Sie die darin aufgerufene **model_init()** Funktion und implementieren Sie diese.
|
|
||||||
|
|
||||||
.. code-block:: c
|
|
||||||
|
|
||||||
void model_init(model_t *instance) {
|
|
||||||
assert(instance);
|
|
||||||
// Instructions to the students:
|
|
||||||
// set all fields of the board to model_state_none
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE }
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
3. Führen Sie ``make test`` und korrigieren Sie obige Funktion, bis der Test nicht mehr fehlschlägt.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
3.2 test_model_init
|
|
||||||
===================
|
|
||||||
|
|
||||||
Gehen Sie analog zur ersten Teilaufgabe vor:
|
|
||||||
1. Führen Sie ``make test`` aus.
|
|
||||||
2. Suchen Sie die Funktion **model_get_state()** in **model.h** und **model.c**.
|
|
||||||
3. Implementieren Sie die intern benutzte Funktion **get_state()** gemäss der Anleitung im Code.
|
|
||||||
|
|
||||||
.. code-block:: c
|
|
||||||
|
|
||||||
model_state_t model_get_state(model_t *instance, model_pos_t pos)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
assert_pos(pos);
|
|
||||||
|
|
||||||
// Instructions to the students:
|
|
||||||
// replace the stub implementation my access to the field at the given position.
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
return model_state_none; // stub
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
4. Führen Sie ``make test`` und korrigieren Sie, bis die beiden Tests nicht mehr fehlschlagen.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
3.3 test_model_get_state test_model_get_winner
|
|
||||||
==============================================
|
|
||||||
|
|
||||||
Gehen Sie analog zur ersten Teilaufgabe vor:
|
|
||||||
1. Führen Sie ``make test`` aus.
|
|
||||||
2. Suchen Sie die Funktion **model_get_state()** in **model.h** und **model.c**.
|
|
||||||
3. Implementieren Sie die intern benutzte Funktion **get_state()** gemäss der Anleitung im Code.
|
|
||||||
|
|
||||||
.. code-block:: c
|
|
||||||
|
|
||||||
model_state_t model_get_state(model_t *instance, model_pos_t pos)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
assert_pos(pos);
|
|
||||||
|
|
||||||
// Instructions to the students:
|
|
||||||
// replace the stub implementation my access to the field at the given position.
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
return model_state_none; // stub
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
3.4 test_model_can_move
|
|
||||||
=======================
|
|
||||||
|
|
||||||
Gehen Sie analog den obigen Teilaufgaben vor und implementieren Sie, gemäss Vorgaben im Code, die Funktion **model_can_move()**.
|
|
||||||
|
|
||||||
.. code-block:: c
|
|
||||||
|
|
||||||
int model_can_move(model_t *instance){
|
|
||||||
assert(instance);
|
|
||||||
if (model_get_winner(instance) == model_state_none) {
|
|
||||||
// Instructions to the students:
|
|
||||||
// scan all fields: return 1 with first field which equals model_state_none
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE}
|
|
||||||
return 0;}
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
3.5 test_model_move test_model_get_win_line
|
|
||||||
===========================================
|
|
||||||
|
|
||||||
Schliesslich gehen Sie auch hier analog den obigen Teilaufgaben vor und implementieren Sie, gemäss Vorgaben im Code, die Funktion **set_state()**.
|
|
||||||
|
|
||||||
.. code-block:: c
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Sets the field on the board to the given state.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @param pos [IN] The affected field.
|
|
||||||
* @param state [IN] The new state of the field.
|
|
||||||
*/
|
|
||||||
static void set_state(model_t *instance, model_pos_t pos, model_state_t state)
|
|
||||||
{
|
|
||||||
assert_pos(pos);
|
|
||||||
|
|
||||||
// Instructions to the students:
|
|
||||||
// set the field of the board to the new state
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Wenn die beiden obigen Teilaufgaben erfolgreich umgesetzt sind, laufen die Tests ohne Fehler durch und das Spiel kann gespielt werden.
|
|
||||||
|
|
||||||
|
|
||||||
4. Bewertung
|
|
||||||
******************
|
|
||||||
|
|
||||||
Die gegebenenfalls gestellten Theorieaufgaben und der funktionierende Programmcode müssen der Praktikumsbetreuung gezeigt werden. Die Lösungen müssen mündlich erklärt werden.
|
|
||||||
|
|
||||||
|
|
||||||
.. list-table::
|
|
||||||
:header-rows: 0
|
|
||||||
|
|
||||||
* - Aufgabe
|
|
||||||
- Kriterium
|
|
||||||
- Gewicht
|
|
||||||
* - TicTacToe
|
|
||||||
- Sie können das funktionierende Programm inklusive funktionierende Tests demonstrieren und erklären.
|
|
||||||
-
|
|
||||||
* - TicTacToe
|
|
||||||
- Teilaufgabe test_model_init
|
|
||||||
- 1
|
|
||||||
* - TicTacToe
|
|
||||||
- Teilaufgabe test_model_get_state und test_model_get_winner
|
|
||||||
- 1
|
|
||||||
* - TicTacToe
|
|
||||||
- Teilaufgabe test_model_can_move
|
|
||||||
- 1
|
|
||||||
* - TicTacToe
|
|
||||||
- Teilaufgabe test_model_move und test_model_get_win_line
|
|
||||||
- 1
|
|
||||||
|
|
||||||
|
|
||||||
Version: 15.02.2022
|
|
||||||
|
|
@ -1,205 +0,0 @@
|
||||||
# 05 - Arrays/Strings/TicTacToe
|
|
||||||
___
|
|
||||||
|
|
||||||
## 1. Übersicht
|
|
||||||
In diesem Praktikum werden Sie in der ersten Aufgabe ein Programm zum Einlesen, Sortieren und Ausgeben von Strings von Grund auf entwickeln.
|
|
||||||
|
|
||||||
In der zweiten Aufgabe werden Sie einen Programmrahmen zu einem funktionierenden TicTacToe-Spiel erweitern. Sie implementieren hierbei die fehlenden Funktionen bis alle Tests erfolgreich durchlaufen. Die gewählte Vorgehensweise entspricht somit Test-Driven-Development (TDD). D.h. es existieren zuerst Tests, welche alle fehlschlagen. Schrittweise werden die Funktionen implementiert bis alle Tests erfolgreich durchlaufen. Wenn die Tests erfolgreich durchlaufen, wird auch das Programm funktionieren.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 2. Lernziele
|
|
||||||
In diesem Praktikum schreiben Sie selbst von Grund auf ein C-Programme, das mit Strings operiert. Ferner ergänzen Sie ein bestehendes und lernen dabei den Zugriff auf Arrays.
|
|
||||||
|
|
||||||
* Sie können mit Arrays von Strings umgehen.
|
|
||||||
* Sie können String-Funktionen aus der Standard Library verwenden.
|
|
||||||
* Sie können anhand einer Beschreibung im Code die fehlenden Funktionen die auf Arrays zugreifen implementieren.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 3. Aufgabe 1: Sortieren von Strings
|
|
||||||
Schreiben Sie ein C-Programm, das bis zu 10 Wörter mit einer maximalen Länge von jeweils 20 char von der Tastatur einliest, diese in Grossbuchstaben umwandelt, in einem Array der Reihe nach ablegt und zum Schluss im Array alphabetisch sortiert und ausgibt. Wiederholt eingegebene Wörter sollen dabei ignoriert werden. Das Ende der Eingabe soll durch das Erreichen der zehn unterschiedlichen Wörter oder durch die Eingabe von „ZZZ“ erfolgen. Die Ausgabe der sortierten Wörter soll direkt nach Beendigung der Eingabe erfolgen.
|
|
||||||
|
|
||||||
Hinweise:
|
|
||||||
- Zur Speicherung der Wörter sollten Sie ein zweidimensionales Array verwenden.
|
|
||||||
- Verwenden Sie die String-Funktionen der C Standard Library (include <string.h>), z.B. um Strings alphabetisch zu vergleichen.
|
|
||||||
- Wenn Sie aus anderen Vorlesungen bereits einen effizienten Sortieralgorithmus kennen, können Sie diesen natürlich verwenden. Sonst erfinden Sie einfach einen eigenen.
|
|
||||||
- Strukturieren Sie das Programm durch geeignete Funktionen.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 4. Aufgabe 2: TicTacToe
|
|
||||||
Das zu ergänzende Programm tic-tac-toe hat folgende Funktionalität:
|
|
||||||
1. es stellt ein 3x3 TicTacToe Spielbrett auf dem Terminal dar
|
|
||||||
2. es liest von stdin eine Ziffer 0…9 ein, wobei 0 für Programm-Terminieren, die übrigen Ziffern für die Wahl eines Feldes stehen
|
|
||||||
3. der erste Spielzug wird von Spieler A geführt, danach wechselt das Programm zwischen den Spielern A und B
|
|
||||||
4. bei Gewinn oder bei vollem Brett ist das Spiel vorbei
|
|
||||||
|
|
||||||
Erweitern Sie die vorgegebenen Code Gerüste, welche im git Repository snp-lab-code verfügbar sind.
|
|
||||||
|
|
||||||
Wenn die Aufgabe erfolgreich umgesetzt ist, können Sie das Spiel ausführen:
|
|
||||||
```bash
|
|
||||||
bin/tic-tac-toe
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Als Abnahme müssen die Tests unverändert ohne Fehler ausgeführt werden (`make test`).
|
|
||||||
|
|
||||||
Die Architektur des Programms folgt dem MVC – Model-View-Control Paradigma. Dieses Paradigma besagt, dass die View (Eingabe und Darstellung) über Control (Vermittler) das Modell (die eigentliche Programm-Logik) steuert und darstellt. Dabei sind folgende Abhängigkeiten gegeben:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 4.1 Teilaufgabe test_model_init
|
|
||||||
Das Programm besteht aus folgenden Files:
|
|
||||||
| Datei | ToDo |
|
|
||||||
| :-- | :-- |
|
|
||||||
|Makefile | -> gegeben, d.h. nichts anzupassen |
|
|
||||||
|tests/tests.c| -> gegeben, d.h. nichts anzupassen |
|
|
||||||
|src/main.c| -> gegeben, d.h. nichts anzupassen |
|
|
||||||
|src/view.h| -> gegeben, d.h. nichts anzupassen |
|
|
||||||
|src/view.c| -> gegeben, d.h. nichts anzupassen |
|
|
||||||
|src/control.h| -> gegeben, d.h. nichts anzupassen |
|
|
||||||
|src/control.c| -> gegeben, d.h. nichts anzupassen |
|
|
||||||
|src/model.h| -> gegeben, d.h. nichts anzupassen |
|
|
||||||
|src/model.c| -> **anzupassen:** umsetzen gemäss den Angaben unten |
|
|
||||||
|
|
||||||
1. Führen Sie `make test` aus
|
|
||||||
```bash
|
|
||||||
Suite: lab test
|
|
||||||
Test: test_model_init ...
|
|
||||||
init_model:... 0/0 FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_get_state ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_get_winner ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_can_move ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_move ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
Test: test_model_get_win_line ...FAILED
|
|
||||||
1. tests/tests.c:62 - CU_ASSERT_EQUAL_FATAL(instance->board[row][col],model_state_none)
|
|
||||||
|
|
||||||
Run Summary: Type Total Ran Passed Failed Inactive
|
|
||||||
suites 1 1 n/a 0 0
|
|
||||||
tests 6 6 0 6 0
|
|
||||||
asserts 6 6 0 6 n/a
|
|
||||||
|
|
||||||
```
|
|
||||||
2. Konzentrieren Sie sich auf den ersten Test der fehlschlägt. Dies ist ein Unit Test, welcher die Funktion **model_init()** prüft. Suchen Sie die Funktion in **src/model.h** und **src/model.c**.
|
|
||||||
3. Was ist die geforderte Funktionalität und wie ist sie implementiert?
|
|
||||||
|
|
||||||
Suchen Sie die darin aufgerufene **model_init()** Funktion und implementieren Sie diese.
|
|
||||||
```c
|
|
||||||
void model_init(model_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
|
|
||||||
// Instructions to the students:
|
|
||||||
// set all fields of the board to model_state_none
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
```
|
|
||||||
3. Führen Sie `make test` und korrigieren Sie obige Funktion, bis der Test nicht mehr fehlschlägt.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 4.2 Teilaufgabe test_model_get_state und test_model_get_winner
|
|
||||||
Gehen Sie analog zur ersten Teilaufgabe vor:
|
|
||||||
1. Führen Sie `make test` aus.
|
|
||||||
2. Suchen Sie die Funktion **model_get_state()** in **model.h** und **model.c**.
|
|
||||||
3. Implementieren Sie die intern benutzte Funktion **get_state()** gemäss der Anleitung im Code.
|
|
||||||
|
|
||||||
```c
|
|
||||||
model_state_t model_get_state(model_t *instance, model_pos_t pos)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
assert_pos(pos);
|
|
||||||
|
|
||||||
// Instructions to the students:
|
|
||||||
// replace the stub implementation my access to the field at the given position.
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
return model_state_none; // stub
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
___
|
|
||||||
|
|
||||||
### 4.3 Teilaufgabe test_model_can_move
|
|
||||||
Gehen Sie analog den obigen Teilaufgaben vor und implementieren Sie, gemäss Vorgaben im Code, die Funktion **model_can_move()**.
|
|
||||||
```c
|
|
||||||
int model_can_move(model_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
if (model_get_winner(instance) == model_state_none) {
|
|
||||||
// Instructions to the students:
|
|
||||||
// scan all fields: return 1 with first field which equals model_state_none
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
```
|
|
||||||
___
|
|
||||||
|
|
||||||
### 4.4 Teilaufgabe test_model_move und test_model_get_win_line
|
|
||||||
Schliesslich gehen Sie auch hier analog den obigen Teilaufgaben vor und implementieren Sie, gemäss Vorgaben im Code, die Funktion **set_state()**.
|
|
||||||
```c
|
|
||||||
/**
|
|
||||||
* @brief Sets the field on the board to the given state.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @param pos [IN] The affected field.
|
|
||||||
* @param state [IN] The new state of the field.
|
|
||||||
*/
|
|
||||||
static void set_state(model_t *instance, model_pos_t pos, model_state_t state)
|
|
||||||
{
|
|
||||||
assert_pos(pos);
|
|
||||||
|
|
||||||
// Instructions to the students:
|
|
||||||
// set the field of the board to the new state
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
Wenn die beiden obigen Teilaufgaben erfolgreich umgesetzt sind, laufen die Tests ohne Fehler durch und das Spiel kann gespielt werden.
|
|
||||||
___
|
|
||||||
|
|
||||||
## 5. Bewertung
|
|
||||||
|
|
||||||
Der funktionierende Programmcode muss der Praktikumsbetreuung gezeigt werden. Die Lösungen müssen mündlich erklärt werden.
|
|
||||||
|
|
||||||
| Aufgabe | Kriterium | Punkte |
|
|
||||||
| :-- | :-- | :-- |
|
|
||||||
| Sortieren von Strings | Sie können das funktionierende Programm demonstrieren und erklären. | 2 |
|
|
||||||
| TicTacToe | Sie können das funktionierende Programm inklusive funktionierende Tests demonstrieren und erklären. | |
|
|
||||||
| TicTacToe | Teilaufgabe test_model_init | 0.5 |
|
|
||||||
| TicTacToe | Teilaufgabe test_model_get_state und test_model_get_winner | 0.5 |
|
|
||||||
| TicTacToe | Teilaufgabe test_model_can_move | 0.5 |
|
|
||||||
| TicTacToe | Teilaufgabe test_model_move und test_model_get_win_line | 0.5 |
|
|
||||||
___
|
|
||||||
Version: 14.02.2022
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 53 KiB |
File diff suppressed because one or more lines are too long
|
Before Width: | Height: | Size: 34 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 1.7 KiB |
|
|
@ -1,32 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="160" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="80 120 160 140" height="140" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 50 L120 50 L120 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath3"
|
|
||||||
><path d="M0 0 L0 60 L30 60 L30 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(100,140)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(100,140)"
|
|
||||||
><rect fill="none" x="0.5" width="118.5" height="48.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="27" font-size="30px" y="32.7917" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>View</text
|
|
||||||
></g
|
|
||||||
><g transform="translate(150,180)"
|
|
||||||
><path fill="none" d="M10.5 39.5 L10.5 10.5" clip-path="url(#clipPath3)"
|
|
||||||
/><path fill="none" d="M17 28.7417 L10.5 40 L4 28.7417" clip-path="url(#clipPath3)"
|
|
||||||
/></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 1.9 KiB |
|
|
@ -1,9 +0,0 @@
|
||||||
SNP_SHARED_MAKEFILE := $(if $(SNP_SHARED_MAKEFILE),$(SNP_SHARED_MAKEFILE),"~/snp/shared.mk")
|
|
||||||
|
|
||||||
TARGET := bin/tic-tac-toe
|
|
||||||
MODULES := src/model.c src/view.c src/control.c
|
|
||||||
SOURCES := src/main.c $(MODULES)
|
|
||||||
TSTSOURCES := tests/tests.c $(MODULES)
|
|
||||||
|
|
||||||
include $(SNP_SHARED_MAKEFILE)
|
|
||||||
|
|
||||||
|
|
@ -1,8 +0,0 @@
|
||||||
/**
|
|
||||||
* @mainpage SNP - P05 Tic Tac Toe Game
|
|
||||||
*
|
|
||||||
* @section Purpose
|
|
||||||
*
|
|
||||||
* This is a lab on usage of arrays.
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
|
|
@ -1,154 +0,0 @@
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief Implementation
|
|
||||||
*/
|
|
||||||
#include "control.h"
|
|
||||||
#include "model.h"
|
|
||||||
#include <assert.h>
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Conversion from control field number (1...9) to 0-based model position (row, col).
|
|
||||||
* @param cell [IN] Field number (1...9).
|
|
||||||
* @return Returns the position of the field.
|
|
||||||
* @remark Asserts proper field range.
|
|
||||||
*/
|
|
||||||
static model_pos_t get_pos(size_t cell)
|
|
||||||
{
|
|
||||||
assert(1 <= cell && cell <= 9);
|
|
||||||
model_pos_t pos = { (cell - 1) / 3, (cell - 1) % 3 };
|
|
||||||
return pos;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Conversion from control player to model state.
|
|
||||||
* @param player [IN] Control player value to convert.
|
|
||||||
* @return Returns the matching model state.
|
|
||||||
* @remark No assertion is done - defaults to model_state_none.
|
|
||||||
*/
|
|
||||||
static model_state_t get_state(control_player_t player)
|
|
||||||
{
|
|
||||||
switch(player) {
|
|
||||||
case control_player_a: return model_state_a;
|
|
||||||
case control_player_b: return model_state_b;
|
|
||||||
default: return model_state_none;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Conversion from 0-based model position (row, col) to control field number (1...9).
|
|
||||||
* @param pos [IN] 0-based model position (row,col).
|
|
||||||
* @return The control filed number (1...9)
|
|
||||||
* @remark Asserts proper position range.
|
|
||||||
*/
|
|
||||||
static size_t get_cell(model_pos_t pos)
|
|
||||||
{
|
|
||||||
assert(pos.row < 3);
|
|
||||||
assert(pos.col < 3);
|
|
||||||
return 1 + pos.row * 3 + pos.col;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Conversion from model state to control player.
|
|
||||||
* @param state [IN] Model state to convert
|
|
||||||
* @return Returns the matching control player value.
|
|
||||||
* @remark No assertion is done - defaults to control_no_player.
|
|
||||||
*/
|
|
||||||
static control_player_t get_player(model_state_t state)
|
|
||||||
{
|
|
||||||
switch(state) {
|
|
||||||
case model_state_a: return control_player_a;
|
|
||||||
case model_state_b: return control_player_b;
|
|
||||||
default: return control_no_player;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Queries if a move is possible.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @return Returns 0 if no move is possible any more, otherwise 1.
|
|
||||||
*/
|
|
||||||
static int control_can_move(control_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
return model_can_move(instance->model);
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
void control_init(control_t *instance, model_t *model)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
assert(model);
|
|
||||||
instance->player = control_player_a;
|
|
||||||
instance->model = model;
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
void control_move(control_t *instance, size_t cell)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
if (model_move(instance->model, get_pos(cell), get_state(instance->player))) {
|
|
||||||
if (control_can_move(instance)) {
|
|
||||||
switch(instance->player) {
|
|
||||||
case control_player_a:
|
|
||||||
instance->player = control_player_b;
|
|
||||||
break;
|
|
||||||
case control_player_b:
|
|
||||||
instance->player = control_player_a;
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
instance->player = control_no_player;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
control_player_t control_get_winner(control_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
return get_player(model_get_winner(instance->model));
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
control_player_t control_get_player(control_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
return instance->player;
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
control_player_t control_get_state(control_t *instance, size_t cell)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
return get_player(model_get_state(instance->model, get_pos(cell)));
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
control_line_t control_get_win(control_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
if (control_get_winner(instance) == control_no_player) {
|
|
||||||
control_line_t no_win = { 0 };
|
|
||||||
return no_win;
|
|
||||||
}
|
|
||||||
|
|
||||||
model_line_t line = model_get_win_line(instance->model);
|
|
||||||
assert(line.dir != model_dir_none);
|
|
||||||
size_t start_cell = get_cell(line.start);
|
|
||||||
switch(line.dir) {
|
|
||||||
case model_dir_h:
|
|
||||||
return (control_line_t) { { start_cell, start_cell + 1, start_cell + 2 } };
|
|
||||||
case model_dir_v:
|
|
||||||
return (control_line_t) { { start_cell, start_cell + 3, start_cell + 6 } };
|
|
||||||
case model_dir_d:
|
|
||||||
if (start_cell == 1) {
|
|
||||||
return (control_line_t) { { start_cell, start_cell + 4, start_cell + 8 } };
|
|
||||||
} else {
|
|
||||||
return (control_line_t) { { start_cell, start_cell + 2, start_cell + 6 } };
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
return (control_line_t) { { 1, 1, 1 } };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
@ -1,80 +0,0 @@
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief MVC - agent between model and view
|
|
||||||
*/
|
|
||||||
#ifndef _CONTROL_H_
|
|
||||||
#define _CONTROL_H_
|
|
||||||
|
|
||||||
#include "model.h"
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief The selection of possible players.
|
|
||||||
*/
|
|
||||||
typedef enum {
|
|
||||||
control_no_player, ///< none of the players
|
|
||||||
control_player_a, ///< first player
|
|
||||||
control_player_b, ///< second player
|
|
||||||
} control_player_t;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Sequence of winning cell numbers in increasing cell numbers.
|
|
||||||
*/
|
|
||||||
typedef struct {
|
|
||||||
size_t line[3]; ///< the sequence of cells (1...9) or 0 in the first element if no win
|
|
||||||
} control_line_t;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief The instance type.
|
|
||||||
*/
|
|
||||||
typedef struct {
|
|
||||||
control_player_t player; ///< the current player
|
|
||||||
model_t *model; ///< the reference to the model
|
|
||||||
} control_t;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Constructor: initialize the instance memory.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @param model [IN] Dependency Injection of the model instance.
|
|
||||||
*/
|
|
||||||
void control_init(control_t *instance, model_t *model);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Performs a move on the board.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @param cell [IN] The affected field (1...9)
|
|
||||||
* @remark Silently ignores a move if it is not allowed (e.g. if already completed or the field is already played, etc.).
|
|
||||||
*/
|
|
||||||
void control_move(control_t *instance, size_t cell);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Queries the winning player.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @returns Returns the winning player (if any).
|
|
||||||
*/
|
|
||||||
control_player_t control_get_winner(control_t *instance);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Queries the next player.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @returns Returns the next player (if any).
|
|
||||||
* @remark This is updated by the control_move() function.
|
|
||||||
*/
|
|
||||||
control_player_t control_get_player(control_t *instance);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Queries the state of a field.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @param cell [IN] The affected field of the board (1...9).
|
|
||||||
* @returns Returns the player which played this field (if any).
|
|
||||||
*/
|
|
||||||
control_player_t control_get_state(control_t *instance, size_t cell);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Gets the winning fields (if any).
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @returns Returns the field numbers in increasing order (1...9) which win the game (if any).
|
|
||||||
* @remark If there is no winner (yet), the first entry in the result is 0.
|
|
||||||
*/
|
|
||||||
control_line_t control_get_win(control_t *instance);
|
|
||||||
|
|
||||||
#endif // _CONTROL_H_
|
|
||||||
|
|
@ -1,39 +0,0 @@
|
||||||
/* ----------------------------------------------------------------------------
|
|
||||||
* -- _____ ______ _____ -
|
|
||||||
* -- |_ _| | ____|/ ____| -
|
|
||||||
* -- | | _ __ | |__ | (___ Institute of Embedded Systems -
|
|
||||||
* -- | | | '_ \| __| \___ \ Zuercher Hochschule Winterthur -
|
|
||||||
* -- _| |_| | | | |____ ____) | (University of Applied Sciences) -
|
|
||||||
* -- |_____|_| |_|______|_____/ 8401 Winterthur, Switzerland -
|
|
||||||
* ----------------------------------------------------------------------------
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief Lab P04 dep2dot
|
|
||||||
*/
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
|
|
||||||
#include "view.h"
|
|
||||||
#include "model.h"
|
|
||||||
#include "control.h"
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief main function
|
|
||||||
* @param argc [in] number of entries in argv
|
|
||||||
* @param argv [in] program name plus command line arguments
|
|
||||||
* @returns returns success if valid date is given, failure otherwise
|
|
||||||
*/
|
|
||||||
int main(int argc, const char *argv[])
|
|
||||||
{
|
|
||||||
view_t view;
|
|
||||||
control_t control;
|
|
||||||
model_t model;
|
|
||||||
|
|
||||||
model_init(&model);
|
|
||||||
control_init(&control, &model);
|
|
||||||
view_init(&view, &control);
|
|
||||||
view_run(&view);
|
|
||||||
|
|
||||||
return EXIT_SUCCESS;
|
|
||||||
}
|
|
||||||
|
|
@ -1,165 +0,0 @@
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief Implementation
|
|
||||||
*/
|
|
||||||
#include "model.h"
|
|
||||||
#include <assert.h>
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Asserts that the position is in range.
|
|
||||||
* @param [IN] The position to check.
|
|
||||||
*/
|
|
||||||
static void assert_pos(model_pos_t pos)
|
|
||||||
{
|
|
||||||
assert(pos.row < MODEL_SIZE);
|
|
||||||
assert(pos.col < MODEL_SIZE);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Sets the field on the board to the given state.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @param pos [IN] The affected field.
|
|
||||||
* @param state [IN] The new state of the field.
|
|
||||||
*/
|
|
||||||
static void set_state(model_t *instance, model_pos_t pos, model_state_t state)
|
|
||||||
{
|
|
||||||
assert_pos(pos);
|
|
||||||
|
|
||||||
// Instructions to the students:
|
|
||||||
// set the field of the board to the new state
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
model_pos_t model_pos(size_t row, size_t col)
|
|
||||||
{
|
|
||||||
return (model_pos_t){row, col};
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
void model_init(model_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
|
|
||||||
// Instructions to the students:
|
|
||||||
// set all fields of the board to model_state_none
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
model_state_t model_get_state(model_t *instance, model_pos_t pos)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
assert_pos(pos);
|
|
||||||
|
|
||||||
// Instructions to the students:
|
|
||||||
// replace the stub implementation my access to the field at the given position.
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
return model_state_none; // stub
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
model_line_t model_get_win_line(model_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
model_state_t anchor;
|
|
||||||
|
|
||||||
// horizontal
|
|
||||||
for(size_t row = 0; row < MODEL_SIZE; row++) {
|
|
||||||
anchor = model_get_state(instance, model_pos(row, 0));
|
|
||||||
if (anchor != model_state_none
|
|
||||||
&& anchor == model_get_state(instance, model_pos(row, 1))
|
|
||||||
&& anchor == model_get_state(instance, model_pos(row, 2))) {
|
|
||||||
return (model_line_t) { model_dir_h, { row, 0 } };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// vertical
|
|
||||||
for(size_t col = 0; col < MODEL_SIZE; col++) {
|
|
||||||
anchor = model_get_state(instance, model_pos(0, col));
|
|
||||||
if (anchor != model_state_none
|
|
||||||
&& anchor == model_get_state(instance, model_pos(1, col))
|
|
||||||
&& anchor == model_get_state(instance, model_pos(2, col))) {
|
|
||||||
return (model_line_t) { model_dir_v, { 0, col } };
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
// diagonal
|
|
||||||
anchor = model_get_state(instance, model_pos(1, 1));
|
|
||||||
if (anchor != model_state_none) {
|
|
||||||
if (anchor == model_get_state(instance, model_pos(0, 0)) && anchor == model_get_state(instance, model_pos(2, 2))) {
|
|
||||||
return (model_line_t) { model_dir_d, { 0, 0 } };
|
|
||||||
}
|
|
||||||
if (anchor == model_get_state(instance, model_pos(2, 0)) && anchor == model_get_state(instance, model_pos(0, 2))) {
|
|
||||||
return (model_line_t) { model_dir_d, { 0, 2 } };
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// fallback
|
|
||||||
return (model_line_t) { model_dir_none, { 0, 0 } };
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
model_state_t model_get_winner(model_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
model_line_t line = model_get_win_line(instance);
|
|
||||||
return line.dir == model_dir_none
|
|
||||||
? model_state_none
|
|
||||||
: model_get_state(instance, model_pos(line.start.row, line.start.col))
|
|
||||||
;
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
int model_can_move(model_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
if (model_get_winner(instance) == model_state_none) {
|
|
||||||
// Instructions to the students:
|
|
||||||
// scan all fields: return 1 with first field which equals model_state_none
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
int model_move(model_t *instance, model_pos_t pos, model_state_t state)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
assert_pos(pos);
|
|
||||||
if (model_get_state(instance, pos) == model_state_none && model_can_move(instance)) {
|
|
||||||
set_state(instance, pos, state);
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
@ -1,108 +0,0 @@
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief MVC - Model instance
|
|
||||||
*/
|
|
||||||
#ifndef _MODEL_H_
|
|
||||||
#define _MODEL_H_
|
|
||||||
|
|
||||||
#include <stdlib.h>
|
|
||||||
|
|
||||||
#define MODEL_SIZE 3 ///< size of the game to avoid magic numbers in the code (not meant to modify)
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief The position on the board.
|
|
||||||
*/
|
|
||||||
typedef struct {
|
|
||||||
size_t row; ///< The row (0-based).
|
|
||||||
size_t col; ///< The column (0-based).
|
|
||||||
} model_pos_t;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Winner line direction - the winner line is given together with the start position.
|
|
||||||
*/
|
|
||||||
typedef enum {
|
|
||||||
model_dir_none, ///< no winner line
|
|
||||||
model_dir_h, ///< horizontal
|
|
||||||
model_dir_v, ///< vertical
|
|
||||||
model_dir_d, ///< diagonal
|
|
||||||
} model_dir_t;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief The Winner line (if any).
|
|
||||||
*/
|
|
||||||
typedef struct {
|
|
||||||
model_dir_t dir; ///< the winner line direction (if any)
|
|
||||||
model_pos_t start; ///< the start position of the winner line
|
|
||||||
} model_line_t;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief The state of a field.
|
|
||||||
*/
|
|
||||||
typedef enum {
|
|
||||||
model_state_none, ///< field available to play
|
|
||||||
model_state_a, ///< field already played
|
|
||||||
model_state_b, ///< field already played
|
|
||||||
} model_state_t;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief The instance type.
|
|
||||||
*/
|
|
||||||
typedef struct {
|
|
||||||
model_state_t board[MODEL_SIZE][MODEL_SIZE]; ///< the play board
|
|
||||||
} model_t;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Convert to row and col to position.
|
|
||||||
* @param row [IN] position parameter
|
|
||||||
* @param col [IN] position parameter
|
|
||||||
* @return Returns the position given be row and col parameters.
|
|
||||||
*/
|
|
||||||
model_pos_t model_pos(size_t row, size_t col);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Constructor: initialize the instance memory.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
*/
|
|
||||||
void model_init(model_t *instance);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Queries the state of the given field.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @param pos [IN] The affected field.
|
|
||||||
* @return Returns the state of the field.
|
|
||||||
*/
|
|
||||||
model_state_t model_get_state(model_t *instance, model_pos_t pos);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Queries the winner (if any).
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @return Returns the wining player or model_state_none if no winner (yet).
|
|
||||||
*/
|
|
||||||
model_state_t model_get_winner(model_t *instance);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Queries if a move is possible (i.e. not won yet and any field available?).
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @return Returns 0 if no move possible, 1 otherwise.
|
|
||||||
*/
|
|
||||||
int model_can_move(model_t *instance);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Do a move if possible.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @param pos [IN] The field to play.
|
|
||||||
* @param state [IN] The new state (only model_state_a and model_state_b allowed).
|
|
||||||
* @return Returns if the attempt to move was successful.
|
|
||||||
* @remark Does only succeed if not yet won and if the field is available.
|
|
||||||
*/
|
|
||||||
int model_move(model_t *instance, model_pos_t pos, model_state_t state);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Gets the winner line (if any).
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @returns The line which wins (if any).
|
|
||||||
* @remark The start position is 0/0, 1/0, 2/0 for horizontal, 0/0, 0/1, 0/2 for vertical, 0/0, 0/2 for diagonal.
|
|
||||||
*/
|
|
||||||
model_line_t model_get_win_line(model_t *instance);
|
|
||||||
|
|
||||||
#endif // _MODEL_H_
|
|
||||||
|
|
@ -1,255 +0,0 @@
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief Implementation
|
|
||||||
*/
|
|
||||||
#include "view.h"
|
|
||||||
#include "control.h"
|
|
||||||
|
|
||||||
#include <assert.h> // assert()
|
|
||||||
#include <stdio.h> // various i/o
|
|
||||||
#include <ctype.h> // isdigit()
|
|
||||||
#include <unistd.h> // STDIN_FILENO, isatty()
|
|
||||||
#include <termios.h> // tcgetattr(), tcsetattr()
|
|
||||||
|
|
||||||
#define EXIT '0' ///< the UI exit request
|
|
||||||
|
|
||||||
#define CLS "\033[2J" ///< ANSI termial CSI sequence for clear screen
|
|
||||||
#define AVAILABLE "\033[40m" ///< ANSI termial CSI sequence for available fields (black)
|
|
||||||
#define PLAYER_A "\033[42m" ///< ANSI termial CSI sequence for one player (green)
|
|
||||||
#define PLAYER_B "\033[41m" ///< ANSI termial CSI sequence for the other player (red)
|
|
||||||
#define GAP "\033[47m" ///< ANSI termial CSI sequence for boarder (white)
|
|
||||||
#define RESET "\033[0m" ///< ANSI termial CSI sequence to reset all settings
|
|
||||||
|
|
||||||
#define CELL_WIDTH 10 ///< rendering parameter: columns per cell
|
|
||||||
#define CELL_HEIGHT 5 ///< rendering parameter: rows per cell
|
|
||||||
#define GAP_WIDTH 4 ///< rendering parameter: columns per border
|
|
||||||
#define GAP_HEIGHT 2 ///< rendering parameter: rows per boarder
|
|
||||||
|
|
||||||
#define SIZE 3 ///< size of the game to avoid magic numbers in the code (not meant to modify)
|
|
||||||
#define CELLS (SIZE * SIZE) ///< size of the game to avoid magic numbers in the code (not meant to modify)
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Position the cursor for further output.
|
|
||||||
* @param row [IN] position parameter
|
|
||||||
* @param col [IN] position parameter
|
|
||||||
*/
|
|
||||||
static void goto_pos(size_t row, size_t col)
|
|
||||||
{
|
|
||||||
printf("\033[%zd;%zdH", row, col);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Displays a sequence of spaces at the given position in the given background color.
|
|
||||||
* @param row [IN] position parameter
|
|
||||||
* @param col [IN] position parameter
|
|
||||||
* @param width [IN] how many spaces to write
|
|
||||||
* @param color [IN] the format string before writing the spaces (intent: background color)
|
|
||||||
* @remark After writing the spaces, the format is reset.
|
|
||||||
*/
|
|
||||||
static size_t show_bar(size_t row, size_t col, size_t width, const char* color)
|
|
||||||
{
|
|
||||||
goto_pos(row, col);
|
|
||||||
printf("%s", color);
|
|
||||||
for(size_t col = 0; col < width; col++) {
|
|
||||||
putchar(' ');
|
|
||||||
}
|
|
||||||
printf(RESET);
|
|
||||||
return col + width;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Displays a horizontal border over the whole board width.
|
|
||||||
* @param row [IN] position parameter
|
|
||||||
* @param col [IN] position parameter
|
|
||||||
*/
|
|
||||||
static size_t show_h_gap(size_t row, size_t col) {
|
|
||||||
for(size_t i = 0; i < GAP_HEIGHT; i++) {
|
|
||||||
show_bar(row+i, col, GAP_WIDTH + CELL_WIDTH + GAP_WIDTH, GAP);
|
|
||||||
}
|
|
||||||
return row + GAP_HEIGHT;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Writes for the call at position y/x the given number with the given background color.
|
|
||||||
* @param y [IN] position parameter: the upper left row of the cell
|
|
||||||
* @param x [IN] position parameter: the upper left column of the cell
|
|
||||||
* @param n [IN] the number to write as text
|
|
||||||
* @param color [IN] the format string before writing the text (intent: background color)
|
|
||||||
* @remark After writing the number, the format is reset.
|
|
||||||
*/
|
|
||||||
static void show_cell_nr(size_t y, size_t x, size_t n, const char *color)
|
|
||||||
{
|
|
||||||
size_t cy = (y + y + CELL_HEIGHT)/2;
|
|
||||||
size_t cx = (x + x + CELL_WIDTH - 2)/2;
|
|
||||||
|
|
||||||
goto_pos(cy, cx);
|
|
||||||
printf("%s", color);
|
|
||||||
printf("%2zd", n);
|
|
||||||
printf(RESET);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Renders the given cell with the given background color, including the surrounding border.
|
|
||||||
* @param n [IN] the cell number (0...CELLS-1)
|
|
||||||
* @param color [IN] the format string for the cell content (intent: background color)
|
|
||||||
* @remark After writing the number, the format is reset.
|
|
||||||
*/
|
|
||||||
static void show_cell(size_t n, const char *color)
|
|
||||||
{
|
|
||||||
// goto upper-left corner of a cell (the cell starts with an upper and left gap)
|
|
||||||
size_t y = 1 + n / SIZE * (GAP_HEIGHT + CELL_HEIGHT);
|
|
||||||
size_t x = 1 + n % SIZE * (GAP_WIDTH + CELL_WIDTH);
|
|
||||||
|
|
||||||
size_t row = show_h_gap(y, x);
|
|
||||||
for(size_t i = 0; i < CELL_HEIGHT; i++) {
|
|
||||||
size_t col = x;
|
|
||||||
col = show_bar(row, col, GAP_WIDTH, GAP);
|
|
||||||
col = show_bar(row, col, CELL_WIDTH, color);
|
|
||||||
col = show_bar(row, col, GAP_WIDTH, GAP);
|
|
||||||
row++;
|
|
||||||
}
|
|
||||||
row = show_h_gap(row, x);
|
|
||||||
show_cell_nr(y + GAP_HEIGHT, x + GAP_WIDTH, n + 1, color);
|
|
||||||
goto_pos(row, 0);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Renders the given player's name in the given background color.
|
|
||||||
* @param player [IN] the player to render (select the background color and the name of the player
|
|
||||||
* @remark After writing the content, the format is reset.
|
|
||||||
*/
|
|
||||||
static void print_player(control_player_t player)
|
|
||||||
{
|
|
||||||
switch(player) {
|
|
||||||
case control_player_a:
|
|
||||||
printf(PLAYER_A);
|
|
||||||
printf("Player A");
|
|
||||||
printf(RESET);
|
|
||||||
break;
|
|
||||||
case control_player_b:
|
|
||||||
printf(PLAYER_B);
|
|
||||||
printf("Player B");
|
|
||||||
printf(RESET);
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
printf(RESET);
|
|
||||||
printf("none");
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Displays a label followed by the given player.
|
|
||||||
* @param row [IN] position parameter
|
|
||||||
* @param col [IN] position parameter
|
|
||||||
* @param label [IN] the profixing label
|
|
||||||
* @param player [IN] the player to display
|
|
||||||
*/
|
|
||||||
static void show_player(size_t row, size_t col, const char *label, control_player_t player)
|
|
||||||
{
|
|
||||||
goto_pos(row, col);
|
|
||||||
printf(RESET);
|
|
||||||
col += printf("%s", label);
|
|
||||||
goto_pos(row, col);
|
|
||||||
print_player(player);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Renders the winner and the next player.
|
|
||||||
* @param winner [IN] the winning player (if any)
|
|
||||||
* @param next [IN] the next player (if any)
|
|
||||||
*/
|
|
||||||
static void show_status(control_player_t winner, control_player_t next)
|
|
||||||
{
|
|
||||||
size_t y = GAP_HEIGHT;
|
|
||||||
size_t x = SIZE * (GAP_WIDTH + CELL_WIDTH) + GAP_WIDTH + GAP_WIDTH;
|
|
||||||
size_t row = y;
|
|
||||||
size_t col = x;
|
|
||||||
|
|
||||||
show_player(row, col, "Winner is: ", winner);
|
|
||||||
row += 2;
|
|
||||||
show_player(row, col, "Next player is: ", next);
|
|
||||||
row += 2;
|
|
||||||
row += 2;
|
|
||||||
goto_pos(row, col);
|
|
||||||
printf("0: exit");
|
|
||||||
row += 2;
|
|
||||||
goto_pos(row, col);
|
|
||||||
printf("1..9: play field");
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Renders the board from the status given by the control instance.
|
|
||||||
* @param instance [IN] the instance which holds the control instance
|
|
||||||
*/
|
|
||||||
static void show(view_t *instance)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
assert(instance->control);
|
|
||||||
puts(CLS);
|
|
||||||
show_status(control_get_winner(instance->control), control_get_player(instance->control));
|
|
||||||
|
|
||||||
for(size_t i = 0; i < CELLS; i++) {
|
|
||||||
const char *color = AVAILABLE;
|
|
||||||
switch(control_get_state(instance->control, i+1)) {
|
|
||||||
case control_player_a:
|
|
||||||
color = PLAYER_A;
|
|
||||||
break;
|
|
||||||
case control_player_b:
|
|
||||||
color = PLAYER_B;
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
show_cell(i, color);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Processes the input and dsiplays the result.
|
|
||||||
* @param the instance which holds the control instance
|
|
||||||
*/
|
|
||||||
static void notifier_loop(view_t *instance)
|
|
||||||
{
|
|
||||||
show(instance);
|
|
||||||
int c = getchar();
|
|
||||||
while(c != EOF && c != EXIT) {
|
|
||||||
if (isdigit(c)) {
|
|
||||||
control_move(instance->control, c-'0');
|
|
||||||
}
|
|
||||||
show(instance);
|
|
||||||
c = getchar();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
void view_init(view_t *instance, control_t *control)
|
|
||||||
{
|
|
||||||
assert(instance);
|
|
||||||
assert(control);
|
|
||||||
instance->control = control;
|
|
||||||
}
|
|
||||||
|
|
||||||
// public API function which is documented in the header file.
|
|
||||||
void view_run(view_t *instance)
|
|
||||||
{
|
|
||||||
if (isatty(STDIN_FILENO)) { // in case of an interactive terminal, the exhoing and buffering is disabled
|
|
||||||
// declare non POSIX function, which is available in glibc, but not in strinct C99 mode
|
|
||||||
void cfmakeraw(struct termios *termios_p);
|
|
||||||
|
|
||||||
// replace original tty IO state...
|
|
||||||
struct termios orig;
|
|
||||||
struct termios raw;
|
|
||||||
cfmakeraw(&raw);
|
|
||||||
tcgetattr(STDIN_FILENO, &orig);
|
|
||||||
tcsetattr(STDIN_FILENO, TCSANOW, &raw);
|
|
||||||
// ...do the work...
|
|
||||||
notifier_loop(instance);
|
|
||||||
// ...and finalle restore original tty IO state
|
|
||||||
tcsetattr(STDIN_FILENO, TCSANOW, &orig);
|
|
||||||
} else { // if not an interactive terminal, no tweaking with IO is done
|
|
||||||
notifier_loop(instance);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
@ -1,31 +0,0 @@
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief MVC - View instance
|
|
||||||
*/
|
|
||||||
#ifndef _VIEW_H_
|
|
||||||
#define _VIEW_H_
|
|
||||||
|
|
||||||
#include "control.h"
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief The instance type.
|
|
||||||
*/
|
|
||||||
typedef struct {
|
|
||||||
control_t *control; ///< the instance knows of the control instance
|
|
||||||
} view_t;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Constructor: initialize the instance memory.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @param control [IN] Dependency Injection of the control instance.
|
|
||||||
*/
|
|
||||||
void view_init(view_t *instance, control_t *control);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Starts the notifyer loop: accepts input and displays the results.
|
|
||||||
* @param instance [INOUT] The instance which holds the state.
|
|
||||||
* @remark Does only return when termination is requested through the UI.
|
|
||||||
*/
|
|
||||||
void view_run(view_t *instance);
|
|
||||||
|
|
||||||
#endif // _VIEW_H_
|
|
||||||
|
|
@ -1,445 +0,0 @@
|
||||||
/* ----------------------------------------------------------------------------
|
|
||||||
* -- _____ ______ _____ -
|
|
||||||
* -- |_ _| | ____|/ ____| -
|
|
||||||
* -- | | _ __ | |__ | (___ Institute of Embedded Systems -
|
|
||||||
* -- | | | '_ \| __| \___ \ Zuercher Hochschule Winterthur -
|
|
||||||
* -- _| |_| | | | |____ ____) | (University of Applied Sciences) -
|
|
||||||
* -- |_____|_| |_|______|_____/ 8401 Winterthur, Switzerland -
|
|
||||||
* ----------------------------------------------------------------------------
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief Test suite for the given package.
|
|
||||||
*/
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <sys/wait.h>
|
|
||||||
#include <time.h>
|
|
||||||
#include <assert.h>
|
|
||||||
#include <CUnit/Basic.h>
|
|
||||||
#include "test_utils.h"
|
|
||||||
#include "model.h"
|
|
||||||
|
|
||||||
#ifndef TARGET // must be given by the make file --> see test target
|
|
||||||
#error missing TARGET define
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/// @brief alias for EXIT_SUCCESS
|
|
||||||
#define OK EXIT_SUCCESS
|
|
||||||
/// @brief alias for EXIT_FAILURE
|
|
||||||
#define FAIL EXIT_FAILURE
|
|
||||||
|
|
||||||
/// @brief The name of the STDOUT text file.
|
|
||||||
#define OUTFILE "stdout.txt"
|
|
||||||
/// @brief The name of the STDERR text file.
|
|
||||||
#define ERRFILE "stderr.txt"
|
|
||||||
|
|
||||||
#define TRACE_INDENT "\n " ///< allow for better stdout formatting in case of error
|
|
||||||
|
|
||||||
// setup & cleanup
|
|
||||||
static int setup(void)
|
|
||||||
{
|
|
||||||
remove_file_if_exists(OUTFILE);
|
|
||||||
remove_file_if_exists(ERRFILE);
|
|
||||||
return 0; // success
|
|
||||||
}
|
|
||||||
|
|
||||||
static int teardown(void)
|
|
||||||
{
|
|
||||||
// Do nothing.
|
|
||||||
// Especially: do not remove result files - they are removed in int setup(void) *before* running a test.
|
|
||||||
return 0; // success
|
|
||||||
}
|
|
||||||
|
|
||||||
// test utils
|
|
||||||
static void init_model(model_t *instance, int act)
|
|
||||||
{
|
|
||||||
if (act) printf(TRACE_INDENT "init_model:... ");
|
|
||||||
model_init(instance);
|
|
||||||
for(size_t row = 0; row < MODEL_SIZE; row++) {
|
|
||||||
for(size_t col = 0; col < MODEL_SIZE; col++) {
|
|
||||||
if (act) printf("%zd/%zd ", row, col);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(instance->board[row][col], model_state_none);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if (act) printf(TRACE_INDENT);
|
|
||||||
}
|
|
||||||
|
|
||||||
static void print_board(model_state_t board[MODEL_SIZE][MODEL_SIZE])
|
|
||||||
{
|
|
||||||
for(size_t row = 0; row < MODEL_SIZE; row++) {
|
|
||||||
printf("{ ");
|
|
||||||
for(size_t col = 0; col < MODEL_SIZE; col++) {
|
|
||||||
printf("%d ", board[row][col]);
|
|
||||||
}
|
|
||||||
printf("} ");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
// tests
|
|
||||||
static void test_model_init(void)
|
|
||||||
{
|
|
||||||
// check void model_init(model_t *instance);
|
|
||||||
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
// act & assert
|
|
||||||
init_model(&model, 1);
|
|
||||||
}
|
|
||||||
|
|
||||||
static void test_model_get_state(void)
|
|
||||||
{
|
|
||||||
// check: model_state_t model_get_state(model_t *instance, model_pos_t pos);
|
|
||||||
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "initial state:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
for(size_t row = 0; row < MODEL_SIZE; row++) {
|
|
||||||
for(size_t col = 0; col < MODEL_SIZE; col++) {
|
|
||||||
printf("%zd/%zd ", row, col);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_get_state(&model, model_pos(row, col)), model_state_none);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_none, model_state_a, model_state_b },
|
|
||||||
{ model_state_a, model_state_b, model_state_none },
|
|
||||||
{ model_state_b, model_state_none, model_state_a },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "modified state:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
for(size_t row = 0; row < MODEL_SIZE; row++) {
|
|
||||||
for(size_t col = 0; col < MODEL_SIZE; col++) {
|
|
||||||
printf("%zd/%zd ", row, col);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_get_state(&model, model_pos(row, col)), board[row][col]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
printf(TRACE_INDENT);
|
|
||||||
}
|
|
||||||
|
|
||||||
static void test_model_get_winner(void)
|
|
||||||
{
|
|
||||||
// check: model_state_t model_get_winner(model_t *instance);
|
|
||||||
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "initial no winner:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_get_winner(&model), model_state_none);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_none, model_state_a, model_state_b },
|
|
||||||
{ model_state_a, model_state_b, model_state_none },
|
|
||||||
{ model_state_b, model_state_none, model_state_a },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "winner:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_get_winner(&model), model_state_b);
|
|
||||||
}
|
|
||||||
printf(TRACE_INDENT);
|
|
||||||
}
|
|
||||||
|
|
||||||
static void test_model_can_move(void)
|
|
||||||
{
|
|
||||||
// check: int model_can_move(model_t *instance);
|
|
||||||
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "initial can move:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_can_move(&model), 1);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_none, model_state_a, model_state_a },
|
|
||||||
{ model_state_a, model_state_b, model_state_none },
|
|
||||||
{ model_state_b, model_state_none, model_state_b },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "can move while not yet done nor win:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_can_move(&model), 1);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_none, model_state_a, model_state_b },
|
|
||||||
{ model_state_a, model_state_b, model_state_none },
|
|
||||||
{ model_state_b, model_state_none, model_state_a },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "cannot move after win:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_can_move(&model), 0);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_b, model_state_a, model_state_a },
|
|
||||||
{ model_state_a, model_state_b, model_state_b },
|
|
||||||
{ model_state_b, model_state_a, model_state_a },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "cannot move when all done:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_can_move(&model), 0);
|
|
||||||
}
|
|
||||||
printf(TRACE_INDENT);
|
|
||||||
}
|
|
||||||
|
|
||||||
static void test_model_move(void)
|
|
||||||
{
|
|
||||||
// check: int model_move(model_t *instance, model_pos_t pos, model_state_t state);
|
|
||||||
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "initial move:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
model_pos_t pos_a = model_pos(0, 0);
|
|
||||||
printf("%zd/%zd ", pos_a.row, pos_a.col);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos_a, model_state_a), 1);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos_a, model_state_a), 0);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos_a, model_state_b), 0);
|
|
||||||
model_pos_t pos_b = model_pos(2, 2);
|
|
||||||
printf("%zd/%zd ", pos_b.row, pos_b.col);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos_b, model_state_b), 1);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos_b, model_state_b), 0);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos_b, model_state_a), 0);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_none, model_state_a, model_state_a },
|
|
||||||
{ model_state_a, model_state_b, model_state_none },
|
|
||||||
{ model_state_b, model_state_none, model_state_b },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "can move while not yet done nor win:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
model_pos_t pos = model_pos(2, 1);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos, model_state_a), 1);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos, model_state_a), 0);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos, model_state_b), 0);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_none, model_state_a, model_state_b },
|
|
||||||
{ model_state_a, model_state_b, model_state_none },
|
|
||||||
{ model_state_b, model_state_none, model_state_a },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "cannot move after win:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
model_pos_t pos = model_pos(2, 1);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos, model_state_a), 0);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos, model_state_b), 0);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_b, model_state_a, model_state_a },
|
|
||||||
{ model_state_a, model_state_b, model_state_b },
|
|
||||||
{ model_state_b, model_state_a, model_state_a },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "cannot move when all done:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
for(size_t row = 0; row < MODEL_SIZE; row++) {
|
|
||||||
for(size_t col = 0; col < MODEL_SIZE; col++) {
|
|
||||||
model_pos_t pos = model_pos(row, col);
|
|
||||||
printf("%zd/%zd ", row, col);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos, model_state_a), 0);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, pos, model_state_b), 0);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_can_move(&model), 0);
|
|
||||||
}
|
|
||||||
printf(TRACE_INDENT);
|
|
||||||
}
|
|
||||||
|
|
||||||
static void test_model_get_win_line(void)
|
|
||||||
{
|
|
||||||
// check: model_line_t model_get_win_line(model_t *instance);
|
|
||||||
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "initial no winner:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
model_line_t no_win = model_get_win_line(&model);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(no_win.dir, model_dir_none);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_none, model_state_a, model_state_a },
|
|
||||||
{ model_state_a, model_state_b, model_state_none },
|
|
||||||
{ model_state_b, model_state_none, model_state_b },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "no winner while not yet done nor win:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
model_line_t no_win = model_get_win_line(&model);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(no_win.dir, model_dir_none);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
// arrange
|
|
||||||
static const model_state_t board[MODEL_SIZE][MODEL_SIZE] = {
|
|
||||||
{ model_state_b, model_state_a, model_state_a },
|
|
||||||
{ model_state_a, model_state_b, model_state_b },
|
|
||||||
{ model_state_b, model_state_a, model_state_a },
|
|
||||||
};
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
memcpy(model.board, board, sizeof(board));
|
|
||||||
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "no winner when all done:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
model_line_t no_win = model_get_win_line(&model);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(no_win.dir, model_dir_none);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
for(size_t row = 0; row < MODEL_SIZE; row++) {
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
for(size_t col = 0; col < MODEL_SIZE; col++) {
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, model_pos(row, col), model_state_a), 1);
|
|
||||||
}
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "row winner:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
model_line_t win = model_get_win_line(&model);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.dir, model_dir_h);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.start.row, row);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.start.col, 0);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
{
|
|
||||||
for(size_t col = 0; col < MODEL_SIZE; col++) {
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
for(size_t row = 0; row < MODEL_SIZE; row++) {
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, model_pos(row, col), model_state_a), 1);
|
|
||||||
}
|
|
||||||
// act & assert
|
|
||||||
printf(TRACE_INDENT "column winner:... ");
|
|
||||||
print_board(model.board);
|
|
||||||
model_line_t win = model_get_win_line(&model);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.dir, model_dir_v);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.start.row, 0);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.start.col, col);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
{
|
|
||||||
printf(TRACE_INDENT "diagonal left-right winner:... ");
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
for(size_t i = 0; i < MODEL_SIZE; i++) {
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, model_pos(i, i), model_state_a), 1);
|
|
||||||
}
|
|
||||||
// act & assert
|
|
||||||
print_board(model.board);
|
|
||||||
model_line_t win = model_get_win_line(&model);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.dir, model_dir_d);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.start.row, 0);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.start.col, 0);
|
|
||||||
}
|
|
||||||
{
|
|
||||||
printf(TRACE_INDENT "diagonal right-left winner:... ");
|
|
||||||
// arrange
|
|
||||||
model_t model;
|
|
||||||
init_model(&model, 0);
|
|
||||||
for(size_t i = 0; i < MODEL_SIZE; i++) {
|
|
||||||
CU_ASSERT_EQUAL_FATAL(model_move(&model, model_pos(MODEL_SIZE - 1 - i, i), model_state_a), 1);
|
|
||||||
}
|
|
||||||
// act & assert
|
|
||||||
print_board(model.board);
|
|
||||||
model_line_t win = model_get_win_line(&model);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.dir, model_dir_d);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.start.row, 0);
|
|
||||||
CU_ASSERT_EQUAL_FATAL(win.start.col, MODEL_SIZE - 1);
|
|
||||||
}
|
|
||||||
printf(TRACE_INDENT);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Registers and runs the tests.
|
|
||||||
* @returns success (0) or one of the CU_ErrorCode (>0)
|
|
||||||
*/
|
|
||||||
int main(void)
|
|
||||||
{
|
|
||||||
// setup, run, teardown
|
|
||||||
TestMainBasic("lab test", setup, teardown
|
|
||||||
, test_model_init
|
|
||||||
, test_model_get_state
|
|
||||||
, test_model_get_winner
|
|
||||||
, test_model_can_move
|
|
||||||
, test_model_move
|
|
||||||
, test_model_get_win_line
|
|
||||||
);
|
|
||||||
}
|
|
||||||
Binary file not shown.
Binary file not shown.
|
|
@ -1,254 +0,0 @@
|
||||||
# 06 - Personen Verwaltung – Linked List
|
|
||||||
___
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 1. Übersicht
|
|
||||||
In diesem Praktikum schreiben Sie eine einfache Personenverwaltung. Dabei werden Sie etliche Elemente von C anwenden:
|
|
||||||
* Header Files selber schreiben, inklusive Include Guard
|
|
||||||
* Typen definieren
|
|
||||||
* Funktionen mit `by value` und `by reference` Parametern deklarieren und definieren
|
|
||||||
* einfache Variablen, Pointer Variablen, struct Variablen und Array Variablen benutzen
|
|
||||||
* Strukturen im Speicher dynamisch allozieren und freigeben
|
|
||||||
* I/O und String Funktionen aus der Standard Library anwenden
|
|
||||||
* Anwender Eingaben verarbeiten
|
|
||||||
* Fehlerbehandlung
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 2. Lernziele
|
|
||||||
|
|
||||||
In diesem Praktikum wenden Sie viele der bisher gelernten C Elemente an.
|
|
||||||
* Sie können anhand dieser Beschreibung ein vollständiges C Programm schreiben.
|
|
||||||
* Sie können Unit Tests schreiben welche die wesentlichen Funktionen des Programms individuell testen.
|
|
||||||
*
|
|
||||||
Die Bewertung dieses Praktikums ist am Ende angegeben.
|
|
||||||
|
|
||||||
Erweitern Sie die vorgegebenen Code Gerüste, welche im `git` Repository `snp-lab-code` verfügbar sind.
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 3. Personenverwaltung
|
|
||||||
___
|
|
||||||
|
|
||||||
|
|
||||||
### 3.1 Programmfunktion
|
|
||||||
Das Programm soll in einer Schleife dem Benutzer jeweils folgende Auswahl bieten, wovon eine Aktion mit Eingabe des entsprechenden Buchstabens ausgelöst wird:
|
|
||||||
|
|
||||||
**I**(nsert), **R**(emove), **S**(how), **C**(lear), **E**(nd):
|
|
||||||
* **Insert**: der Benutzer wird aufgefordert, eine Person einzugeben
|
|
||||||
* **Remove**: der Benutzer wird aufgefordert, die Daten einer zu löschenden Person einzu-geben
|
|
||||||
* **Show**: eine komplette Liste aller gespeicherten Personen wird in alphabetischer Rei-henfolge ausgegeben
|
|
||||||
* **Clear**: alle Personen werden gelöscht
|
|
||||||
* **End**: das Programm wird beendet
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.2 Designvorgaben
|
|
||||||
|
|
||||||
**Verkettete Liste**
|
|
||||||
Da zur Kompilierzeit nicht bekannt ist, ob 10 oder 10'000 Personen eingegeben werden, wäre es keine gute Idee, im Programm einen statischen Array mit z.B. 10'000 Personen-Einträgen zu allozieren. Dies wäre ineffizient und umständlich beim sortierten Einfügen von Personen. In solchen Situationen arbeitet man deshalb mit dynamischen Datenstrukturen, die zur Laufzeit beliebig (solange Speicher vorhanden ist) wachsen und wieder schrumpfen können. Eine sehr populäre dynamische Datenstruktur ist die **verkettete Liste** und genau die werden wir in diesem Praktikum verwenden.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Abbildung 1: Zyklisch verkettete Liste
|
|
||||||
|
|
||||||
|
|
||||||
Eine verkettete Liste bedeutet, dass ein Knoten der verketten Liste einen Datensatz einer Person speichert und zusätzlich einen Pointer auf den nächsten Knoten in der Liste aufweist (siehe Abbildung 1). In dieser Pointer Variablen (`next` in der `node_t` Struktur unten) steht also einfach die Adresse des nächsten Knotens.
|
|
||||||
|
|
||||||
Die leere Liste besteht aus einem einzelnen Element, welches keine spezifische Person abspeichert und welches auf sich selbst zeigt (Abbildung 1 a). Dieses Element ist der Einstiegspunkt der Liste (auch Anker oder Wurzel genannt) und ist das einzige Element, das Sie im Programm direkt kennen und einer Variablen zuweisen. Dieses Element können Sie statisch allozieren (z.B. `node_t anchor`;, siehe Details weiter unten), denn es existiert während der gesamten Ausführungszeit. Alle anderen Elemente erreichen Sie ausgehend vom Anker, indem Sie einmal, den Pointern folgend, im Kreis herum gehen. Abbildung 1 b zeigt die Liste nach dem Einfügen der Person `Max Mueller, 40` Jahre. Nach dem Einfügen von zwei weiteren Personen sieht die Datenstruktur aus wie in Abbildung 1 c. Das Entfernen der Person `Arno Bosshard` führt zu Abbildung 1 d.
|
|
||||||
|
|
||||||
Eine Person kann **zugefügt** werden, indem dynamisch ein neuer Knoten erzeugt wird und dieser in die verkettete Liste eingefügt wird. Beim Einfügen müssen die Adressen der Knoten so den Pointern zugewiesen werden, dass die Kette intakt bleibt.
|
|
||||||
|
|
||||||
Ein Knoten wird **entfernt**, indem der entsprechende Knoten aus der Verkettung herausgelöst wird (`next` des Vorgängerknotens soll neu auf `next` des herauszulösenden Knotens zeigen) und dann der Speicher des entsprechenden Knotens freigegeben wird.
|
|
||||||
|
|
||||||
**Personen und Knoten Records**
|
|
||||||
|
|
||||||
Die für je eine Person zu speichernden Daten sollen in folgendem C `struct` zusammengefasst sein.
|
|
||||||
|
|
||||||
```C
|
|
||||||
#define NAME_LEN 20
|
|
||||||
|
|
||||||
typedef struct {
|
|
||||||
char name[NAME_LEN];
|
|
||||||
char first_name[NAME_LEN];
|
|
||||||
unsigned int age;
|
|
||||||
} person_t;
|
|
||||||
```
|
|
||||||
|
|
||||||
Jeder Knoten der verketteten Liste soll aus folgendem C `struct` bestehen.
|
|
||||||
|
|
||||||
```C
|
|
||||||
typedef struct node {
|
|
||||||
person_t content; // in diesem Knoten gespeicherte Person
|
|
||||||
struct node *next; // Pointer auf den nächsten Knoten in der Liste
|
|
||||||
} node_t;
|
|
||||||
```
|
|
||||||
|
|
||||||
**Vorschlag: zyklisch verkettete Liste**
|
|
||||||
|
|
||||||
Erkennen des Endes der Liste: bei der zyklisch verketteten Liste zeigt das letzte Element wie-der auf den Anker, die Liste bildet also einen Kreis. Dies ist in Abbildung 1 so abgebildet.
|
|
||||||
|
|
||||||
Alternativ könnte man das Ende erkennbar machen, indem die Kette anstelle von zyklisch, mit einem NULL Pointer endet.
|
|
||||||
|
|
||||||
Die Wahl ist ihnen überlassen ob sie die eine oder andere Art der End-Erkennung implementieren. In der Beschreibung wird angenommen, dass es sich um eine zyklisch verkettete Liste handelt.
|
|
||||||
|
|
||||||
**Sortiertes Einfügen**
|
|
||||||
|
|
||||||
Die Personen Records sollen sortiert in die Liste eingefügt werden. Dies bedeutet, dass vom Anker her gesucht werden soll, bis der erste Knoten gefunden wurde dessen Nachfolgeknoten entweder „grösser“ ist als der einzufügende Knoten, oder wo das Ende der Liste erreicht ist. Die Ordnung (grösser, gleich, kleiner) soll so definiert sein:
|
|
||||||
|
|
||||||
```C
|
|
||||||
// if (p1 > p2) { ... }
|
|
||||||
if (person_compare(&p1, &p2) > 0) { ... }
|
|
||||||
/**
|
|
||||||
* @brief Compares two persons in this sequence: 1st=name, 2nd=first_name, 3rd=age
|
|
||||||
* @param a [IN] const reference to 1st person in the comparison
|
|
||||||
* @param b [IN] const reference to 2nd person in the comparison
|
|
||||||
* @return =0 if all record fields are the same
|
|
||||||
* >0 if all previous fields are the same, but for this field, a is greater
|
|
||||||
* <0 if all previous fields are the same, but for this field, b is greater
|
|
||||||
* @remark strncmp() is used for producing the result of string field comparisons
|
|
||||||
* @remark a->age – b->age is used for producing the result of age comparison
|
|
||||||
*/
|
|
||||||
int person_compare(const person_t *a, const person_t *b);
|
|
||||||
```
|
|
||||||
|
|
||||||
**Eingabe**
|
|
||||||
|
|
||||||
**Fehlerhafte Wahl der Operation** in der Hauptschleife soll gemeldet werden, ansonsten aber ignoriert werden.
|
|
||||||
|
|
||||||
**Fehlerhafte Eingabe der Personenangaben** sollen gemeldet werden und die gesamte Operation (z.B. Insert) verworfen werden.
|
|
||||||
|
|
||||||
Zu prüfende Fehler bei Personeneingaben:
|
|
||||||
* für die Namen
|
|
||||||
* zu lange Namen
|
|
||||||
* für das Alter
|
|
||||||
* keine Zahl
|
|
||||||
* Duplikat
|
|
||||||
* derselbe Record soll nicht doppelt in der Liste vorkommen
|
|
||||||
|
|
||||||
Weitergehende Prüfungen sind nicht erwartet.
|
|
||||||
|
|
||||||
**Zu beachten:** bei fehlerhafter Eingabe darf kein „Memory Leak“ entstehen, d.h. potentiell auf dem Heap allozierter Speicher muss im Fehlerfall freigegeben werden.
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.3 Bestehender Programmrahmen
|
|
||||||
|
|
||||||
Der Programmrahmen besteht aus den unten aufgelisteten Files. Es sollen weitere Module in `src` hinzugefügt werden und die bestehenden Files ergänzt werden gemäss den Aufgaben.
|
|
||||||
|
|
||||||
| | |
|
|
||||||
| :-- | :-- |
|
|
||||||
| Makefile | -> **zu ergänzen** mit neuen Modulen |
|
|
||||||
| tests/tests.c | -> **zu ergänzen** gemäss Aufgaben (implementieren von Unit Tests) |
|
|
||||||
| src/main.c | -> **zu ergänzen** gemäss Aufgaben (Hauptprogramm) |
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 4. Aufgabe 1: Modularisierung – API und Implementation main.c
|
|
||||||
Kreieren Sie folgende Files in `src` und implementieren Sie `main.c` basierend auf dem unten von Ihnen gegebenen API.
|
|
||||||
|
|
||||||
|
|
||||||
**File person.h**
|
|
||||||
|
|
||||||
|
|
||||||
Typ Definitionen:
|
|
||||||
```C
|
|
||||||
person_t... // siehe Beschreibung oben
|
|
||||||
```
|
|
||||||
|
|
||||||
Funktionsdeklarationen:
|
|
||||||
```C
|
|
||||||
// siehe Beschreibung oben
|
|
||||||
int person_compare(const person_t *a, const person_t *b);
|
|
||||||
```
|
|
||||||
|
|
||||||
* gegebenenfalls weitere Funktionen für die Bearbeitung von Personen
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
**File list.h**
|
|
||||||
|
|
||||||
Typ Definitionen:
|
|
||||||
```C
|
|
||||||
person_t... // siehe Beschreibung oben
|
|
||||||
```
|
|
||||||
|
|
||||||
Funktionsdeklarationen:
|
|
||||||
* Funktionen für `insert`, `remove`, `clear` Operationen auf der Liste
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
Das Hauptprogramm soll die Eingabeschleife implementieren und die obigen Funktionen (wo angebracht) aufrufen.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 5. Aufgabe 2: Implementierung von person.c und list.c
|
|
||||||
|
|
||||||
Fügen Sie die beiden Implementationsfiles `person.c` und `list.c` zu `src`. Fügen Sie die beiden Module im `Makefile` zu der vorgegebenen Variablen `MODULES` hinzu, so dass sie beim `make` Aufruf auch berücksichtigt werden.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 5.1 Teilaufgabe: Implementierung von person.c
|
|
||||||
Implementieren Sie die Funktionen aus `person.h`.
|
|
||||||
|
|
||||||
Falls nötig, stellen Sie weitere statische Hilfsfunktionen in `person.c` zur Verfügung.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 5.2 Teilaufgabe: Implementierung von list.c
|
|
||||||
|
|
||||||
Implementieren Sie die Funktionen aus `list.h`.
|
|
||||||
|
|
||||||
Falls nötig, stellen Sie weitere statische Hilfsfunktionen in `list.c` zur Verfügung.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 6. Aufgabe 3: Unit Tests
|
|
||||||
|
|
||||||
Schreiben Sie Unit Tests für mindestens die folgenden Funktionen
|
|
||||||
|
|
||||||
* `person.h:`
|
|
||||||
* `person_compare`
|
|
||||||
* `list.h:`
|
|
||||||
* `list_insert`
|
|
||||||
* `list_remove`
|
|
||||||
* `list_clear`
|
|
||||||
|
|
||||||
Es existieren in `tests/tests.c` schon vier Test Rahmen für diese Test Cases.
|
|
||||||
|
|
||||||
In diese Test Cases sollen die entsprechenden Funktionen unter verschiedenen Bedingungen isoliert aufgerufen werden und deren Verhalten überprüft werden.
|
|
||||||
|
|
||||||
Verwenden Sie für die Überprüfung die CUnit `CU_ASSERT_...` Makros.
|
|
||||||
|
|
||||||
Siehe dazu auch `man CUnit`.
|
|
||||||
|
|
||||||
Wenn die obigen Teilaufgaben erfolgreich umgesetzt sind, laufen die Tests ohne Fehler durch.
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 7. Bewertung
|
|
||||||
|
|
||||||
| Aufgabe | Kriterium | Punkte |
|
|
||||||
| :-- | :-- | :-- |
|
|
||||||
| | Sie können das funktionierende Programm inklusive funktionierende Tests demonstrieren und erklären. | |
|
|
||||||
| 1 | API von list.h und person.h plus die Implementation von main.c | 2 |
|
|
||||||
| 2 | Teilaufgabe: person.c | 2 |
|
|
||||||
| 2 | Teilaufgabe: list.c | 2 |
|
|
||||||
| 3 | Unit Tests | 2 |
|
|
||||||
|
|
||||||
___
|
|
||||||
Version: 11.01.2022
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 829 B |
|
|
@ -1,42 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="210" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="90 400 210 160" height="160" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 30 L40 30 L40 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath3"
|
|
||||||
><path d="M0 0 L0 60 L100 60 L100 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath4"
|
|
||||||
><path d="M0 0 L0 80 L170 80 L170 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g font-family="sans-serif" font-size="14px" transform="translate(180,510)"
|
|
||||||
><text x="5" xml:space="preserve" y="17.9688" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
>a)</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(68,68,68)" fill-opacity="0.4902" transform="translate(140,450)" stroke-opacity="0.4902" stroke="rgb(68,68,68)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(140,450)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath3)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(110,420)"
|
|
||||||
><path fill="none" d="M29.5 60.5 L10.5 60.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path fill="none" d="M10.5 60.5 L10.5 10.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path fill="none" d="M10.5 10.5 L150.5 10.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path fill="none" d="M150.5 10.5 L150.5 60.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path fill="none" d="M150.5 60.5 L130.5 60.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path d="M18.7417 54 L30 60.5 L18.7417 67 Z" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/><path fill="none" d="M18.7417 54 L30 60.5 L18.7417 67 Z" clip-path="url(#clipPath4)"
|
|
||||||
/></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 2.5 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 1.9 KiB |
|
|
@ -1,59 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="210" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="320 420 210 220" height="220" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 30 L40 30 L40 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath3"
|
|
||||||
><path d="M0 0 L0 60 L100 60 L100 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath4"
|
|
||||||
><path d="M0 0 L0 120 L50 120 L50 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g font-family="sans-serif" font-size="14px" transform="translate(410,590)"
|
|
||||||
><text x="5" xml:space="preserve" y="17.9688" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
>b)</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(370,440)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(370,440)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath3)"
|
|
||||||
/><text x="5" font-size="14px" y="19.0156" clip-path="url(#clipPath3)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Mueller</text
|
|
||||||
><text x="5" font-size="14px" y="34.9844" clip-path="url(#clipPath3)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Max</text
|
|
||||||
><text x="5" font-size="14px" y="50.9531" clip-path="url(#clipPath3)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>40</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(68,68,68)" fill-opacity="0.4902" transform="translate(370,530)" stroke-opacity="0.4902" stroke="rgb(68,68,68)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(370,530)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath3)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(340,460)"
|
|
||||||
><path fill="none" d="M29.5 100.5 L10.5 100.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path fill="none" d="M10.5 100.5 L10.5 10.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path fill="none" d="M10.5 10.5 L30.5 10.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path d="M18.7417 94 L30 100.5 L18.7417 107 Z" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/><path fill="none" d="M18.7417 94 L30 100.5 L18.7417 107 Z" clip-path="url(#clipPath4)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(460,460)"
|
|
||||||
><path fill="none" d="M11.5 10.5 L30.5 10.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path fill="none" d="M30.5 10.5 L30.5 100.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path fill="none" d="M30.5 100.5 L10.5 100.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path d="M22.2583 17 L11 10.5 L22.2583 4 Z" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/><path fill="none" d="M22.2583 17 L11 10.5 L22.2583 4 Z" clip-path="url(#clipPath4)"
|
|
||||||
/></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 3.6 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 4.1 KiB |
|
|
@ -1,89 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="380" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="70 580 380 270" height="270" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 60 L100 60 L100 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath3"
|
|
||||||
><path d="M0 0 L0 30 L40 30 L40 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath4"
|
|
||||||
><path d="M0 0 L0 70 L100 70 L100 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(330,670)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(330,670)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="5" font-size="14px" y="19.0156" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Bosshard </text
|
|
||||||
><text x="5" font-size="14px" y="34.9844" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Arno</text
|
|
||||||
><text x="5" font-size="14px" y="50.9531" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>62</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(210,600)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(210,600)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="5" font-size="14px" y="19.0156" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Mueller</text
|
|
||||||
><text x="5" font-size="14px" y="34.9844" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Max</text
|
|
||||||
><text x="5" font-size="14px" y="50.9531" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>40</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(90,670)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(90,670)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="5" font-size="14px" y="19.0156" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Schmid </text
|
|
||||||
><text x="5" font-size="14px" y="34.9844" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Anna </text
|
|
||||||
><text x="5" font-size="14px" y="50.9531" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>32</text
|
|
||||||
></g
|
|
||||||
><g font-family="sans-serif" font-size="14px" transform="translate(250,800)"
|
|
||||||
><text x="5" xml:space="preserve" y="17.9688" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
>c)</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(68,68,68)" fill-opacity="0.4902" transform="translate(210,740)" stroke-opacity="0.4902" stroke="rgb(68,68,68)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(210,740)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(130,720)"
|
|
||||||
><path fill="none" d="M79.6318 50.0039 L10.5 10.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path d="M73.5158 39.0227 L80.0659 50.2519 L67.066 50.3098 Z" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/><path fill="none" d="M73.5158 39.0227 L80.0659 50.2519 L67.066 50.3098 Z" clip-path="url(#clipPath4)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(130,620)"
|
|
||||||
><path fill="none" d="M11.3682 50.0039 L80.5 10.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path d="M23.934 50.3098 L10.9341 50.2519 L17.4842 39.0227 Z" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/><path fill="none" d="M23.934 50.3098 L10.9341 50.2519 L17.4842 39.0227 Z" clip-path="url(#clipPath4)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(300,620)"
|
|
||||||
><path fill="none" d="M11.3682 10.9961 L80.5 50.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path d="M17.4842 21.9773 L10.9341 10.7481 L23.934 10.6902 Z" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/><path fill="none" d="M17.4842 21.9773 L10.9341 10.7481 L23.934 10.6902 Z" clip-path="url(#clipPath4)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(300,720)"
|
|
||||||
><path fill="none" d="M79.6318 10.9961 L10.5 50.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path d="M67.066 10.6902 L80.0659 10.7481 L73.5158 21.9773 Z" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/><path fill="none" d="M67.066 10.6902 L80.0659 10.7481 L73.5158 21.9773 Z" clip-path="url(#clipPath4)"
|
|
||||||
/></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 5.7 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 3.3 KiB |
|
|
@ -1,78 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="380" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="300 830 380 210" height="210" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 60 L100 60 L100 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath3"
|
|
||||||
><path d="M0 0 L0 30 L40 30 L40 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath4"
|
|
||||||
><path d="M0 0 L0 30 L170 30 L170 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath5"
|
|
||||||
><path d="M0 0 L0 80 L110 80 L110 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath6"
|
|
||||||
><path d="M0 0 L0 80 L100 80 L100 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(560,850)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(560,850)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="5" font-size="14px" y="19.0156" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Mueller</text
|
|
||||||
><text x="5" font-size="14px" y="34.9844" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Max</text
|
|
||||||
><text x="5" font-size="14px" y="50.9531" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>40</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(320,850)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(320,850)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="5" font-size="14px" y="19.0156" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Schmid </text
|
|
||||||
><text x="5" font-size="14px" y="34.9844" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Anna </text
|
|
||||||
><text x="5" font-size="14px" y="50.9531" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>32</text
|
|
||||||
></g
|
|
||||||
><g font-family="sans-serif" font-size="14px" transform="translate(480,990)"
|
|
||||||
><text x="5" xml:space="preserve" y="17.9688" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
>d)</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(68,68,68)" fill-opacity="0.4902" transform="translate(440,930)" stroke-opacity="0.4902" stroke="rgb(68,68,68)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(440,930)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(410,870)"
|
|
||||||
><path fill="none" d="M11.5 10.5 L150.5 10.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path d="M22.2583 17 L11 10.5 L22.2583 4 Z" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/><path fill="none" d="M22.2583 17 L11 10.5 L22.2583 4 Z" clip-path="url(#clipPath4)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(350,900)"
|
|
||||||
><path fill="none" d="M89.652 59.97 L10.5 10.5" clip-path="url(#clipPath5)"
|
|
||||||
/><path d="M83.9739 48.7561 L90.076 60.235 L77.084 59.7801 Z" clip-path="url(#clipPath5)" stroke="none"
|
|
||||||
/><path fill="none" d="M83.9739 48.7561 L90.076 60.235 L77.084 59.7801 Z" clip-path="url(#clipPath5)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(530,900)"
|
|
||||||
><path fill="none" d="M79.6863 11.0812 L10.5 60.5" clip-path="url(#clipPath6)"
|
|
||||||
/><path d="M67.1538 12.0451 L80.0931 10.7906 L74.7099 22.6237 Z" clip-path="url(#clipPath6)" stroke="none"
|
|
||||||
/><path fill="none" d="M67.1538 12.0451 L80.0931 10.7906 L74.7099 22.6237 Z" clip-path="url(#clipPath6)"
|
|
||||||
/></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 4.8 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 2.9 KiB |
|
|
@ -1,68 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<!DOCTYPE svg PUBLIC '-//W3C//DTD SVG 1.0//EN'
|
|
||||||
'http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd'>
|
|
||||||
<svg fill-opacity="1" xmlns:xlink="http://www.w3.org/1999/xlink" color-rendering="auto" color-interpolation="auto" text-rendering="auto" stroke="black" stroke-linecap="square" width="300" stroke-miterlimit="10" shape-rendering="auto" stroke-opacity="1" fill="black" stroke-dasharray="none" font-weight="normal" stroke-width="1" viewBox="110 80 300 200" height="200" xmlns="http://www.w3.org/2000/svg" font-family="'Dialog'" font-style="normal" stroke-linejoin="miter" font-size="12px" stroke-dashoffset="0" image-rendering="auto"
|
|
||||||
><!--Generated by the Batik Graphics2D SVG Generator--><defs id="genericDefs"
|
|
||||||
/><g
|
|
||||||
><defs id="defs1"
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath1"
|
|
||||||
><path d="M0 0 L2147483647 0 L2147483647 2147483647 L0 2147483647 L0 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath2"
|
|
||||||
><path d="M0 0 L0 60 L100 60 L100 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath3"
|
|
||||||
><path d="M0 0 L0 70 L60 70 L60 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
><clipPath clipPathUnits="userSpaceOnUse" id="clipPath4"
|
|
||||||
><path d="M0 0 L0 30 L90 30 L90 0 Z"
|
|
||||||
/></clipPath
|
|
||||||
></defs
|
|
||||||
><g fill="rgb(68,68,68)" fill-opacity="0.4902" transform="translate(210,200)" stroke-opacity="0.4902" stroke="rgb(68,68,68)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(210,200)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(290,100)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(290,100)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="5" font-size="14px" y="19.0156" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Mueller</text
|
|
||||||
><text x="5" font-size="14px" y="34.9844" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Max</text
|
|
||||||
><text x="5" font-size="14px" y="50.9531" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>40</text
|
|
||||||
></g
|
|
||||||
><g fill="rgb(255,255,255)" fill-opacity="0" transform="translate(130,100)" stroke-opacity="0" stroke="rgb(255,255,255)"
|
|
||||||
><rect x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)" stroke="none"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(130,100)"
|
|
||||||
><rect fill="none" x="0.5" width="98.5" height="58.5" y="0.5" clip-path="url(#clipPath2)"
|
|
||||||
/><text x="5" font-size="14px" y="19.0156" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Schmid </text
|
|
||||||
><text x="5" font-size="14px" y="34.9844" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>Anna </text
|
|
||||||
><text x="5" font-size="14px" y="50.9531" clip-path="url(#clipPath2)" font-family="sans-serif" stroke="none" xml:space="preserve"
|
|
||||||
>32</text
|
|
||||||
></g
|
|
||||||
><g transform="translate(300,150)"
|
|
||||||
><path fill="none" d="M39.9 11.3 L10.5 50.5" clip-path="url(#clipPath3)"
|
|
||||||
/><path d="M28.245 16.0067 L40.2 10.9 L38.645 23.8067 Z" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
/><path fill="none" d="M28.245 16.0067 L40.2 10.9 L38.645 23.8067 Z" clip-path="url(#clipPath3)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(170,150)"
|
|
||||||
><path fill="none" d="M39.9 49.7 L10.5 10.5" clip-path="url(#clipPath3)"
|
|
||||||
/><path d="M38.645 37.1933 L40.2 50.1 L28.245 44.9933 Z" clip-path="url(#clipPath3)" stroke="none"
|
|
||||||
/><path fill="none" d="M38.645 37.1933 L40.2 50.1 L28.245 44.9933 Z" clip-path="url(#clipPath3)"
|
|
||||||
/></g
|
|
||||||
><g transform="translate(220,120)"
|
|
||||||
><path fill="none" d="M11.5 10.5 L70.5 10.5" clip-path="url(#clipPath4)"
|
|
||||||
/><path d="M22.2583 17 L11 10.5 L22.2583 4 Z" clip-path="url(#clipPath4)" stroke="none"
|
|
||||||
/><path fill="none" d="M22.2583 17 L11 10.5 L22.2583 4 Z" clip-path="url(#clipPath4)"
|
|
||||||
/></g
|
|
||||||
></g
|
|
||||||
></svg
|
|
||||||
>
|
|
||||||
|
Before Width: | Height: | Size: 4.3 KiB |
|
|
@ -1,386 +0,0 @@
|
||||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
|
||||||
<diagram program="umlet" version="14.3.0">
|
|
||||||
<zoom_level>10</zoom_level>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>120</x>
|
|
||||||
<y>80</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Schmid
|
|
||||||
Anna
|
|
||||||
32
|
|
||||||
halign=left</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>210</x>
|
|
||||||
<y>100</y>
|
|
||||||
<w>90</w>
|
|
||||||
<h>30</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>10.0;10.0;70.0;10.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>280</x>
|
|
||||||
<y>80</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Mueller
|
|
||||||
Max
|
|
||||||
40
|
|
||||||
halign=left</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>200</x>
|
|
||||||
<y>180</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>
|
|
||||||
halign=left
|
|
||||||
bg=#444444</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>160</x>
|
|
||||||
<y>130</y>
|
|
||||||
<w>60</w>
|
|
||||||
<h>70</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>40.0;50.0;10.0;10.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>290</x>
|
|
||||||
<y>130</y>
|
|
||||||
<w>60</w>
|
|
||||||
<h>70</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>40.0;10.0;10.0;50.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>320</x>
|
|
||||||
<y>320</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Bosshard
|
|
||||||
Arno
|
|
||||||
62
|
|
||||||
halign=left</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>140</x>
|
|
||||||
<y>450</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>
|
|
||||||
halign=left
|
|
||||||
bg=#444444</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>110</x>
|
|
||||||
<y>420</y>
|
|
||||||
<w>170</w>
|
|
||||||
<h>80</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>30.0;60.0;10.0;60.0;10.0;10.0;150.0;10.0;150.0;60.0;130.0;60.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>370</x>
|
|
||||||
<y>530</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>
|
|
||||||
halign=left
|
|
||||||
bg=#444444</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>370</x>
|
|
||||||
<y>440</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Mueller
|
|
||||||
Max
|
|
||||||
40
|
|
||||||
halign=left</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>460</x>
|
|
||||||
<y>460</y>
|
|
||||||
<w>50</w>
|
|
||||||
<h>120</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>10.0;10.0;30.0;10.0;30.0;100.0;10.0;100.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>340</x>
|
|
||||||
<y>460</y>
|
|
||||||
<w>50</w>
|
|
||||||
<h>120</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>30.0;100.0;10.0;100.0;10.0;10.0;30.0;10.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Text</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>180</x>
|
|
||||||
<y>510</y>
|
|
||||||
<w>40</w>
|
|
||||||
<h>30</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>a)
|
|
||||||
style=wordwrap</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Text</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>410</x>
|
|
||||||
<y>590</y>
|
|
||||||
<w>40</w>
|
|
||||||
<h>30</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>b)
|
|
||||||
style=wordwrap</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>210</x>
|
|
||||||
<y>740</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>
|
|
||||||
halign=left
|
|
||||||
bg=#444444</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Text</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>250</x>
|
|
||||||
<y>800</y>
|
|
||||||
<w>40</w>
|
|
||||||
<h>30</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>c)
|
|
||||||
style=wordwrap</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>90</x>
|
|
||||||
<y>670</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Schmid
|
|
||||||
Anna
|
|
||||||
32
|
|
||||||
halign=left</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>210</x>
|
|
||||||
<y>600</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Mueller
|
|
||||||
Max
|
|
||||||
40
|
|
||||||
halign=left</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>330</x>
|
|
||||||
<y>670</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Bosshard
|
|
||||||
Arno
|
|
||||||
62
|
|
||||||
halign=left</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>300</x>
|
|
||||||
<y>720</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>70</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>80.0;10.0;10.0;50.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>300</x>
|
|
||||||
<y>620</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>70</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>10.0;10.0;80.0;50.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>130</x>
|
|
||||||
<y>620</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>70</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>10.0;50.0;80.0;10.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>130</x>
|
|
||||||
<y>720</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>70</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>80.0;50.0;10.0;10.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>440</x>
|
|
||||||
<y>930</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>
|
|
||||||
halign=left
|
|
||||||
bg=#444444</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Text</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>480</x>
|
|
||||||
<y>990</y>
|
|
||||||
<w>40</w>
|
|
||||||
<h>30</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>d)
|
|
||||||
style=wordwrap</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>320</x>
|
|
||||||
<y>850</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Schmid
|
|
||||||
Anna
|
|
||||||
32
|
|
||||||
halign=left</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>UMLObject</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>560</x>
|
|
||||||
<y>850</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>60</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>Mueller
|
|
||||||
Max
|
|
||||||
40
|
|
||||||
halign=left</panel_attributes>
|
|
||||||
<additional_attributes/>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>530</x>
|
|
||||||
<y>900</y>
|
|
||||||
<w>100</w>
|
|
||||||
<h>80</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>80.0;10.0;10.0;60.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>350</x>
|
|
||||||
<y>900</y>
|
|
||||||
<w>110</w>
|
|
||||||
<h>80</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>90.0;60.0;10.0;10.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
<element>
|
|
||||||
<id>Relation</id>
|
|
||||||
<coordinates>
|
|
||||||
<x>410</x>
|
|
||||||
<y>870</y>
|
|
||||||
<w>170</w>
|
|
||||||
<h>30</h>
|
|
||||||
</coordinates>
|
|
||||||
<panel_attributes>lt=<<<-</panel_attributes>
|
|
||||||
<additional_attributes>10.0;10.0;150.0;10.0</additional_attributes>
|
|
||||||
</element>
|
|
||||||
</diagram>
|
|
||||||
|
|
@ -1,13 +0,0 @@
|
||||||
SNP_SHARED_MAKEFILE := $(if $(SNP_SHARED_MAKEFILE),$(SNP_SHARED_MAKEFILE),"~/snp/shared.mk")
|
|
||||||
|
|
||||||
TARGET := bin/personen-verwaltung
|
|
||||||
# BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
MODULES :=
|
|
||||||
# END-STUDENTS-TO-ADD-CODE
|
|
||||||
SOURCES := src/main.c $(MODULES)
|
|
||||||
TSTSOURCES := tests/tests.c $(MODULES)
|
|
||||||
|
|
||||||
|
|
||||||
include $(SNP_SHARED_MAKEFILE)
|
|
||||||
|
|
||||||
# CFLAGS += -Werror
|
|
||||||
|
|
@ -1,8 +0,0 @@
|
||||||
/**
|
|
||||||
* @mainpage SNP - P07 Linked List
|
|
||||||
*
|
|
||||||
* @section Purpose
|
|
||||||
*
|
|
||||||
* This is a lab on usage of arrays.
|
|
||||||
*
|
|
||||||
*/
|
|
||||||
|
|
@ -1,29 +0,0 @@
|
||||||
/* ----------------------------------------------------------------------------
|
|
||||||
* -- _____ ______ _____ -
|
|
||||||
* -- |_ _| | ____|/ ____| -
|
|
||||||
* -- | | _ __ | |__ | (___ Institute of Embedded Systems -
|
|
||||||
* -- | | | '_ \| __| \___ \ Zuercher Hochschule Winterthur -
|
|
||||||
* -- _| |_| | | | |____ ____) | (University of Applied Sciences) -
|
|
||||||
* -- |_____|_| |_|______|_____/ 8401 Winterthur, Switzerland -
|
|
||||||
* ----------------------------------------------------------------------------
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief Lab implementation
|
|
||||||
*/
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Main entry point.
|
|
||||||
* @param[in] argc The size of the argv array.
|
|
||||||
* @param[in] argv The command line arguments...
|
|
||||||
* @returns Returns EXIT_SUCCESS (=0) on success, EXIT_FAILURE (=1) there is an expression syntax error.
|
|
||||||
*/
|
|
||||||
int main(int argc, char* argv[])
|
|
||||||
{
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
return EXIT_SUCCESS;
|
|
||||||
}
|
|
||||||
|
|
@ -1,119 +0,0 @@
|
||||||
/* ----------------------------------------------------------------------------
|
|
||||||
* -- _____ ______ _____ -
|
|
||||||
* -- |_ _| | ____|/ ____| -
|
|
||||||
* -- | | _ __ | |__ | (___ Institute of Embedded Systems -
|
|
||||||
* -- | | | '_ \| __| \___ \ Zuercher Hochschule Winterthur -
|
|
||||||
* -- _| |_| | | | |____ ____) | (University of Applied Sciences) -
|
|
||||||
* -- |_____|_| |_|______|_____/ 8401 Winterthur, Switzerland -
|
|
||||||
* ----------------------------------------------------------------------------
|
|
||||||
*/
|
|
||||||
/**
|
|
||||||
* @file
|
|
||||||
* @brief Test suite for the given package.
|
|
||||||
*/
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <sys/wait.h>
|
|
||||||
#include <time.h>
|
|
||||||
#include <assert.h>
|
|
||||||
#include <CUnit/Basic.h>
|
|
||||||
#include "test_utils.h"
|
|
||||||
|
|
||||||
#ifndef TARGET // must be given by the make file --> see test target
|
|
||||||
#error missing TARGET define
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/// @brief alias for EXIT_SUCCESS
|
|
||||||
#define OK EXIT_SUCCESS
|
|
||||||
/// @brief alias for EXIT_FAILURE
|
|
||||||
#define FAIL EXIT_FAILURE
|
|
||||||
|
|
||||||
/// @brief The name of the STDOUT text file.
|
|
||||||
#define OUTFILE "stdout.txt"
|
|
||||||
/// @brief The name of the STDERR text file.
|
|
||||||
#define ERRFILE "stderr.txt"
|
|
||||||
|
|
||||||
#define TRACE_INDENT "\n " ///< allow for better stdout formatting in case of error
|
|
||||||
|
|
||||||
// setup & cleanup
|
|
||||||
static int setup(void)
|
|
||||||
{
|
|
||||||
remove_file_if_exists(OUTFILE);
|
|
||||||
remove_file_if_exists(ERRFILE);
|
|
||||||
return 0; // success
|
|
||||||
}
|
|
||||||
|
|
||||||
static int teardown(void)
|
|
||||||
{
|
|
||||||
// Do nothing.
|
|
||||||
// Especially: do not remove result files - they are removed in int setup(void) *before* running a test.
|
|
||||||
return 0; // success
|
|
||||||
}
|
|
||||||
|
|
||||||
// tests
|
|
||||||
static void test_person_compare(void)
|
|
||||||
{
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
// arrange
|
|
||||||
|
|
||||||
// act
|
|
||||||
CU_FAIL("missing test");
|
|
||||||
|
|
||||||
// assert
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
static void test_list_insert(void)
|
|
||||||
{
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
// arrange
|
|
||||||
|
|
||||||
// act
|
|
||||||
CU_FAIL("missing test");
|
|
||||||
|
|
||||||
// assert
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
static void test_list_remove(void)
|
|
||||||
{
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
// arrange
|
|
||||||
|
|
||||||
// act
|
|
||||||
CU_FAIL("missing test");
|
|
||||||
|
|
||||||
// assert
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
static void test_list_clear(void)
|
|
||||||
{
|
|
||||||
// BEGIN-STUDENTS-TO-ADD-CODE
|
|
||||||
// arrange
|
|
||||||
|
|
||||||
// act
|
|
||||||
CU_FAIL("missing test");
|
|
||||||
|
|
||||||
// assert
|
|
||||||
|
|
||||||
// END-STUDENTS-TO-ADD-CODE
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief Registers and runs the tests.
|
|
||||||
* @returns success (0) or one of the CU_ErrorCode (>0)
|
|
||||||
*/
|
|
||||||
int main(void)
|
|
||||||
{
|
|
||||||
// setup, run, teardown
|
|
||||||
TestMainBasic("lab test", setup, teardown
|
|
||||||
, test_person_compare
|
|
||||||
, test_list_insert
|
|
||||||
, test_list_remove
|
|
||||||
, test_list_clear
|
|
||||||
);
|
|
||||||
}
|
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
|
@ -1,5 +0,0 @@
|
||||||
[0] Config.pm:311> INFO - This is Biber 2.16
|
|
||||||
[0] Config.pm:314> INFO - Logfile is 'README.blg'
|
|
||||||
[131] biber-MSWIN64:340> INFO - ===
|
|
||||||
[445] Utils.pm:411> ERROR - Cannot find 'README.bcf'!
|
|
||||||
[445] Biber.pm:132> INFO - ERRORS: 1
|
|
||||||
|
|
@ -1,441 +0,0 @@
|
||||||
# 07 - Prozesse und Threads
|
|
||||||
___
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
[Quelle: https://www.wikiwand.com/de/Ein-Mann-Orchester](https://www.wikiwand.com/de/Ein-Mann-Orchester)
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 1. Übersicht
|
|
||||||
In diesem Praktikum werden wir uns mit Prozessen, Prozesshierarchien und Threads beschäftigen, um ein gutes Grundverständnis dieser Abstraktionen zu erhalten. Sie werden bestehenden Code analysieren und damit experimentieren. D.h. dies ist nicht ein «Codierungs»-Praktikum, sondern ein «Analyse»- und «Experimentier»-Praktikum.
|
|
||||||
___
|
|
||||||
|
|
||||||
### 1.1 Nachweis
|
|
||||||
Dieses Praktikum ist eine leicht abgewandelte Variante des ProcThreads Praktikum des Moduls BSY, angepasst an die Verhältnisse des SNP Moduls. Die Beispiele und Beschreibungen wurden, wo möglich, eins-zu-ein übernommen.
|
|
||||||
|
|
||||||
Als Autoren des BSY Praktikums sind genannt: M. Thaler, J. Zeman.
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 2. Lernziele
|
|
||||||
In diesem Praktikum werden Sie sich mit Prozessen, Prozesshierarchien und Threads beschäftigen. Sie erhalten einen vertieften Einblick und Verständnis zur Erzeugung, Steuerung und Terminierung von Prozessen unter Unix/Linux und Sie werden die unterschiedlichen Eigenschaften von Prozessen und Threads kennenlernen.
|
|
||||||
* Sie können Prozesse erzeugen und die Prozesshierarchie erklären
|
|
||||||
* Sie wissen was beim Erzeugen eines Prozesses vom Elternprozess vererbt wird
|
|
||||||
* Sie wissen wie man auf die Terminierung von Kindprozessen wartet
|
|
||||||
* Sie kennen die Unterschiede zwischen Prozessen und Threads
|
|
||||||
___
|
|
||||||
|
|
||||||
## 3. Aufgaben
|
|
||||||
Das Betriebssystem bietet Programme um die aktuellen Prozesse und Threads darzustellen.
|
|
||||||
|
|
||||||
Die Werkzeuge kommen mit einer Vielzahl von Optionen für die Auswahl und Darstellung der Daten, z.B. ob nur Prozesse oder auch Threads aufgelistet werden sollen, und ob alle Prozesse oder nur die «eigenen» Prozesse ausgewählt werden sollen, etc.
|
|
||||||
|
|
||||||
Siehe die entsprechenden `man` Pages für weitere Details.
|
|
||||||
|
|
||||||
Eine Auswahl, welche unter Umständen für die folgenden Aufgaben nützlich sind:
|
|
||||||
|
|
||||||
| | |
|
|
||||||
| :-- | :-- |
|
|
||||||
| `ps` | Auflisten der Prozess Zustände zum gegebenen Zeitpunkt. |
|
|
||||||
| `pstree` | Darstellung der gesamten Prozesshierarchie. |
|
|
||||||
| `top` | Wie `ps`, aber die Darstellung wird in Zeitintervallen aufdatiert. |
|
|
||||||
| `htop` | Wie `top`, aber zusätzlich dazu die Auslastung der CPU in einem System mit mehreren CPUs. |
|
|
||||||
| `lscpu` | Auflisten der CPUs. |
|
|
||||||
| `cat`/`proc`/`cpuinfo` | Ähnlich zu `lscpu`, aber mit Zusatzinformationen wie enthaltene CPU Bugs (z.B. `bugs: cpu_meltdown spectre_v1 spect-re_v2 spec_store_bypass l1tf mds swapgs itlb_multihit`) |
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.1 Aufgabe 1: Prozess mit fork() erzeugen
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
|
|
||||||
* Verstehen, wie mit `fork()` Prozesse erzeugt werden.
|
|
||||||
* Einfache Prozesshierarchien kennenlernen.
|
|
||||||
* Verstehen, wie ein Programm, das `fork()` aufruft, durchlaufen wird.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
1. Studieren Sie zuerst das Programm `ProcA1.c` und beschrieben Sie was geschieht.
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
2. Notieren Sie sich, was ausgegeben wird. Starten Sie das Programm und vergleichen Sie die Ausgabe mit ihren Notizen? Was ist gleich, was anders und wieso?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.2 Aufgabe 2: Prozess mit fork() und exec(): Programm Image ersetzen
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
* An einem Beispiel die Funktion `execl()` kennenlernen.
|
|
||||||
* Verstehen, wie nach `fork()` ein neues Programm gestartet wird.
|
|
||||||
**Aufgaben**
|
|
||||||
1. Studieren Sie zuerst die Programme `ProcA2.c` und `ChildProcA2.c`.
|
|
||||||
2. Starten Sie `ProcA2.e` und vergleichen Sie die Ausgabe mit der Ausgabe unter Aufgabe 1. Diskutieren und erklären Sie was gleich ist und was anders.
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
3. Benennen Sie `ChildProcA2.e` auf `ChildProcA2.f` um (Shell Befehl `mv`) und überlegen Sie, was das Programm nun ausgibt. Starten Sie `ProcA2.e` und vergleichen Sie Ihre Überlegungen mit der Programmausgabe.
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
4. Nennen Sie das Kindprogramm wieder `ChildProcA2.e` und geben Sie folgenden Befehl ein: `chmod -x ChildProcA2.e`. Starten Sie wiederum `ProcA2.e` und analysieren Sie die Ausgabe von `perror("...")`. Wieso verwenden wir `perror()`?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.3 Aufgabe 3: Prozesshierarchie analysieren
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
|
|
||||||
* Verstehen, was `fork()` wirklich macht.
|
|
||||||
* Verstehen, was Prozesshierarchien sind.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
|
|
||||||
1. Studieren Sie zuerst Programm `ProcA3.c` und zeichnen Sie die entstehende Prozesshierarchie (Baum) von Hand auf. Starten Sie das Programm und verifizieren Sie ob Ihre Prozesshierarchie stimmt.
|
|
||||||
2. Mit dem Befehl `ps f` oder `pstree` können Sie die Prozesshierarchie auf dem Bildschirm ausgeben. Damit die Ausgabe von `pstree` übersichtlich ist, müssen Sie in dem Fenster, wo Sie das Programm `ProcA3.e` starten, zuerst die PID der Shell erfragen, z.B. über `echo $$`. Wenn Sie nun den Befehl `pstree -n -p pid-von-oben` eingeben, wird nur die Prozesshierarchie ausgehend von der Bash Shell angezeigt: `-n` sortiert die Prozesse numerisch, `-p` zeigt für jeden Prozess die PID an.
|
|
||||||
|
|
||||||
**Hinweis:** alle erzeugten Prozesse müssen arbeiten (d.h. nicht terminiert sein), damit die Darstellung gelingt. Wie wird das im gegebenen Programm erreicht?
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.4 Aufgabe 4: Zeitlicher Ablauf von Prozessen
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
|
|
||||||
* Verstehen, wie Kind- und Elternprozesse zeitlich ablaufen.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
|
|
||||||
1. Studieren Sie Programm `ProcA4.c.` Starten Sie nun mehrmals hintereinander das Programm `ProcA4.e` und vergleichen Sie die jeweiligen Outputs (leiten Sie dazu auch die Ausgabe auf verschiedene Dateien um). Was schliessen Sie aus dem Resultat?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
**Anmerkung:** Der Funktionsaufruf `selectCPU(0)` erzwingt die Ausführung des Eltern- und Kindprozesses auf CPU 0 (siehe Modul `setCPU.c`). Die Prozedur `justWork(HARD_WORK)` simuliert CPU-Load durch den Prozess (siehe Modul `workerUtils.c`).
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.5 Aufgabe 5: Waisenkinder (Orphan Processes)
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
* Verstehen, was mit verwaisten Kindern geschieht.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
1. Analysieren Sie Programm `ProcA5.c`: was läuft ab und welche Ausgabe erwarten Sie?
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
2. Starten Sie `ProcA5.e`: der Elternprozess terminiert: was geschieht mit dem Kind?
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
3. Was geschieht, wenn der Kindprozess vor dem Elternprozess terminiert? Ändern Sie dazu im `sleep()` Befehl die Zeit von 2 Sekunden auf 12 Sekunden und verfolgen Sie mit top das Verhalten der beiden Prozesse, speziell auch die Spalte S.
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.6 Aufgabe 6: Terminierte, halbtote Prozesse (Zombies)
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
|
|
||||||
* Verstehen, was ein Zombie ist.
|
|
||||||
* Eine Möglichkeit kennenlernen, um Zombies zu verhindern.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
|
|
||||||
1. Analysieren Sie das Programm `ProcA6.c`.
|
|
||||||
2. Starten Sie das Script `mtop` bzw. `mtop aaaa.e`. Es stellt das Verhalten der Prozesse dynamisch dar.
|
|
||||||
|
|
||||||
**Hinweis:** `<defunct>` = Zombie.
|
|
||||||
3. Starten Sie `aaaa.e` und verfolgen Sie im `mtop`-Fenster was geschieht. Was beachten Sie?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
4. In gewissen Fällen will man nicht auf die Terminierung eines Kindes mit `wait()`, bzw. `waitpid()` warten. Überlegen Sie sich, wie Sie in diesem Fall verhindern können, dass ein Kind zum Zombie wird.
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.7 Aufgabe 7: Auf Terminieren von Kindprozessen warten
|
|
||||||
|
|
||||||
**Vorbemerkung:** Diese Aufgabe verwendet Funktionen welche erst in der Vorlesung über *Inter-Process-Communication (IPC)* im Detail behandelt werden.
|
|
||||||
|
|
||||||
Sie können diese Aufgabe bis dann aufsparen oder die verwendeten Funktionen selber via `man` Pages im benötigten Umfang kennenlernen: `man 2 kill` und `man 7 signal`.
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
* Verstehen, wie Informationen zu Kindprozessen abgefragt werden können.
|
|
||||||
* Die Befehle `wait()` und `waitpid()` verwenden können.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
1. Starten Sie das Programm `ProcA7.e` und analysieren Sie wie die Ausgabe im Hauptprogramm zustande kommt und was im Kindprozess `ChildProcA7.c` abläuft.
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
2. Starten Sie `ProcA7.e` und danach nochmals mit `1` als erstem Argument. Dieser Argument Wert bewirkt, dass im Kindprozess ein ”Segmentation Error” erzeugt wird, also eine Speicherzugriffsverletzung. Welches Signal wird durch die Zugriffsverletzung an das Kind geschickt? Diese Information finden Sie im Manual mit `man 7 signal`. Schalten Sie nun core dump ein (siehe README) und starten Sie `ProcA7.e 1` erneut und analysieren Sie die Ausgabe.
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
**Hinweis:** ein core Dump ist ein Abbild des Speichers z.B. zum Zeitpunkt, wenn das Programm abstürzt (wie oben mit der Speicher Zugriff Verletzung). Der Dump wird im File **core** abgelegt und kann mit dem **gdb** (GNU-Debugger) gelesen werden (siehe `README`). Tippen Sie nach dem Starten des Command Line UI des `gdb where` gefolgt von list ein, damit sie den Ort des Absturzes sehen. Mit `quit` verlassen Sie **gdb** wieder.
|
|
||||||
|
|
||||||
3. Wenn Sie `ProcA7.e 2` starten, sendet das Kind das Signal 30 an sich selbst. Was geschieht?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
4. Wenn Sie `ProcA7.e 3` starten, sendet ProcA7.e das Signal SIGABRT (abort) an das Kind: was geschieht in diesem Fall?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
5. Mit `ProcA7.e 4` wird das Kind gestartet und terminiert nach 5 Sekunden. Analysieren Sie wie in ProcA7.e der Lauf- bzw. Exit-Zustand des Kindes abgefragt wird (siehe dazu auch `man 3 exit`).
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.8 Aufgabe 8: Kindprozess als Kopie des Elternprozesses
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
* Verstehen, wie Prozessräume vererbt werden.
|
|
||||||
* Unterschiede zwischen dem Prozessraum von Eltern und Kindern erfahren.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
1. Analysieren Sie Programm `ProcA8_1.c`: was gibt das Programm aus?
|
|
||||||
* Starten Sie `ProcA8_1.e `und überprüfen Sie Ihre Überlegungen.
|
|
||||||
* Waren Ihre Überlegungen richtig? Falls nicht, was könnten Sie falsch überlegt haben?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
2. Analysieren Sie Programm `ProcA8_2.c`: was gibt das Programm aus?
|
|
||||||
* Starten Sie `ProcA8_2.e` und überprüfen Sie Ihre Überlegungen.
|
|
||||||
* Waren Ihre Überlegungen richtig? Falls nicht, was könnten Sie falsch gemacht haben?
|
|
||||||
* Kind und Eltern werden in verschiedener Reihenfolge ausgeführt: ist ein Unterschied ausser der Reihenfolge festzustellen?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
3. Analysieren Sie Programm `ProcA8_3.c` und Überlegen Sie, was in die Datei `AnyOutPut.txt` geschrieben wird, wer schreibt alles in diese Datei (sie wird ja vor `fork()` geöffnet) und wieso ist das so?
|
|
||||||
* Starten Sie `ProcA8_3.e` und überprüfen Sie Ihre Überlegungen.
|
|
||||||
* Waren Ihre Überlegungen richtig? Falls nicht, wieso nicht?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.9 Aufgabe 9: Unterschied von Threads gegenüber Prozessen
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
* Den Unterschied zwischen Thread und Prozess kennenlernen.
|
|
||||||
* Problemstellungen um Threads kennenlernen.
|
|
||||||
* Die `pthread`-Implementation kennen lernen.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
1. Studieren Sie Programm `ProcA9.c` und überlegen Sie, wie die Programmausgabe aussieht. Vergleichen Sie Ihre Überlegungen mit denjenigen aus Aufgabe 8.2 b) (`Pro-cA8_2.e`).
|
|
||||||
* Starten Sie `ProcA9.e` und vergleichen das Resultat mit Ihren Überlegungen.
|
|
||||||
* Was ist anders als bei `ProcA8_2.e`?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
2. Setzen Sie in der Thread-Routine vor dem Befehl `pthread_exit()` eine unendliche Schleife ein, z.B. `while(1) { }`; .
|
|
||||||
* Starten Sie das Programm und beobachten Sie das Verhalten mit `top`. Was beobachten Sie und was schliessen Sie daraus?
|
|
||||||
|
|
||||||
**Hinweis:** wenn Sie in `top` den Buchstaben H eingeben, werden die Threads einzeln dargestellt.
|
|
||||||
* Kommentieren Sie im Hauptprogram die beiden `pthread_join()` Aufrufe aus und starten Sie das Programm. Was geschieht? Erklären Sie das Verhalten.
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 3.10 Aufgabe 10 (optional):
|
|
||||||
|
|
||||||
#### 3.10.1 Übersicht
|
|
||||||
Dieser Teil des Praktikums behandelt spezielle Prozesse: die Dämon Prozesse («daemon pro-cesses»). Es ist gedacht als Zusatz zum Basis Praktikum über Prozesse und Threads.
|
|
||||||
|
|
||||||
Auch dieser Teil ist ein «Analyse»- und «Experimentier»-Praktikum.
|
|
||||||
___
|
|
||||||
|
|
||||||
##### 3.10.1.1 Nachweis
|
|
||||||
Dieses Praktikum ist eine leicht abgewandelte Variante des ProcThreads Praktikum des Moduls BSY, angepasst an die Verhältnisse des SNP Moduls. Die Beispiele und Beschreibungen wurden, wo möglich, eins-zu-ein übernommen.
|
|
||||||
|
|
||||||
Als Autoren des BSY Praktikums sind genannt: M. Thaler, J. Zeman.
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
#### 3.10.2 Lernziele
|
|
||||||
In diesem Praktikum werden Sie sich mit Dämon Prozessen beschäftigen.
|
|
||||||
* Sie können die Problemstellung der Dämon Prozesse erklären
|
|
||||||
* Sie können einen Dämon Prozess kreieren
|
|
||||||
* Sie können aus dem Dämon Prozess mit der Umgebung kommunizieren
|
|
||||||
*
|
|
||||||
___
|
|
||||||
|
|
||||||
#### 3.10.3 Aufgabe: Dämon Prozesse
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
* Problemstellungen um Daemons kennenlernen:
|
|
||||||
* wie wird ein Prozess zum Daemon?
|
|
||||||
* wie erreicht man, dass nur ein Daemon vom gleichen Typ aktiv ist?
|
|
||||||
* wie teilt sich ein Daemon seiner Umwelt mit?
|
|
||||||
* wo "lebt" ein Daemon?
|
|
||||||
|
|
||||||
**Einleitung**
|
|
||||||
|
|
||||||
Für diese Aufgabe haben wir einen Daemon implementiert: **MrTimeDaemon** gibt auf Anfrage die Systemzeit Ihres Rechners bekannt. Abfragen können Sie diese Zeit mit dem Programm `WhatsTheTimeMr localhost`. Die Kommunikation zwischen den beiden Prozessen haben wir mit TCP/IP Sockets implementiert. Weitere Infos zum Daemon finden Sie nach den Aufgaben.
|
|
||||||
|
|
||||||
Im Abschnitt 4 finden Sie Zusatzinformationen über diese Implementation eines Dämon Prozesses plus weiterführende Informationen.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
|
|
||||||
1. Für die folgende Aufgabe benötigen Sie mindestens zwei Fenster (Kommandozeilen-Konsolen). Übersetzen Sie die Programme mit `make` und starten Sie das Programm **PlapperMaul** in einem der Fenster. Das Programm schreibt (ca.) alle 0.5 Sekunden *Hallo, ich bins.... Pidi* plus seine Prozess-ID auf den Bildschirm. Mit dem Shell Befehl `ps` können Sie Ihre aktiven Prozesse auflisten, auch **PlapperMaul**. Überlegen Sie sich zuerst, was mit **PlapperMaul** geschieht, wenn Sie das Fenster schliessen: läuft **PlapperMaul** weiter? Was geschieht mit **PlapperMaul** wenn Sie sich ausloggen und wieder einloggen? Testen Sie Ihre Überlegungen, in dem Sie die entsprechenden Aktionen durchführen. Stimmen Ihre Überlegungen?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Starten Sie nun das Programm bzw. den Daemon **MrTimeDaemon**. Stellen Sie die gleichen Überlegungen an wie mit **PlapperMaul** und testen Sie wiederum, ob Ihre Überlegungen stimmen. Ob **MrTimeDaemon** noch läuft können Sie feststellen, indem Sie die Zeit abfragen oder den Befehl `ps ajx | grep MrTimeDaemon` eingeben: was fällt Ihnen am Output auf? Was schliessen Sie aus Ihren Beobachtungen?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Starten Sie **MrTimeDaemon** erneut, was geschieht?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
4. Stoppen Sie nun **MrTimeDaemon** mit `killall MrTimeDaemon`.
|
|
||||||
5. Starten Sie **MrTimeDaemon** und fragen Sie mit `WhatsTheTimeMr localhost` oder mit `WhatsTheTimeMr 127.0.0.1` die aktuelle Zeit auf Ihrem Rechner ab.
|
|
||||||
|
|
||||||
|
|
||||||
**Optional:**
|
|
||||||
Fragen Sie die Zeit bei einem Ihrer Kollegen ab. Dazu muss beim Server (dort wo **MrTimeDaemon** läuft) ev. die Firewall angepasst werden. Folgende Befehle müssen dazu mit **root-Privilegien** ausgeführt werden:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
iptables-save > myTables.txt # sichert die aktuelle Firewall
|
|
||||||
iptables -I INPUT 1 -p tcp --dport 65534 -j ACCEPT
|
|
||||||
iptables -I OUTPUT 2 -p tcp --sport 65534 -j ACCEPT
|
|
||||||
```
|
|
||||||
|
|
||||||
Nun sollten Sie über die IP-Nummer oder über den Rechner-Namen auf den **TimeServer** mit `WhatsTheTimeMr` zugreifen können.
|
|
||||||
Die Firewall können Sie mit folgendem Befehl wiederherstellen:
|
|
||||||
```bash
|
|
||||||
iptables-restore myTables.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
6. Studieren Sie `MrTimeDaemon.c`, `Daemonizer.c` und `TimeDaemon.c` und analysieren Sie, wie die Daemonisierung abläuft. Entfernen Sie die Kommentare im Macro `Out-PutPIDs` am Anfang des Moduls `Daemonizer.c`. Übersetzen Sie die Programme mit make und starten Sie `MrTimeDaemon` erneut. Analysieren Sie die Ausgabe, was fällt Ihnen auf? Notieren Sie alle für die vollständige Daemonisierung notwendigen Schritte.
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
7. Setzen Sie beim Aufruf von `Daemonizer()` in `MrTimeDaemon.c` anstelle von `lock-FilePath` den Null-Zeiger `NULL` ein. Damit wird keine lock-Datei erzeugt. Übersetzen Sie die Programme und starten Sie erneut `MrTimedaemon`. Was geschieht bzw. wie können Sie feststellen, was geschehen ist?
|
|
||||||
|
|
||||||
**Hinweis:** lesen Sie das log-File: `/tmp/timeDaemon.log.`
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
Wenn Sie noch Zeit und Lust haben: messen Sie die Zeit, zwischen Start der Zeitanfrage und Eintreffen der Antwort. Dazu müssen Sie die Datei `WhatsTheTimeMr.c` entsprechend anpassen.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
#### 3.10.4 Zusatzinformationen
|
|
||||||
___
|
|
||||||
|
|
||||||
##### 3.10.4.1 Diese Implementation
|
|
||||||
|
|
||||||
Dieser Daemon besteht aus den 3 Komponenten.
|
|
||||||
|
|
||||||
**Hauptprogramm: MrTimeDaemon.c**
|
|
||||||
|
|
||||||
Hier werden die Pfade für die lock-Datei, die log-Datei und der ”Aufenthaltsort” des Daemons gesetzt. Die lock-Datei wird benötigt um sicherzustellen, dass der Daemon nur einmal gestartet werden kann. In die lock-Datei schreibt der Daemon z.B. seine PID und sperrt sie dann für Schreiben. Wird der Daemon ein zweites Mal gestartet und will seine PID in diese Datei schreiben, erhält er eine Fehlermeldung und terminiert (es soll ja nur ein Daemon arbeiten). Terminiert der Daemon, wird die Datei automatisch freigegeben. Weil Daemonen sämtliche Kontakte mit ihrer Umwelt im Normalfall abbrechen und auch kein Kontrollterminal besitzen, ist es sinnvoll, zumindest die Ausgabe des Daemons in eine log-Datei umzuleiten. Dazu stehen einige Systemfunktionen für Logging zur Verfügung. Der Einfachheit halber haben wir hier eine normale Datei im Verzeichnis `/tmp` gewählt.
|
|
||||||
|
|
||||||
> **Anmerkung:** die Wahl des Verzeichnisses `/tmp` für die lock- und log-Datei ist für den normalen Betrieb problematisch, weil der Inhalt dieses Verzeichnisses jederzeit gelöscht werden kann, bzw. darf. Wir haben dieses Verzeichnis gewählt, weil wir die beiden Dateien nur für die kurze Zeit des Praktikums benötigen.
|
|
||||||
|
|
||||||
Der Daemon erbt sein Arbeitsverzeichnis vom Elternprozesse, er sollte deshalb in ein festes Verzeichnis des Systems wechseln, um zu verhindern, dass er sich in einem montierten (gemounteten) Verzeichnis aufhält, das dann beim Herunterfahren nicht demontiert werden könnte (wir haben hier wiederum `/tmp` gewählt).
|
|
||||||
|
|
||||||
**Daemonizer: Daemonizer.c**
|
|
||||||
|
|
||||||
Der Daemonizer macht aus dem aktuellen Prozess einen Daemon. Z.B. sollte er Signale (eine Art Softwareinterrupts) ignorieren: wenn Sie die CTRL-C Taste während dem Ausführen eines Vordergrundprozess drücken, erhält dieser vom Betriebssystem das Signal SIGINT und bricht seine Ausführung ab. Weiter sollte er die Dateierzeugungsmaske auf 0 setzen (Dateizugriffsrechte), damit kann er beim Öffnen von Dateien beliebige Zugriffsrechte verlangen (die Dateierzeugungsmaske erbt er vom Elternprozess). Am Schluss startet der Daemonizer das eigentliche Daemonprogramm: TimeDaemon.e.
|
|
||||||
|
|
||||||
**Daemonprogramm: TimeDaemon.c**
|
|
||||||
|
|
||||||
Das Daemonprogramm wartet in einer unendlichen Schleife auf Anfragen zur Zeit und schickt die Antwort an den Absender zurück. Die Datenkommunikation ist, wie schon erwähnt, mit Sockets implementiert, auf die wir aber im Rahmen dieses Praktikums nicht weiter eingehen wollen (wir stellen lediglich Hilfsfunktionen zur Verfügung).
|
|
||||||
___
|
|
||||||
|
|
||||||
##### 3.10.4.2 Zusatzinformation zu Dämon Prozessen
|
|
||||||
|
|
||||||
Dämonen oder englisch Daemons sind eine spezielle Art von Prozessen, die vollständig unabhängig arbeiten, d.h. ohne direkte Interaktion mit dem Anwender. Dämonen sind Hintergrundprozesse und terminieren i.A. nur, wenn das System heruntergefahren wird oder abstürzt. Dämonen erledigen meist Aufgaben, die periodisch ausgeführt werden müssen, z.B. Überwachung von Systemkomponenten, abfragen, ob neue Mails angekommen sind, etc.
|
|
||||||
|
|
||||||
Ein typisches Beispiel unter Unix ist der Printer Daemon `lpd`, der periodisch nachschaut, ob ein Anwender eine Datei zum Ausdrucken hinterlegt hat. Wenn ja, schickt er die Datei auf den Drucker.
|
|
||||||
|
|
||||||
Hier wird eine weitere Eigenschaft von Daemons ersichtlich: meist kann nur ein Dämon pro Aufgabe aktiv sein: stellen Sie sich vor, was passiert, wenn zwei Druckerdämonen gleichzeitig arbeiten. Andererseits muss aber auch dafür gesorgt werden, dass ein Dämon wieder gestartet wird, falls er stirbt.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 4. Bewertung
|
|
||||||
|
|
||||||
Die gegebenenfalls gestellten Theorieaufgaben und der funktionierende Programmcode müssen der Praktikumsbetreuung gezeigt werden. Die Lösungen müssen mündlich erklärt werden.
|
|
||||||
|
|
||||||
| Aufgabe | Kriterium | Punkte |
|
|
||||||
| :-- | :-- | :-- |
|
|
||||||
| | Sie können die gestellten Fragen erklären. | |
|
|
||||||
| 1 | Prozess mit `fork()` erzeugen | 0.5 |
|
|
||||||
| 2 | Prozess mit `fork()` und `exec()`: Programm Image ersetzen | 0.5 |
|
|
||||||
| 3 | Prozesshierarchie analysieren | 0.5 |
|
|
||||||
| 4 | Zeitlicher Ablauf von Prozessen | 0.5 |
|
|
||||||
| 5 | Waisenkinder (Orphan Processes) | 0.5 |
|
|
||||||
| 6 | Terminierte, halbtote Prozesse (Zombies) | 0.5 |
|
|
||||||
| 7 | Auf Terminieren von Kindprozessen warten | 0.5 |
|
|
||||||
| 8 | Kindprozess als Kopie des Elternprozesses | 0.5 |
|
|
||||||
| 9 | Unterschied von Threads gegenüber Prozessen | 0.5 |
|
|
||||||
| 10 | Dämon Prozesse | (4) |
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
Version: 11.01.2022
|
|
||||||
|
|
@ -1,149 +0,0 @@
|
||||||
# 09/02 - Dämon Prozesse
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 1. Übersicht
|
|
||||||
Dieser Teil des Praktikums behandelt spezielle Prozesse: die Dämon Prozesse («daemon pro-cesses»). Es ist gedacht als Zusatz zum Basis Praktikum über Prozesse und Threads.
|
|
||||||
|
|
||||||
Auch dieser Teil ist ein «Analyse»- und «Experimentier»-Praktikum.
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
### 1.1 Nachweis
|
|
||||||
Dieses Praktikum ist eine leicht abgewandelte Variante des ProcThreads Praktikum des Moduls BSY, angepasst an die Verhältnisse des SNP Moduls. Die Beispiele und Beschreibungen wurden, wo möglich, eins-zu-ein übernommen.
|
|
||||||
|
|
||||||
Als Autoren des BSY Praktikums sind genannt: M. Thaler, J. Zeman.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 2. Lernziele
|
|
||||||
In diesem Praktikum werden Sie sich mit Dämon Prozessen beschäftigen.
|
|
||||||
* Sie können die Problemstellung der Dämon Prozesse erklären
|
|
||||||
* Sie können einen Dämon Prozess kreieren
|
|
||||||
* Sie können aus dem Dämon Prozess mit der Umgebung kommunizieren
|
|
||||||
*
|
|
||||||
___
|
|
||||||
|
|
||||||
## 3. Aufgabe: Dämon Prozesse
|
|
||||||
|
|
||||||
**Ziele**
|
|
||||||
* Problemstellungen um Daemons kennenlernen:
|
|
||||||
* wie wird ein Prozess zum Daemon?
|
|
||||||
* wie erreicht man, dass nur ein Daemon vom gleichen Typ aktiv ist?
|
|
||||||
* wie teilt sich ein Daemon seiner Umwelt mit?
|
|
||||||
* wo "lebt" ein Daemon?
|
|
||||||
|
|
||||||
**Einleitung**
|
|
||||||
|
|
||||||
Für diese Aufgabe haben wir einen Daemon implementiert: **MrTimeDaemon** gibt auf Anfrage die Systemzeit Ihres Rechners bekannt. Abfragen können Sie diese Zeit mit dem Programm `WhatsTheTimeMr localhost`. Die Kommunikation zwischen den beiden Prozessen haben wir mit TCP/IP Sockets implementiert. Weitere Infos zum Daemon finden Sie nach den Aufgaben.
|
|
||||||
|
|
||||||
Im Abschnitt 4 finden Sie Zusatzinformationen über diese Implementation eines Dämon Prozesses plus weiterführende Informationen.
|
|
||||||
|
|
||||||
**Aufgaben**
|
|
||||||
|
|
||||||
1. Für die folgende Aufgabe benötigen Sie mindestens zwei Fenster (Kommandozeilen-Konsolen). Übersetzen Sie die Programme mit `make` und starten Sie das Programm **PlapperMaul** in einem der Fenster. Das Programm schreibt (ca.) alle 0.5 Sekunden *Hallo, ich bins.... Pidi* plus seine Prozess-ID auf den Bildschirm. Mit dem Shell Befehl `ps` können Sie Ihre aktiven Prozesse auflisten, auch **PlapperMaul**. Überlegen Sie sich zuerst, was mit **PlapperMaul** geschieht, wenn Sie das Fenster schliessen: läuft **PlapperMaul** weiter? Was geschieht mit **PlapperMaul** wenn Sie sich ausloggen und wieder einloggen? Testen Sie Ihre Überlegungen, in dem Sie die entsprechenden Aktionen durchführen. Stimmen Ihre Überlegungen?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Starten Sie nun das Programm bzw. den Daemon **MrTimeDaemon**. Stellen Sie die gleichen Überlegungen an wie mit **PlapperMaul** und testen Sie wiederum, ob Ihre Überlegungen stimmen. Ob **MrTimeDaemon** noch läuft können Sie feststellen, indem Sie die Zeit abfragen oder den Befehl `ps ajx | grep MrTimeDaemon` eingeben: was fällt Ihnen am Output auf? Was schliessen Sie aus Ihren Beobachtungen?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
3. Starten Sie **MrTimeDaemon** erneut, was geschieht?
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
4. Stoppen Sie nun **MrTimeDaemon** mit `killall MrTimeDaemon`.
|
|
||||||
5. Starten Sie **MrTimeDaemon** und fragen Sie mit `WhatsTheTimeMr localhost` oder mit `WhatsTheTimeMr 127.0.0.1` die aktuelle Zeit auf Ihrem Rechner ab.
|
|
||||||
|
|
||||||
|
|
||||||
**Optional:**
|
|
||||||
Fragen Sie die Zeit bei einem Ihrer Kollegen ab. Dazu muss beim Server (dort wo **MrTimeDaemon** läuft) ev. die Firewall angepasst werden. Folgende Befehle müssen dazu mit **root-Privilegien** ausgeführt werden:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
iptables-save > myTables.txt # sichert die aktuelle Firewall
|
|
||||||
iptables -I INPUT 1 -p tcp --dport 65534 -j ACCEPT
|
|
||||||
iptables -I OUTPUT 2 -p tcp --sport 65534 -j ACCEPT
|
|
||||||
```
|
|
||||||
|
|
||||||
Nun sollten Sie über die IP-Nummer oder über den Rechner-Namen auf den **TimeServer** mit `WhatsTheTimeMr` zugreifen können.
|
|
||||||
Die Firewall können Sie mit folgendem Befehl wiederherstellen:
|
|
||||||
```bash
|
|
||||||
iptables-restore myTables.txt
|
|
||||||
```
|
|
||||||
|
|
||||||
6. Studieren Sie `MrTimeDaemon.c`, `Daemonizer.c` und `TimeDaemon.c` und analysieren Sie, wie die Daemonisierung abläuft. Entfernen Sie die Kommentare im Macro `Out-PutPIDs` am Anfang des Moduls `Daemonizer.c`. Übersetzen Sie die Programme mit make und starten Sie `MrTimeDaemon` erneut. Analysieren Sie die Ausgabe, was fällt Ihnen auf? Notieren Sie alle für die vollständige Daemonisierung notwendigen Schritte.
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
7. Setzen Sie beim Aufruf von `Daemonizer()` in `MrTimeDaemon.c` anstelle von `lock-FilePath` den Null-Zeiger `NULL` ein. Damit wird keine lock-Datei erzeugt. Übersetzen Sie die Programme und starten Sie erneut `MrTimedaemon`. Was geschieht bzw. wie können Sie feststellen, was geschehen ist?
|
|
||||||
|
|
||||||
**Hinweis:** lesen Sie das log-File: `/tmp/timeDaemon.log.`
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
Wenn Sie noch Zeit und Lust haben: messen Sie die Zeit, zwischen Start der Zeitanfrage und Eintreffen der Antwort. Dazu müssen Sie die Datei `WhatsTheTimeMr.c` entsprechend anpassen.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 4. Zusatzinformationen
|
|
||||||
___
|
|
||||||
|
|
||||||
### 4.1 Diese Implementation
|
|
||||||
|
|
||||||
Dieser Daemon besteht aus den 3 Komponenten.
|
|
||||||
|
|
||||||
**Hauptprogramm: MrTimeDaemon.c**
|
|
||||||
|
|
||||||
Hier werden die Pfade für die lock-Datei, die log-Datei und der ”Aufenthaltsort” des Daemons gesetzt. Die lock-Datei wird benötigt um sicherzustellen, dass der Daemon nur einmal gestartet werden kann. In die lock-Datei schreibt der Daemon z.B. seine PID und sperrt sie dann für Schreiben. Wird der Daemon ein zweites Mal gestartet und will seine PID in diese Datei schreiben, erhält er eine Fehlermeldung und terminiert (es soll ja nur ein Daemon arbeiten). Terminiert der Daemon, wird die Datei automatisch freigegeben. Weil Daemonen sämtliche Kontakte mit ihrer Umwelt im Normalfall abbrechen und auch kein Kontrollterminal besitzen, ist es sinnvoll, zumindest die Ausgabe des Daemons in eine log-Datei umzuleiten. Dazu stehen einige Systemfunktionen für Logging zur Verfügung. Der Einfachheit halber haben wir hier eine normale Datei im Verzeichnis `/tmp` gewählt.
|
|
||||||
|
|
||||||
> **Anmerkung:** die Wahl des Verzeichnisses `/tmp` für die lock- und log-Datei ist für den normalen Betrieb problematisch, weil der Inhalt dieses Verzeichnisses jederzeit gelöscht werden kann, bzw. darf. Wir haben dieses Verzeichnis gewählt, weil wir die beiden Dateien nur für die kurze Zeit des Praktikums benötigen.
|
|
||||||
|
|
||||||
Der Daemon erbt sein Arbeitsverzeichnis vom Elternprozesse, er sollte deshalb in ein festes Verzeichnis des Systems wechseln, um zu verhindern, dass er sich in einem montierten (gemounteten) Verzeichnis aufhält, das dann beim Herunterfahren nicht demontiert werden könnte (wir haben hier wiederum `/tmp` gewählt).
|
|
||||||
|
|
||||||
**Daemonizer: Daemonizer.c**
|
|
||||||
|
|
||||||
Der Daemonizer macht aus dem aktuellen Prozess einen Daemon. Z.B. sollte er Signale (eine Art Softwareinterrupts) ignorieren: wenn Sie die CTRL-C Taste während dem Ausführen eines Vordergrundprozess drücken, erhält dieser vom Betriebssystem das Signal SIGINT und bricht seine Ausführung ab. Weiter sollte er die Dateierzeugungsmaske auf 0 setzen (Dateizugriffsrechte), damit kann er beim Öffnen von Dateien beliebige Zugriffsrechte verlangen (die Dateierzeugungsmaske erbt er vom Elternprozess). Am Schluss startet der Daemonizer das eigentliche Daemonprogramm: TimeDaemon.e.
|
|
||||||
|
|
||||||
**Daemonprogramm: TimeDaemon.c**
|
|
||||||
|
|
||||||
Das Daemonprogramm wartet in einer unendlichen Schleife auf Anfragen zur Zeit und schickt die Antwort an den Absender zurück. Die Datenkommunikation ist, wie schon erwähnt, mit Sockets implementiert, auf die wir aber im Rahmen dieses Praktikums nicht weiter eingehen wollen (wir stellen lediglich Hilfsfunktionen zur Verfügung).
|
|
||||||
___
|
|
||||||
|
|
||||||
### 4.2 Zusatzinformation zu Dämon Prozessen
|
|
||||||
|
|
||||||
Dämonen oder englisch Daemons sind eine spezielle Art von Prozessen, die vollständig unabhängig arbeiten, d.h. ohne direkte Interaktion mit dem Anwender. Dämonen sind Hintergrundprozesse und terminieren i.A. nur, wenn das System heruntergefahren wird oder abstürzt. Dämonen erledigen meist Aufgaben, die periodisch ausgeführt werden müssen, z.B. Überwachung von Systemkomponenten, abfragen, ob neue Mails angekommen sind, etc.
|
|
||||||
|
|
||||||
Ein typisches Beispiel unter Unix ist der Printer Daemon `lpd`, der periodisch nachschaut, ob ein Anwender eine Datei zum Ausdrucken hinterlegt hat. Wenn ja, schickt er die Datei auf den Drucker.
|
|
||||||
|
|
||||||
Hier wird eine weitere Eigenschaft von Daemons ersichtlich: meist kann nur ein Dämon pro Aufgabe aktiv sein: stellen Sie sich vor, was passiert, wenn zwei Druckerdämonen gleichzeitig arbeiten. Andererseits muss aber auch dafür gesorgt werden, dass ein Dämon wieder gestartet wird, falls er stirbt.
|
|
||||||
|
|
||||||
___
|
|
||||||
|
|
||||||
## 5. Bewertung
|
|
||||||
|
|
||||||
Die gegebenenfalls gestellten Theorieaufgaben und der funktionierende Programmcode müssen der Praktikumsbetreuung gezeigt werden. Die Lösungen müssen mündlich erklärt werden.
|
|
||||||
|
|
||||||
| Aufgabe | Kriterium | Punkte |
|
|
||||||
| :-- | :-- | :-- |
|
|
||||||
| | Sie können die gestellten Fragen erklären. | |
|
|
||||||
| 1 | Dämon Prozesse | 4 |
|
|
||||||
|
|
||||||
|
|
||||||
___
|
|
||||||
Version: 11.01.2022
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 56 KiB |
File diff suppressed because one or more lines are too long
|
Before Width: | Height: | Size: 79 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 212 KiB |
File diff suppressed because one or more lines are too long
|
Before Width: | Height: | Size: 140 KiB |
|
|
@ -1,178 +0,0 @@
|
||||||
/******************************************************************************
|
|
||||||
* File: Daemonizer.c
|
|
||||||
* Original Autor: M. Thaler (Modul BSY)
|
|
||||||
* Aufgabe: Einen Daemon-Prozess erzeugen
|
|
||||||
******************************************************************************/
|
|
||||||
|
|
||||||
#include <sys/types.h>
|
|
||||||
#include <sys/stat.h>
|
|
||||||
#include <fcntl.h>
|
|
||||||
#include <unistd.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <string.h>
|
|
||||||
#include <signal.h>
|
|
||||||
#include <errno.h>
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
// Macro to write out all the PIDs...
|
|
||||||
|
|
||||||
#define OutPutPIDs() /*printf("\nPID %d, PPID %d, GRP-ID %d\n", \
|
|
||||||
getpid(), getppid(), getpgrp())*/
|
|
||||||
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// Function: Locks file with file descriptor fd
|
|
||||||
// Returns: 0 on success, -1 of file is already locked
|
|
||||||
// Exits: on fatal errors
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
int lock(int fd) {
|
|
||||||
int retval, len;
|
|
||||||
struct flock lock; // data structure for file lock
|
|
||||||
char buffer[16];
|
|
||||||
|
|
||||||
// prepare lockfile
|
|
||||||
|
|
||||||
lock.l_type = F_WRLCK;
|
|
||||||
lock.l_start = 0;
|
|
||||||
lock.l_whence = SEEK_SET;
|
|
||||||
lock.l_len = 0;
|
|
||||||
|
|
||||||
retval = fcntl(fd, F_SETLK, &lock); // set file lock
|
|
||||||
if (retval < 0) {
|
|
||||||
if ((errno == EACCES) || (errno == EAGAIN)) {
|
|
||||||
return(-1); // Daemon already runs
|
|
||||||
}
|
|
||||||
else {
|
|
||||||
perror("fatal error when locking file");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// empty the lockfile
|
|
||||||
|
|
||||||
retval = ftruncate(fd, 0);
|
|
||||||
if (retval < 0) {
|
|
||||||
perror("fatal error when emptying lockfile");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
|
|
||||||
// write process ID to lockfile
|
|
||||||
|
|
||||||
sprintf(buffer, "%d\n", getpid());
|
|
||||||
len = strlen(buffer);
|
|
||||||
retval = write(fd, buffer, len) < len;
|
|
||||||
if (retval < 0) {
|
|
||||||
perror("fatal error when writing pid to lockfile");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
|
|
||||||
// set lockfile to close on exec
|
|
||||||
|
|
||||||
retval = fcntl(fd, F_GETFD, 0);
|
|
||||||
if (retval < 0) {
|
|
||||||
perror("fatal error when reading lockfile flags");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
retval = retval | FD_CLOEXEC;
|
|
||||||
retval = fcntl(fd, F_SETFD, retval);
|
|
||||||
if (retval < 0) {
|
|
||||||
perror("fatal error when setting lockfile flags");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
return(0);
|
|
||||||
}
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// Function: Makes a deamon process and runs a daemon function
|
|
||||||
// Parameter: Daemon function
|
|
||||||
// data pointer to data to be passed to Daemonfunction
|
|
||||||
// LogFile, path of logfile, if NULL, no logfile is created
|
|
||||||
// LivDir, path, where daemon will live
|
|
||||||
// Returns: should not return
|
|
||||||
// Exits: if daemon is already runnung or on fatal errors
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
int Daemonizer(void Daemon(void *), void *data,
|
|
||||||
const char *LockFile, const char *LogFile, const char *LivDir) {
|
|
||||||
|
|
||||||
pid_t PID;
|
|
||||||
int fd, dummyfd, retval;
|
|
||||||
|
|
||||||
// create a prozess and terminate parents -> parent is init
|
|
||||||
|
|
||||||
OutPutPIDs();
|
|
||||||
|
|
||||||
PID = fork();
|
|
||||||
if (PID < 0) {
|
|
||||||
perror("could not fork()");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
else if (PID > 0) {
|
|
||||||
exit(0); // I have done my work an can exit
|
|
||||||
}
|
|
||||||
|
|
||||||
// ----------------------------------------------------------------------
|
|
||||||
// now I am a process detached from the parent
|
|
||||||
// an make the process -> a daemon process
|
|
||||||
|
|
||||||
signal(SIGINT, SIG_IGN); // ignore CTRL-C
|
|
||||||
signal(SIGQUIT, SIG_IGN); // ignore quit
|
|
||||||
signal(SIGHUP, SIG_IGN); // ignore hangup of terminal
|
|
||||||
|
|
||||||
OutPutPIDs();
|
|
||||||
|
|
||||||
setsid(); // make process session leader
|
|
||||||
// and processgroup leader
|
|
||||||
// no control terminal with pocess
|
|
||||||
OutPutPIDs();
|
|
||||||
|
|
||||||
chdir(LivDir); // change to secure directory
|
|
||||||
umask(0); // allow all access rights for files
|
|
||||||
|
|
||||||
// set up lockfile, if required
|
|
||||||
|
|
||||||
if (LockFile != NULL) {
|
|
||||||
fd = open(LockFile, O_WRONLY | O_CREAT, S_IRUSR | S_IWUSR |
|
|
||||||
S_IRGRP | S_IROTH);
|
|
||||||
if (fd < 0) {
|
|
||||||
perror("fatal error when opening lockfile");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
retval = lock(fd);
|
|
||||||
if (retval < 0) {
|
|
||||||
printf("\n*** daemon is already running ***\n");
|
|
||||||
exit(0);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// last message from daemon
|
|
||||||
|
|
||||||
printf("\n*** daemon starts with process id: %d ***\n",getpid());
|
|
||||||
|
|
||||||
// close "communication" to outer world and set up logging, if required
|
|
||||||
|
|
||||||
close(1); // close stdout
|
|
||||||
close(2); // close stderr
|
|
||||||
if (LogFile != NULL) { // open log file on stdout
|
|
||||||
enum {UserWrite=0644};
|
|
||||||
dummyfd = open(LogFile, O_CREAT | O_APPEND | O_WRONLY,UserWrite);
|
|
||||||
if (dummyfd < 0) {
|
|
||||||
perror("could not open log file");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
dup(1); // connect stderr to logfile
|
|
||||||
}
|
|
||||||
close(0); // now close stdin
|
|
||||||
|
|
||||||
// now start the daemon funktion
|
|
||||||
Daemon(data);
|
|
||||||
|
|
||||||
// should not come here
|
|
||||||
|
|
||||||
return(0);
|
|
||||||
}
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
@ -1,15 +0,0 @@
|
||||||
/*********************************************************************
|
|
||||||
* File: Daemonizer.h
|
|
||||||
* Original Autor: M. Thaler (Modul BSY)
|
|
||||||
* Aufgabe: einen Daemon-Prozess erzeugen
|
|
||||||
*********************************************************************/
|
|
||||||
|
|
||||||
#ifndef DAEMONIZER_H
|
|
||||||
#define DAEMONIZER_H
|
|
||||||
|
|
||||||
int Daemonizer(void Daemon(void *), void *data,
|
|
||||||
const char *LockFile, const char *LogFile, const char *LivDir);
|
|
||||||
|
|
||||||
#endif
|
|
||||||
|
|
||||||
//------------------------------------------------------------------------
|
|
||||||
|
|
@ -1,188 +0,0 @@
|
||||||
//*****************************************************************************
|
|
||||||
// ipCom.c IP Socket Functions
|
|
||||||
// Original Author: M. Thaler, M. Pellaton (Modul BSY)
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// system includes
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <string.h>
|
|
||||||
#include <netinet/in.h>
|
|
||||||
#include <sys/types.h>
|
|
||||||
#include <sys/socket.h>
|
|
||||||
#include <unistd.h>
|
|
||||||
#include <netdb.h>
|
|
||||||
|
|
||||||
#include <fcntl.h>
|
|
||||||
#include <errno.h>
|
|
||||||
|
|
||||||
#include <sys/ioctl.h>
|
|
||||||
#include <net/if.h>
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// local definitions
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
#include "IPsockCom.h"
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// Function: send data buffer to host "host" with port "port"
|
|
||||||
// Parameter: hostname or IP address in dot format
|
|
||||||
// port number
|
|
||||||
// buffer
|
|
||||||
// size of buffer
|
|
||||||
// Returns: number of characters read on success, -1 if connection failed
|
|
||||||
// buffer: time data
|
|
||||||
//
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
int getTimeFromServer(char *host, int port, char *buffer, int bufferLen) {
|
|
||||||
|
|
||||||
int sfd, sysRet, timeOut, retval;
|
|
||||||
char stringPort[8];
|
|
||||||
struct addrinfo hints, *aiList, *aiPtr = NULL;
|
|
||||||
|
|
||||||
if (strcmp(host, "") == 0) {
|
|
||||||
printf("Need hostname or IP address\n");
|
|
||||||
return(-1);
|
|
||||||
}
|
|
||||||
|
|
||||||
sprintf(stringPort, "%d", port);
|
|
||||||
|
|
||||||
memset(&hints, '\0', sizeof(hints));
|
|
||||||
//hints.ai_flags = AI_CANONNAME;
|
|
||||||
hints.ai_family = AF_UNSPEC;
|
|
||||||
hints.ai_socktype = SOCK_STREAM;
|
|
||||||
|
|
||||||
sysRet = getaddrinfo(host, stringPort, &hints, &aiList);
|
|
||||||
if (sysRet != 0) {
|
|
||||||
printf("error getting network address for %s (%s)\n",
|
|
||||||
host, gai_strerror(sysRet));
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
|
|
||||||
aiPtr = aiList; // search through list
|
|
||||||
while (aiPtr != 0) {
|
|
||||||
sfd = socket(aiPtr->ai_family, aiPtr->ai_socktype, aiPtr->ai_protocol);
|
|
||||||
if (sfd >= 0) {
|
|
||||||
timeOut = 100;
|
|
||||||
sysRet = 1;
|
|
||||||
while ((timeOut != 0) && (sysRet != 0)) {
|
|
||||||
sysRet = connect(sfd, aiPtr->ai_addr, aiPtr->ai_addrlen);
|
|
||||||
usleep(1000);
|
|
||||||
timeOut--;
|
|
||||||
}
|
|
||||||
if (sysRet == 0)
|
|
||||||
break; // connect successful
|
|
||||||
else
|
|
||||||
close(sfd);
|
|
||||||
}
|
|
||||||
aiPtr = aiPtr->ai_next;
|
|
||||||
}
|
|
||||||
freeaddrinfo(aiList);
|
|
||||||
if (aiPtr == NULL) {
|
|
||||||
printf("could not connect to %s\n", host);
|
|
||||||
retval = -1;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
retval = 0;
|
|
||||||
|
|
||||||
if (retval == 0) {
|
|
||||||
if (write(sfd, buffer, bufferLen) < 0) {
|
|
||||||
printf("error sending request to timer serveer\n");
|
|
||||||
retval = -1;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
retval = read(sfd, buffer, COM_BUF_SIZE);
|
|
||||||
}
|
|
||||||
close(sfd);
|
|
||||||
return(retval);
|
|
||||||
}
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// Function: starts "time" socket server
|
|
||||||
// Parameter: port number to listen to
|
|
||||||
// Returns: socket file descriptor if ok, -1 if error
|
|
||||||
// Exits:
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
int StartTimeServer(int portNumber) {
|
|
||||||
|
|
||||||
int sfd, sysRet, j;
|
|
||||||
char stringPort[8];
|
|
||||||
struct addrinfo hints, *aiList, *aiPtr = NULL;
|
|
||||||
|
|
||||||
sprintf(stringPort, "%d", portNumber); // portnumber to string
|
|
||||||
memset(&hints, '\0', sizeof(hints));
|
|
||||||
hints.ai_family = AF_UNSPEC;
|
|
||||||
hints.ai_socktype = SOCK_STREAM;
|
|
||||||
hints.ai_protocol = 0;
|
|
||||||
hints.ai_flags = AI_PASSIVE;
|
|
||||||
|
|
||||||
sysRet = getaddrinfo(NULL, stringPort, &hints, &aiList);
|
|
||||||
if (sysRet != 0) {
|
|
||||||
printf("error getting network address (%s)\n", gai_strerror(sysRet));
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
|
|
||||||
aiPtr = aiList; // search through list
|
|
||||||
while (aiPtr != 0) {
|
|
||||||
sfd = socket(aiPtr->ai_family, aiPtr->ai_socktype, aiPtr->ai_protocol);
|
|
||||||
if (sfd >= 0) {
|
|
||||||
j = 1;
|
|
||||||
sysRet = setsockopt(sfd, SOL_SOCKET, SO_REUSEADDR, &j, sizeof(j));
|
|
||||||
if (sysRet < 0)
|
|
||||||
perror("cannot set socket options");
|
|
||||||
|
|
||||||
if (bind(sfd, aiPtr->ai_addr, aiPtr->ai_addrlen) < 0) {
|
|
||||||
perror("bind failed ");
|
|
||||||
close(sfd);
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
if (listen(sfd, 5) < 0) {
|
|
||||||
close(sfd);
|
|
||||||
perror("listen failed ");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
else
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
aiPtr = aiPtr->ai_next;
|
|
||||||
}
|
|
||||||
freeaddrinfo(aiList);
|
|
||||||
if (aiPtr == NULL) {
|
|
||||||
printf("could not set up a socket server\n");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
return(sfd);
|
|
||||||
}
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// Function: Reads data from client
|
|
||||||
// Parameter: socket file descriptor
|
|
||||||
// buffer to place data
|
|
||||||
// Returns: current socket descriptor on success, < 0 on failure
|
|
||||||
// Exits: none
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
|
|
||||||
int WaitForClient(int sfd, char *buffer) {
|
|
||||||
|
|
||||||
int cfd, retval, addrlen;
|
|
||||||
struct sockaddr_in addr;
|
|
||||||
|
|
||||||
addrlen = sizeof(struct sockaddr_in);
|
|
||||||
cfd = accept(sfd,(struct sockaddr *)&addr,(socklen_t *)&addrlen);
|
|
||||||
if (cfd >= 0) {
|
|
||||||
retval = read(cfd, buffer, COM_BUF_SIZE);
|
|
||||||
retval = cfd;
|
|
||||||
}
|
|
||||||
else
|
|
||||||
retval = cfd;
|
|
||||||
return(retval);
|
|
||||||
}
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
@ -1,20 +0,0 @@
|
||||||
//*****************************************************************************
|
|
||||||
// ipCom.c IP Socket Functions
|
|
||||||
// Original Autor: M. Thaler, M. Pellaton (Modul BSY)
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
#ifndef IP_COM_SOCKETS
|
|
||||||
#define IP_COM_SOCKETS
|
|
||||||
|
|
||||||
#define COM_BUF_SIZE 512
|
|
||||||
|
|
||||||
#define PIDperror()\
|
|
||||||
fprintf(stderr,"fatal error, daemon with PID %d: ",getpid());
|
|
||||||
|
|
||||||
int getTimeFromServer(char *host, int port, char *buffer, int bufferLen);
|
|
||||||
int StartTimeServer(int PortNumber);
|
|
||||||
int WaitForClient(int sfd, char *buffer);
|
|
||||||
|
|
||||||
#endif
|
|
||||||
|
|
||||||
//***************************************************************************
|
|
||||||
|
|
@ -1,44 +0,0 @@
|
||||||
/*********************************************************************
|
|
||||||
* File: MrTimeDaemon.c
|
|
||||||
* Original Autor: M. Thaler (Modul BSY)
|
|
||||||
* Aufgabe: einen Daemon-Prozess erzeugen
|
|
||||||
*********************************************************************/
|
|
||||||
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <assert.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <unistd.h>
|
|
||||||
#include <sys/wait.h>
|
|
||||||
#include <sys/types.h>
|
|
||||||
|
|
||||||
#include "Daemonizer.h"
|
|
||||||
#include "TimeDaemon.h"
|
|
||||||
|
|
||||||
#define STRING_LENGTH 128
|
|
||||||
|
|
||||||
//--------------------------------------------------------------------
|
|
||||||
|
|
||||||
int main(void) {
|
|
||||||
pid_t pid;
|
|
||||||
int status;
|
|
||||||
const char *lockfilePath = "/tmp/timeDaemon.lock";
|
|
||||||
//const char *lockfilePath = NULL;
|
|
||||||
const char *logfilePath = "/tmp/timeDaemon.log";
|
|
||||||
const char *livingPath = "/tmp";
|
|
||||||
const char *myName = "I am Mr. Time Daemon on \n";
|
|
||||||
|
|
||||||
|
|
||||||
if ((pid = fork()) == 0)
|
|
||||||
Daemonizer(TimeDaemon, (void *)myName,
|
|
||||||
lockfilePath, logfilePath, livingPath);
|
|
||||||
else {
|
|
||||||
assert(pid > 0);
|
|
||||||
wait(&status); // wait for Daemonizer to exit
|
|
||||||
// after having forked the "Daemon"
|
|
||||||
if (WEXITSTATUS(status) != 0)
|
|
||||||
printf("*** Daemonizer failed ***\n");
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
//--------------------------------------------------------------------
|
|
||||||
|
|
@ -1,21 +0,0 @@
|
||||||
/*********************************************************************
|
|
||||||
* File: PlapperMaul.c
|
|
||||||
* Original Autor: M. Thaler (Modul BSY)
|
|
||||||
* Aufgabe: plappern
|
|
||||||
*********************************************************************/
|
|
||||||
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <unistd.h>
|
|
||||||
|
|
||||||
//--------------------------------------------------------------------
|
|
||||||
|
|
||||||
int main(void) {
|
|
||||||
|
|
||||||
while (1) {
|
|
||||||
printf("Hallo, ich bins.... Pidi %d\n", getpid());
|
|
||||||
usleep(500000);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
//--------------------------------------------------------------------
|
|
||||||
|
|
@ -1,75 +0,0 @@
|
||||||
/******************************************************************************
|
|
||||||
* File: TimeDaemon.c
|
|
||||||
* Original Autor: M. Thaler (Modul BSY)
|
|
||||||
* Aufgabe: the daemon code
|
|
||||||
******************************************************************************/
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// system includes
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
#include <stdio.h>
|
|
||||||
#include <stdlib.h>
|
|
||||||
#include <string.h>
|
|
||||||
#include <netinet/in.h>
|
|
||||||
#include <sys/types.h>
|
|
||||||
#include <sys/socket.h>
|
|
||||||
#include <unistd.h>
|
|
||||||
#include <sys/un.h>
|
|
||||||
#include <netdb.h>
|
|
||||||
#include <time.h>
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// local includes
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
#include "TimeDaemon.h"
|
|
||||||
#include "TimeDaemonDefs.h"
|
|
||||||
#include "IPsockCom.h"
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
// Function: TimeDeamon
|
|
||||||
// Parameter: data: expects here pointer to string
|
|
||||||
//*****************************************************************************
|
|
||||||
|
|
||||||
void TimeDaemon(void *data) {
|
|
||||||
|
|
||||||
TimeData tData;
|
|
||||||
char buffer[COM_BUF_SIZE];
|
|
||||||
struct tm MyTime;
|
|
||||||
time_t ActualTime;
|
|
||||||
int sfd, cfd;
|
|
||||||
|
|
||||||
|
|
||||||
printf("%s\n", (char *)data);
|
|
||||||
|
|
||||||
// start server
|
|
||||||
sfd = StartTimeServer(TIME_PORT);
|
|
||||||
if (sfd < 0) {
|
|
||||||
perror("could not start socket server");
|
|
||||||
exit(-1);
|
|
||||||
}
|
|
||||||
while (1) {
|
|
||||||
|
|
||||||
cfd = WaitForClient(sfd, buffer);
|
|
||||||
if ((strcmp(buffer, REQUEST_STRING) == 0) && (cfd >= 0)) {
|
|
||||||
|
|
||||||
time(&ActualTime);
|
|
||||||
MyTime = *localtime(&ActualTime);
|
|
||||||
|
|
||||||
tData.hours = MyTime.tm_hour;
|
|
||||||
tData.minutes = MyTime.tm_min;
|
|
||||||
tData.seconds = MyTime.tm_sec;
|
|
||||||
tData.day = MyTime.tm_mday;
|
|
||||||
tData.month = MyTime.tm_mon + 1;
|
|
||||||
tData.year = MyTime.tm_year + 1900;
|
|
||||||
gethostname(tData.servername, HOST_NAM_LEN);
|
|
||||||
write(cfd, (char *)(&tData), sizeof(tData));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
// if we should somehow come here (how ?)
|
|
||||||
close(sfd);
|
|
||||||
exit(0);
|
|
||||||
}
|
|
||||||
|
|
||||||
//*****************************************************************************
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue