x	Ein beliebiger Parameter. Der Hash-Wert wird aber nur von Zeichenketten mit mindestens einem Zeichen berechnet. Alle anderen Werte liefern die Anzahl der möglichen Hash-Werte.

Beschreibung:

Aus einer Zeichenkette wird ein Hash-Wert berechnet. Der Hash-Algorithmus ist derjenige, der intern für die Analyse der Kommandonamen verwendet wird.

Im Moment werden von MakeDoc die 154 Kommandos auf 256 Hash-Werte aus dem Wertebereich [0..255] abgebildet. Die folgende Tabelle zeigt die aktuellen Zuordnungen:

Hash-Wert	N	Kommandos
0 == 0x00	2	#AUTOLOOKUP #SLEEP
2 == 0x02	1	#COMMENT
4 == 0x04	2	#DB-L-COPYALL #DB-L-MOVEALL
5 == 0x05	1	#UNDEFINE
9 == 0x09	1	#PUNDEFINE
12 == 0x0c	1	#ELIFNOTDEF
14 == 0x0e	2	#FOR #RESTART
18 == 0x12	3	#DB-G-COPYALL #DB-G-MOVEALL #DEF
21 == 0x15	1	#PRINTLOG
22 == 0x16	1	#CALL
25 == 0x19	1	#ECHOLOG
27 == 0x1b	1	#EMPTYLINES
28 == 0x1c	1	#ELIFNDEF
30 == 0x1e	3	#PDEF #REPEAT #RESULT
31 == 0x1f	1	#GENUM
32 == 0x20	1	#DB-LOAD
36 == 0x24	2	#$ #ENDLOOP
39 == 0x27	2	#GENUMBITS #PARAMETERS
41 == 0x29	2	#FAM #FI
42 == 0x2a	1	#DB-GET-DBLIST
44 == 0x2c	2	#END #PUNDEF
45 == 0x2d	1	#PDEFINE
48 == 0x30	1	#PRODUCT
50 == 0x32	1	#UNDEF
53 == 0x35	1	#CLOSE
54 == 0x36	1	#MAKEINDEX
58 == 0x3a	1	#:
59 == 0x3b	1	#COPYIMAGES
60 == 0x3c	2	#DB-P-COPYALL #DB-P-MOVEALL
62 == 0x3e	1	#>
64 == 0x40	1	#MININDENT
65 == 0x41	1	#PARAMS
73 == 0x49	1	#XUNDEFINE
78 == 0x4e	1	#READ
81 == 0x51	2	#CONTINUE #INCLUDE
86 == 0x56	1	#FLUSHALL
87 == 0x57	1	#TABSIZE
88 == 0x58	1	#ELSEIFDEF
92 == 0x5c	1	#EXIT
94 == 0x5e	2	#LOOP #XDEF
95 == 0x5f	1	#VERBOSE
97 == 0x61	1	#ECHO
98 == 0x62	1	#IFUNDEF
99 == 0x63	1	#SOURCE
100 == 0x64	2	#AUTOEXPAND #CATCHLIST
101 == 0x65	1	#ENDWHILE
102 == 0x66	1	#ELIF
104 == 0x68	1	#DOIF
105 == 0x69	1	#LINEMODE
108 == 0x6c	2	#MAXINDENT #XUNDEF
109 == 0x6d	1	#XDEFINE
111 == 0x6f	1	#DB-DELETE
112 == 0x70	1	#IFNOT
114 == 0x72	1	#NOCOMMENT
116 == 0x74	2	#HTML #START
127 == 0x7f	2	#DB-STORE #DEFINE
128 == 0x80	1	#SEVENBIT
132 == 0x84	2	#ELIFNOT #SETINDENT
134 == 0x86	2	#ENDFOR #OUTPUT
142 == 0x8e	1	#LABEL
143 == 0x8f	1	#TEXTMACRO
144 == 0x90	1	#STOP
146 == 0x92	1	#CATCH
148 == 0x94	1	#GUNDEF
149 == 0x95	2	#GDEFINE #MACRO
150 == 0x96	1	#ELIFDEF
151 == 0x97	1	#MESSAGE
154 == 0x9a	2	#CLOSEALL #DB-GET-VARLIST
157 == 0x9d	1	#WARNING
159 == 0x9f	1	#PENUMBITS
163 == 0xa3	1	#ENDW
164 == 0xa4	1	#ENDREPEAT
166 == 0xa6	3	#ELSEIF #ENDR #GDEF
167 == 0xa7	2	#DATE #PENUM
169 == 0xa9	2	#ENUM #GOTO
172 == 0xac	2	#ELIFUNDEF #ENDEACH
175 == 0xaf	1	#BREAK
177 == 0xb1	1	#GUNDEFINE
178 == 0xb2	2	#ENDF #ENDIF
180 == 0xb4	2	#DB-DROP #SETCOMMENT
182 == 0xb6	1	#FOREACH
184 == 0xb8	1	#ENDL
185 == 0xb9	1	#ENDM
187 == 0xbb	1	#LOG
194 == 0xc2	2	#IFDEF #IFNDEF
197 == 0xc5	1	#ELSE
198 == 0xc6	1	#OPEN
200 == 0xc8	1	#ENDFOREACH
201 == 0xc9	1	#WRITE
204 == 0xcc	1	#EXPAND
205 == 0xcd	1	#DEBUG
207 == 0xcf	1	#EXITCODE
208 == 0xd0	1	#INDENT
209 == 0xd1	1	#DB-SAVE
210 == 0xd2	1	#IFNOTDEF
211 == 0xd3	1	#DB-SET-AUTOSAVE
212 == 0xd4	1	#GOSUB
214 == 0xd6	2	#CHAIN #IF
217 == 0xd9	1	#IAM
223 == 0xdf	1	#XENUMBITS
224 == 0xe0	1	#PRINT
225 == 0xe1	1	#CLEARKEYS
227 == 0xe3	1	#DB-STORE-MOVE
231 == 0xe7	1	#XENUM
232 == 0xe8	1	#DB-CLEAR
233 == 0xe9	2	#DB-GET-VARSTATUS #LANGUAGE
237 == 0xed	1	#EXECUTE
239 == 0xef	3	#DB-G-MOVE #DB-L-MOVE #DB-P-MOVE
241 == 0xf1	1	#ENUMBITS
243 == 0xf3	3	#DB-G-COPY #DB-L-COPY #DB-P-COPY
248 == 0xf8	1	#ENDCATCH
250 == 0xfa	3	#DB-G-SWAP #DB-L-SWAP #DB-P-SWAP
251 == 0xfb	1	#DB-GET-AUTOSAVE
253 == 0xfd	1	#WHILE
254 == 0xfe	1	#ERROR
255 == 0xff	1	#ENDMACRO

Zusammenfassende Statistik:

Von 256 möglichen Hash-Werten werden 116 (45%) genutzt. Dabei sind 84 Werte einfach, 26 Werte doppelt und 6 Werte dreifach belegt.
Bei gleicher Wahrscheinlichkeit aller 154 Kommandos werden im Durchschnitt 1.25 Vergleiche für die Suche eines im Hash exisitierendes Kommandos benötigt. 116 Kommandos (75%) werden nach einem Vergleich und 38 Kommandos (25%) nach zwei Vergleichen erkannt.
Bei einem idealen Baum würden im Durchschnitt 6.40 Vergleiche für die Suche eines exisitierendes Kommandos benötigt. Durch die Verwendung des Hash werden also 5.15 Vergleiche je gesuchtem Kommando eingespart.

Funktionsergebnis: INT32

Ist der Parameter x vom Typ STRING und enthält mindestens ein Zeichen, dann wird für diese Zeichenkette der Hash-Wert berechnet. Der Hash-Wert ist aus dem Untervall [0..N[.

N ist dabei die Anzahl der möglichen Hash-Werte. Dieses Anzahl kann ermittelt werden, indem als Parameter x eine Nicht-Zeichenkette oder eine Zeichenkette ohne Zeichen übergeben wird.

Siehe auch:
funcHash()

Weitere ähnliche Funktionen:

Stream-Intern
Funktion	Kurzinfo
cmdHash()	Die interne Hash-Funktion für die Kommando-Analyse aufrufen.
fileAccessMode()	—
funcHash()	Die interne Hash-Funktion für die Funktions-Analyse aufrufen.
getCommandMap()	—
getComment()	—
getConstMap()	Eine Map mit allen vordefinierten Konstanten erzeugen.
getFuncMap()	—
getMacroMap()	—
getObsoleteConstMap()	Eine Map mit allen vordefinierten Konstanten, die obsolete sind, erzeugen.
getOpMap()	—
getStreamFile()	Den Dateinamen eines geöffneten Streams ermitteln.
getStreamInfo()	Informationen eines geöffneten Streams ermitteln.
getVarList()	Eine Liste mit den Namen aller Vaiablen erzeugen.
inclAccessMode()	—
isCommand()	—
isConst()	—
isFunc()	—
isMacro()	—
isVerbose()	Abfrage des Verbose-Modusses.
numOfStreams()	Die Anzahl der geöffneten Streams