2023-08-23 08:44:29 +02:00
<!DOCTYPE html> < html lang = "en" > < head > < meta charset = "utf-8" > < meta name = "viewport" content = "width=device-width, initial-scale=1.0" > < meta name = "generator" content = "rustdoc" > < meta name = "description" content = "Source of the Rust file `C:\Users\zenn\.cargo\registry\src\index.crates.io-6f17d22bba15001f\hash32-0.2.1\src\lib.rs`." > < title > lib.rs - source< / title > < link rel = "preload" as = "font" type = "font/woff2" crossorigin href = "../../static.files/SourceSerif4-Regular-46f98efaafac5295.ttf.woff2" > < link rel = "preload" as = "font" type = "font/woff2" crossorigin href = "../../static.files/FiraSans-Regular-018c141bf0843ffd.woff2" > < link rel = "preload" as = "font" type = "font/woff2" crossorigin href = "../../static.files/FiraSans-Medium-8f9a781e4970d388.woff2" > < link rel = "preload" as = "font" type = "font/woff2" crossorigin href = "../../static.files/SourceCodePro-Regular-562dcc5011b6de7d.ttf.woff2" > < link rel = "preload" as = "font" type = "font/woff2" crossorigin href = "../../static.files/SourceSerif4-Bold-a2c9cd1067f8b328.ttf.woff2" > < link rel = "preload" as = "font" type = "font/woff2" crossorigin href = "../../static.files/SourceCodePro-Semibold-d899c5a5c4aeb14a.ttf.woff2" > < link rel = "stylesheet" href = "../../static.files/normalize-76eba96aa4d2e634.css" > < link rel = "stylesheet" href = "../../static.files/rustdoc-cb6f1f67f1bcd037.css" id = "mainThemeStyle" > < meta name = "rustdoc-vars" data-root-path = "../../" data-static-root-path = "../../static.files/" data-current-crate = "hash32" data-themes = "" data-resource-suffix = "" data-rustdoc-version = "1.73.0-nightly (8131b9774 2023-08-02)" data-channel = "nightly" data-search-js = "search-6dfdfced5eff6596.js" data-settings-js = "settings-de11bff964e9d4e5.js" data-settings-css = "settings-8c76f75bfb6bd192.css" data-theme-light-css = "light-6d2c9675f3d09c26.css" data-theme-dark-css = "dark-45ceb8f2e522f4d1.css" data-theme-ayu-css = "ayu-fd19013d6ce078bf.css" > < script src = "../../static.files/storage-db41da1a38ea3cb8.js" > < / script > < script defer src = "../../static.files/src-script-3280b574d94e47b4.js" > < / script > < script defer src = "../../src-files.js" > < / script > < script defer src = "../../static.files/main-0795b7d26be81095.js" > < / script > < noscript > < link rel = "stylesheet" media = "(prefers-color-scheme:light)" href = "../../static.files/light-6d2c9675f3d09c26.css" > < link rel = "stylesheet" media = "(prefers-color-scheme:dark)" href = "../../static.files/dark-45ceb8f2e522f4d1.css" > < link rel = "stylesheet" href = "../../static.files/noscript-cffde32267a19fd6.css" > < / noscript > < link rel = "alternate icon" type = "image/png" href = "../../static.files/favicon-16x16-8b506e7a72182f1c.png" > < link rel = "alternate icon" type = "image/png" href = "../../static.files/favicon-32x32-422f7d1d52889060.png" > < link rel = "icon" type = "image/svg+xml" href = "../../static.files/favicon-2c020d218678b618.svg" > < / head > < body class = "rustdoc src" > <!-- [if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif] --> < nav class = "sidebar" > < / nav > < main > < nav class = "sub" > < a class = "sub-logo-container" href = "../../hash32/index.html" > < img class = "rust-logo" src = "../../static.files/rust-logo-151179464ae7ed46.svg" alt = "logo" > < / a > < form class = "search-form" > < span > < / span > < input class = "search-input" name = "search" aria-label = "Run search in the documentation" autocomplete = "off" spellcheck = "false" placeholder = "Click or press ‘ ’ ‘ ’ type = "search" > < div id = "help-button" title = "help" tabindex = "-1" > < a href = "../../help.html" > ?< / a > < / div > < div id = "settings-menu" tabindex = "-1" > < a href = "../../settings.html" title = "settings" > < img width = "22" height = "22" alt = "Change settings" src = "../../static.files/wheel-7b819b6101059cd0.svg" > < / a > < / div > < / form > < / nav > < section id = "main-content" class = "content" > < div class = "example-wrap" > < div data-nosnippet > < pre class = "src-line-numbers" > < a href = "#1" id = "1" > 1< / a >
2023-08-19 19:14:32 +02:00
< a href = "#2" id = "2" > 2< / a >
< a href = "#3" id = "3" > 3< / a >
< a href = "#4" id = "4" > 4< / a >
< a href = "#5" id = "5" > 5< / a >
< a href = "#6" id = "6" > 6< / a >
< a href = "#7" id = "7" > 7< / a >
< a href = "#8" id = "8" > 8< / a >
< a href = "#9" id = "9" > 9< / a >
< a href = "#10" id = "10" > 10< / a >
< a href = "#11" id = "11" > 11< / a >
< a href = "#12" id = "12" > 12< / a >
< a href = "#13" id = "13" > 13< / a >
< a href = "#14" id = "14" > 14< / a >
< a href = "#15" id = "15" > 15< / a >
< a href = "#16" id = "16" > 16< / a >
< a href = "#17" id = "17" > 17< / a >
< a href = "#18" id = "18" > 18< / a >
< a href = "#19" id = "19" > 19< / a >
< a href = "#20" id = "20" > 20< / a >
< a href = "#21" id = "21" > 21< / a >
< a href = "#22" id = "22" > 22< / a >
< a href = "#23" id = "23" > 23< / a >
< a href = "#24" id = "24" > 24< / a >
< a href = "#25" id = "25" > 25< / a >
< a href = "#26" id = "26" > 26< / a >
< a href = "#27" id = "27" > 27< / a >
< a href = "#28" id = "28" > 28< / a >
< a href = "#29" id = "29" > 29< / a >
< a href = "#30" id = "30" > 30< / a >
< a href = "#31" id = "31" > 31< / a >
< a href = "#32" id = "32" > 32< / a >
< a href = "#33" id = "33" > 33< / a >
< a href = "#34" id = "34" > 34< / a >
< a href = "#35" id = "35" > 35< / a >
< a href = "#36" id = "36" > 36< / a >
< a href = "#37" id = "37" > 37< / a >
< a href = "#38" id = "38" > 38< / a >
< a href = "#39" id = "39" > 39< / a >
< a href = "#40" id = "40" > 40< / a >
< a href = "#41" id = "41" > 41< / a >
< a href = "#42" id = "42" > 42< / a >
< a href = "#43" id = "43" > 43< / a >
< a href = "#44" id = "44" > 44< / a >
< a href = "#45" id = "45" > 45< / a >
< a href = "#46" id = "46" > 46< / a >
< a href = "#47" id = "47" > 47< / a >
< a href = "#48" id = "48" > 48< / a >
< a href = "#49" id = "49" > 49< / a >
< a href = "#50" id = "50" > 50< / a >
< a href = "#51" id = "51" > 51< / a >
< a href = "#52" id = "52" > 52< / a >
< a href = "#53" id = "53" > 53< / a >
< a href = "#54" id = "54" > 54< / a >
< a href = "#55" id = "55" > 55< / a >
< a href = "#56" id = "56" > 56< / a >
< a href = "#57" id = "57" > 57< / a >
< a href = "#58" id = "58" > 58< / a >
< a href = "#59" id = "59" > 59< / a >
< a href = "#60" id = "60" > 60< / a >
< a href = "#61" id = "61" > 61< / a >
< a href = "#62" id = "62" > 62< / a >
< a href = "#63" id = "63" > 63< / a >
< a href = "#64" id = "64" > 64< / a >
< a href = "#65" id = "65" > 65< / a >
< a href = "#66" id = "66" > 66< / a >
< a href = "#67" id = "67" > 67< / a >
< a href = "#68" id = "68" > 68< / a >
< a href = "#69" id = "69" > 69< / a >
< a href = "#70" id = "70" > 70< / a >
< a href = "#71" id = "71" > 71< / a >
< a href = "#72" id = "72" > 72< / a >
< a href = "#73" id = "73" > 73< / a >
< a href = "#74" id = "74" > 74< / a >
< a href = "#75" id = "75" > 75< / a >
< a href = "#76" id = "76" > 76< / a >
< a href = "#77" id = "77" > 77< / a >
< a href = "#78" id = "78" > 78< / a >
< a href = "#79" id = "79" > 79< / a >
< a href = "#80" id = "80" > 80< / a >
< a href = "#81" id = "81" > 81< / a >
< a href = "#82" id = "82" > 82< / a >
< a href = "#83" id = "83" > 83< / a >
< a href = "#84" id = "84" > 84< / a >
< a href = "#85" id = "85" > 85< / a >
< a href = "#86" id = "86" > 86< / a >
< a href = "#87" id = "87" > 87< / a >
< a href = "#88" id = "88" > 88< / a >
< a href = "#89" id = "89" > 89< / a >
< a href = "#90" id = "90" > 90< / a >
< a href = "#91" id = "91" > 91< / a >
< a href = "#92" id = "92" > 92< / a >
< a href = "#93" id = "93" > 93< / a >
< a href = "#94" id = "94" > 94< / a >
< a href = "#95" id = "95" > 95< / a >
< a href = "#96" id = "96" > 96< / a >
< a href = "#97" id = "97" > 97< / a >
< a href = "#98" id = "98" > 98< / a >
< a href = "#99" id = "99" > 99< / a >
< a href = "#100" id = "100" > 100< / a >
< a href = "#101" id = "101" > 101< / a >
< a href = "#102" id = "102" > 102< / a >
< a href = "#103" id = "103" > 103< / a >
< a href = "#104" id = "104" > 104< / a >
< a href = "#105" id = "105" > 105< / a >
< a href = "#106" id = "106" > 106< / a >
< a href = "#107" id = "107" > 107< / a >
< a href = "#108" id = "108" > 108< / a >
< a href = "#109" id = "109" > 109< / a >
< a href = "#110" id = "110" > 110< / a >
< a href = "#111" id = "111" > 111< / a >
< a href = "#112" id = "112" > 112< / a >
< a href = "#113" id = "113" > 113< / a >
< a href = "#114" id = "114" > 114< / a >
< a href = "#115" id = "115" > 115< / a >
< a href = "#116" id = "116" > 116< / a >
< a href = "#117" id = "117" > 117< / a >
< a href = "#118" id = "118" > 118< / a >
< a href = "#119" id = "119" > 119< / a >
< a href = "#120" id = "120" > 120< / a >
< a href = "#121" id = "121" > 121< / a >
< a href = "#122" id = "122" > 122< / a >
< a href = "#123" id = "123" > 123< / a >
< a href = "#124" id = "124" > 124< / a >
< a href = "#125" id = "125" > 125< / a >
< a href = "#126" id = "126" > 126< / a >
< a href = "#127" id = "127" > 127< / a >
< a href = "#128" id = "128" > 128< / a >
< a href = "#129" id = "129" > 129< / a >
< a href = "#130" id = "130" > 130< / a >
< a href = "#131" id = "131" > 131< / a >
< a href = "#132" id = "132" > 132< / a >
< a href = "#133" id = "133" > 133< / a >
< a href = "#134" id = "134" > 134< / a >
< a href = "#135" id = "135" > 135< / a >
< a href = "#136" id = "136" > 136< / a >
< a href = "#137" id = "137" > 137< / a >
< a href = "#138" id = "138" > 138< / a >
< a href = "#139" id = "139" > 139< / a >
< a href = "#140" id = "140" > 140< / a >
< a href = "#141" id = "141" > 141< / a >
< a href = "#142" id = "142" > 142< / a >
< a href = "#143" id = "143" > 143< / a >
< a href = "#144" id = "144" > 144< / a >
< a href = "#145" id = "145" > 145< / a >
< a href = "#146" id = "146" > 146< / a >
< a href = "#147" id = "147" > 147< / a >
< a href = "#148" id = "148" > 148< / a >
< a href = "#149" id = "149" > 149< / a >
< a href = "#150" id = "150" > 150< / a >
< a href = "#151" id = "151" > 151< / a >
< a href = "#152" id = "152" > 152< / a >
< a href = "#153" id = "153" > 153< / a >
< a href = "#154" id = "154" > 154< / a >
< a href = "#155" id = "155" > 155< / a >
< a href = "#156" id = "156" > 156< / a >
< a href = "#157" id = "157" > 157< / a >
< a href = "#158" id = "158" > 158< / a >
< a href = "#159" id = "159" > 159< / a >
< a href = "#160" id = "160" > 160< / a >
< a href = "#161" id = "161" > 161< / a >
< a href = "#162" id = "162" > 162< / a >
< a href = "#163" id = "163" > 163< / a >
< a href = "#164" id = "164" > 164< / a >
< a href = "#165" id = "165" > 165< / a >
< a href = "#166" id = "166" > 166< / a >
< a href = "#167" id = "167" > 167< / a >
< a href = "#168" id = "168" > 168< / a >
< a href = "#169" id = "169" > 169< / a >
< a href = "#170" id = "170" > 170< / a >
< a href = "#171" id = "171" > 171< / a >
< a href = "#172" id = "172" > 172< / a >
< a href = "#173" id = "173" > 173< / a >
< a href = "#174" id = "174" > 174< / a >
< a href = "#175" id = "175" > 175< / a >
< a href = "#176" id = "176" > 176< / a >
< a href = "#177" id = "177" > 177< / a >
< a href = "#178" id = "178" > 178< / a >
< a href = "#179" id = "179" > 179< / a >
< a href = "#180" id = "180" > 180< / a >
< a href = "#181" id = "181" > 181< / a >
< a href = "#182" id = "182" > 182< / a >
< a href = "#183" id = "183" > 183< / a >
< a href = "#184" id = "184" > 184< / a >
< a href = "#185" id = "185" > 185< / a >
< a href = "#186" id = "186" > 186< / a >
< a href = "#187" id = "187" > 187< / a >
< a href = "#188" id = "188" > 188< / a >
< a href = "#189" id = "189" > 189< / a >
< a href = "#190" id = "190" > 190< / a >
< a href = "#191" id = "191" > 191< / a >
< a href = "#192" id = "192" > 192< / a >
< a href = "#193" id = "193" > 193< / a >
< a href = "#194" id = "194" > 194< / a >
< a href = "#195" id = "195" > 195< / a >
< a href = "#196" id = "196" > 196< / a >
< a href = "#197" id = "197" > 197< / a >
< a href = "#198" id = "198" > 198< / a >
< a href = "#199" id = "199" > 199< / a >
< a href = "#200" id = "200" > 200< / a >
< a href = "#201" id = "201" > 201< / a >
< a href = "#202" id = "202" > 202< / a >
< a href = "#203" id = "203" > 203< / a >
< a href = "#204" id = "204" > 204< / a >
< a href = "#205" id = "205" > 205< / a >
< a href = "#206" id = "206" > 206< / a >
< a href = "#207" id = "207" > 207< / a >
< a href = "#208" id = "208" > 208< / a >
< a href = "#209" id = "209" > 209< / a >
< a href = "#210" id = "210" > 210< / a >
< a href = "#211" id = "211" > 211< / a >
< a href = "#212" id = "212" > 212< / a >
< a href = "#213" id = "213" > 213< / a >
< a href = "#214" id = "214" > 214< / a >
< a href = "#215" id = "215" > 215< / a >
< a href = "#216" id = "216" > 216< / a >
< a href = "#217" id = "217" > 217< / a >
< a href = "#218" id = "218" > 218< / a >
< a href = "#219" id = "219" > 219< / a >
< a href = "#220" id = "220" > 220< / a >
< a href = "#221" id = "221" > 221< / a >
< a href = "#222" id = "222" > 222< / a >
< a href = "#223" id = "223" > 223< / a >
< a href = "#224" id = "224" > 224< / a >
< a href = "#225" id = "225" > 225< / a >
< a href = "#226" id = "226" > 226< / a >
< a href = "#227" id = "227" > 227< / a >
< a href = "#228" id = "228" > 228< / a >
< a href = "#229" id = "229" > 229< / a >
< a href = "#230" id = "230" > 230< / a >
< a href = "#231" id = "231" > 231< / a >
< a href = "#232" id = "232" > 232< / a >
< a href = "#233" id = "233" > 233< / a >
< a href = "#234" id = "234" > 234< / a >
< a href = "#235" id = "235" > 235< / a >
< a href = "#236" id = "236" > 236< / a >
< a href = "#237" id = "237" > 237< / a >
< a href = "#238" id = "238" > 238< / a >
< a href = "#239" id = "239" > 239< / a >
< a href = "#240" id = "240" > 240< / a >
< a href = "#241" id = "241" > 241< / a >
< a href = "#242" id = "242" > 242< / a >
< a href = "#243" id = "243" > 243< / a >
< a href = "#244" id = "244" > 244< / a >
< a href = "#245" id = "245" > 245< / a >
< a href = "#246" id = "246" > 246< / a >
< a href = "#247" id = "247" > 247< / a >
< a href = "#248" id = "248" > 248< / a >
< a href = "#249" id = "249" > 249< / a >
< a href = "#250" id = "250" > 250< / a >
< a href = "#251" id = "251" > 251< / a >
< a href = "#252" id = "252" > 252< / a >
< a href = "#253" id = "253" > 253< / a >
< a href = "#254" id = "254" > 254< / a >
< a href = "#255" id = "255" > 255< / a >
< a href = "#256" id = "256" > 256< / a >
< a href = "#257" id = "257" > 257< / a >
< a href = "#258" id = "258" > 258< / a >
< a href = "#259" id = "259" > 259< / a >
< a href = "#260" id = "260" > 260< / a >
< a href = "#261" id = "261" > 261< / a >
< a href = "#262" id = "262" > 262< / a >
< a href = "#263" id = "263" > 263< / a >
< a href = "#264" id = "264" > 264< / a >
< a href = "#265" id = "265" > 265< / a >
< a href = "#266" id = "266" > 266< / a >
< a href = "#267" id = "267" > 267< / a >
< a href = "#268" id = "268" > 268< / a >
< a href = "#269" id = "269" > 269< / a >
< a href = "#270" id = "270" > 270< / a >
< a href = "#271" id = "271" > 271< / a >
< a href = "#272" id = "272" > 272< / a >
< a href = "#273" id = "273" > 273< / a >
< a href = "#274" id = "274" > 274< / a >
< a href = "#275" id = "275" > 275< / a >
< a href = "#276" id = "276" > 276< / a >
< a href = "#277" id = "277" > 277< / a >
< a href = "#278" id = "278" > 278< / a >
< a href = "#279" id = "279" > 279< / a >
< a href = "#280" id = "280" > 280< / a >
< a href = "#281" id = "281" > 281< / a >
< a href = "#282" id = "282" > 282< / a >
< a href = "#283" id = "283" > 283< / a >
< a href = "#284" id = "284" > 284< / a >
< a href = "#285" id = "285" > 285< / a >
< a href = "#286" id = "286" > 286< / a >
< a href = "#287" id = "287" > 287< / a >
< a href = "#288" id = "288" > 288< / a >
< a href = "#289" id = "289" > 289< / a >
< a href = "#290" id = "290" > 290< / a >
< a href = "#291" id = "291" > 291< / a >
< a href = "#292" id = "292" > 292< / a >
< a href = "#293" id = "293" > 293< / a >
< a href = "#294" id = "294" > 294< / a >
< a href = "#295" id = "295" > 295< / a >
< a href = "#296" id = "296" > 296< / a >
< a href = "#297" id = "297" > 297< / a >
< a href = "#298" id = "298" > 298< / a >
< a href = "#299" id = "299" > 299< / a >
< a href = "#300" id = "300" > 300< / a >
< a href = "#301" id = "301" > 301< / a >
< a href = "#302" id = "302" > 302< / a >
< a href = "#303" id = "303" > 303< / a >
< a href = "#304" id = "304" > 304< / a >
< a href = "#305" id = "305" > 305< / a >
< a href = "#306" id = "306" > 306< / a >
< a href = "#307" id = "307" > 307< / a >
< a href = "#308" id = "308" > 308< / a >
< a href = "#309" id = "309" > 309< / a >
< a href = "#310" id = "310" > 310< / a >
< a href = "#311" id = "311" > 311< / a >
< a href = "#312" id = "312" > 312< / a >
< a href = "#313" id = "313" > 313< / a >
< a href = "#314" id = "314" > 314< / a >
< a href = "#315" id = "315" > 315< / a >
< a href = "#316" id = "316" > 316< / a >
< a href = "#317" id = "317" > 317< / a >
< a href = "#318" id = "318" > 318< / a >
< a href = "#319" id = "319" > 319< / a >
< a href = "#320" id = "320" > 320< / a >
< a href = "#321" id = "321" > 321< / a >
< a href = "#322" id = "322" > 322< / a >
< a href = "#323" id = "323" > 323< / a >
< a href = "#324" id = "324" > 324< / a >
< a href = "#325" id = "325" > 325< / a >
< a href = "#326" id = "326" > 326< / a >
< a href = "#327" id = "327" > 327< / a >
< a href = "#328" id = "328" > 328< / a >
< a href = "#329" id = "329" > 329< / a >
< a href = "#330" id = "330" > 330< / a >
< a href = "#331" id = "331" > 331< / a >
< a href = "#332" id = "332" > 332< / a >
< a href = "#333" id = "333" > 333< / a >
< a href = "#334" id = "334" > 334< / a >
< a href = "#335" id = "335" > 335< / a >
< a href = "#336" id = "336" > 336< / a >
< a href = "#337" id = "337" > 337< / a >
< a href = "#338" id = "338" > 338< / a >
< a href = "#339" id = "339" > 339< / a >
< a href = "#340" id = "340" > 340< / a >
< a href = "#341" id = "341" > 341< / a >
< a href = "#342" id = "342" > 342< / a >
< a href = "#343" id = "343" > 343< / a >
< a href = "#344" id = "344" > 344< / a >
< a href = "#345" id = "345" > 345< / a >
< a href = "#346" id = "346" > 346< / a >
< a href = "#347" id = "347" > 347< / a >
< a href = "#348" id = "348" > 348< / a >
< a href = "#349" id = "349" > 349< / a >
< a href = "#350" id = "350" > 350< / a >
< a href = "#351" id = "351" > 351< / a >
< a href = "#352" id = "352" > 352< / a >
< a href = "#353" id = "353" > 353< / a >
< a href = "#354" id = "354" > 354< / a >
< a href = "#355" id = "355" > 355< / a >
< a href = "#356" id = "356" > 356< / a >
< a href = "#357" id = "357" > 357< / a >
< a href = "#358" id = "358" > 358< / a >
< a href = "#359" id = "359" > 359< / a >
< a href = "#360" id = "360" > 360< / a >
< a href = "#361" id = "361" > 361< / a >
< a href = "#362" id = "362" > 362< / a >
< a href = "#363" id = "363" > 363< / a >
< / pre > < / div > < pre class = "rust" > < code > < span class = "doccomment" > //! 32-bit hashing machinery
//!
//! # Why?
//!
//! Because 32-bit architectures are a thing (e.g. ARM Cortex-M) and you don' t want your hashing
//! function to pull in a bunch of slow 64-bit compiler intrinsics (software implementations of
//! 64-bit operations).
//!
//! # Relationship to `core::hash`
//!
//! This crate exposes the same interfaces you' ll find in [`core::hash`]: `Hash`, `Hasher`,
//! `BuildHasher` and `BuildHasherDefault`. The main difference is that `hash32::Hasher::finish`
//! returns a `u32` instead of `u64`, and the contract of `hash32::Hasher` forbids the implementer
//! from performing 64-bit (or 128-bit) operations while computing the hash.
//!
//! [`core::hash`]: https://doc.rust-lang.org/std/hash/index.html
//!
//! # `#[derive(Hash32)]`
//!
//! The easiest way to implement `hash32::Hash` for a `struct` is to use the `#[derive(Hash32)]`.
//!
//! Note that you need to *explicitly* depend on both `hash32` *and* `hash32_derive`; both crates
//! must appear in your `Cargo.toml`.
//!
//! ``` ignore
//! use hash32_derive::Hash32;
//!
//! #[derive(Hash32)]
//! struct Ipv4Addr([u8; 4]);
//!
//! # fn main() {}
//!
//! ```
//! # Hashers
//!
//! This crate provides implementations of the following 32-bit hashing algorithms:
//!
//! - [Fowler-Noll-Vo](struct.FnvHasher.html)
//! - [MurmurHash3](struct.Murmur3Hasher.html)
//!
//! # MSRV
//!
//! This crate is guaranteed to compile on latest stable Rust. It *might* compile on older
//! versions but that may change in any new patch release.
//!
//! # Future
//!
//! In the future we' d like to deprecate this crate in favor of making `core::hash::Hasher` generic
//! over the size of the computed hash. Below is shown the planned change (but it doesn' t work due
//! to limitations in the `associated_type_defaults` feature):
//!
//! ``` ignore
//! #![feature(associated_type_defaults)]
//!
//! trait Hasher {
//! type Hash = u64; // default type for backwards compatibility
//!
//! fn finish(& self) -> Self::Hash; // changed
//! fn write(& mut self, bytes: & [u8]);
//! }
//! ```
//!
//! With this change a single `#[derive(Hash)]` would enough to make a type hashable with 32-bit and
//! 64-bit hashers.
< / span > < span class = "attr" > #![deny(missing_docs)]
#![deny(warnings)]
#![no_std]
< / span > < span class = "kw" > extern crate < / span > byteorder;
< span class = "kw" > use < / span > core::marker::PhantomData;
< span class = "kw" > use < / span > core::{mem, slice, fmt};
< span class = "kw" > pub use < / span > fnv::Hasher < span class = "kw" > as < / span > FnvHasher;
< span class = "kw" > pub use < / span > murmur3::Hasher < span class = "kw" > as < / span > Murmur3Hasher;
< span class = "kw" > mod < / span > fnv;
< span class = "kw" > mod < / span > murmur3;
< span class = "doccomment" > /// See [`core::hash::BuildHasherDefault`][0] for details
///
/// [0]: https://doc.rust-lang.org/core/hash/struct.BuildHasherDefault.html
< / span > < span class = "kw" > pub struct < / span > BuildHasherDefault< H>
{
_marker: PhantomData< H> ,
}
< span class = "kw" > impl< / span > < H> Default < span class = "kw" > for < / span > BuildHasherDefault< H>
< span class = "kw" > where
< / span > H: Default + Hasher,
{
< span class = "kw" > fn < / span > default() -> < span class = "self" > Self < / span > {
BuildHasherDefault {
_marker: PhantomData,
}
}
}
< span class = "kw" > impl< / span > < H> Clone < span class = "kw" > for < / span > BuildHasherDefault< H>
< span class = "kw" > where
< / span > H: Default + Hasher,
{
< span class = "kw" > fn < / span > clone(< span class = "kw-2" > & < / span > < span class = "self" > self< / span > ) -> < span class = "self" > Self < / span > {
BuildHasherDefault::default()
}
}
< span class = "kw" > impl< / span > < H> PartialEq < span class = "kw" > for < / span > BuildHasherDefault< H>
< span class = "kw" > where
< / span > H: Default + Hasher,
{
< span class = "kw" > fn < / span > eq(< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , _other: < span class = "kw-2" > & < / span > BuildHasherDefault< H> ) -> bool {
< span class = "bool-val" > true
< / span > }
}
< span class = "kw" > impl< / span > < H: Default + Hasher> Eq < span class = "kw" > for < / span > BuildHasherDefault< H> {}
< span class = "kw" > impl< / span > < H: Default + Hasher> fmt::Debug < span class = "kw" > for < / span > BuildHasherDefault< H> {
< span class = "kw" > fn < / span > fmt(< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , f: < span class = "kw-2" > & mut < / span > fmt::Formatter< < span class = "lifetime" > ' _< / span > > ) -> fmt::Result {
f.pad(< span class = "string" > " BuildHasherDefault" < / span > )
}
}
< span class = "kw" > impl< / span > < H> BuildHasherDefault< H>
{
< span class = "doccomment" > /// `const` constructor
< / span > < span class = "kw" > pub const fn < / span > new() -> < span class = "self" > Self < / span > {
BuildHasherDefault {
_marker: PhantomData,
}
}
}
< span class = "kw" > impl< / span > < H> BuildHasher < span class = "kw" > for < / span > BuildHasherDefault< H>
< span class = "kw" > where
< / span > H: Default + Hasher,
{
< span class = "kw" > type < / span > Hasher = H;
< span class = "kw" > fn < / span > build_hasher(< span class = "kw-2" > & < / span > < span class = "self" > self< / span > ) -> < span class = "self" > Self< / span > ::Hasher {
H::default()
}
}
< span class = "doccomment" > /// See [`core::hash::BuildHasher`][0] for details
///
/// [0]: https://doc.rust-lang.org/core/hash/trait.BuildHasher.html
< / span > < span class = "kw" > pub trait < / span > BuildHasher {
< span class = "doccomment" > /// See [`core::hash::BuildHasher::Hasher`][0]
///
/// [0]: https://doc.rust-lang.org/std/hash/trait.BuildHasher.html#associatedtype.Hasher
< / span > < span class = "kw" > type < / span > Hasher: Hasher;
< span class = "doccomment" > /// See [`core::hash::BuildHasher.build_hasher`][0]
///
/// [0]: https://doc.rust-lang.org/std/hash/trait.BuildHasher.html#tymethod.build_hasher
< / span > < span class = "kw" > fn < / span > build_hasher(< span class = "kw-2" > & < / span > < span class = "self" > self< / span > ) -> < span class = "self" > Self< / span > ::Hasher;
}
< span class = "doccomment" > /// See [`core::hash::Hasher`][0] for details
///
/// [0]: https://doc.rust-lang.org/core/hash/trait.Hasher.html
///
/// # Contract
///
/// Implementers of this trait must *not* perform any 64-bit (or 128-bit) operation while computing
/// the hash.
< / span > < span class = "kw" > pub trait < / span > Hasher {
< span class = "doccomment" > /// See [`core::hash::Hasher.finish`][0]
///
/// [0]: https://doc.rust-lang.org/std/hash/trait.Hasher.html#tymethod.finish
< / span > < span class = "kw" > fn < / span > finish(< span class = "kw-2" > & < / span > < span class = "self" > self< / span > ) -> u32;
< span class = "doccomment" > /// See [`core::hash::Hasher.write`][0]
///
/// [0]: https://doc.rust-lang.org/std/hash/trait.Hasher.html#tymethod.write
< / span > < span class = "kw" > fn < / span > write(< span class = "kw-2" > & mut < / span > < span class = "self" > self< / span > , bytes: < span class = "kw-2" > & < / span > [u8]);
}
< span class = "doccomment" > /// See [`core::hash::Hash`][0] for details
///
/// [0]: https://doc.rust-lang.org/core/hash/trait.Hash.html
< / span > < span class = "kw" > pub trait < / span > Hash {
< span class = "doccomment" > /// Feeds this value into the given `Hasher`.
< / span > < span class = "kw" > fn < / span > hash< H> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > H)
< span class = "kw" > where
< / span > H: Hasher;
< span class = "doccomment" > /// Feeds a slice of this type into the given `Hasher`.
< / span > < span class = "kw" > fn < / span > hash_slice< H> (data: < span class = "kw-2" > & < / span > [< span class = "self" > Self< / span > ], state: < span class = "kw-2" > & mut < / span > H)
< span class = "kw" > where
< / span > H: Hasher,
< span class = "self" > Self< / span > : Sized,
{
< span class = "kw" > for < / span > piece < span class = "kw" > in < / span > data {
piece.hash(state);
}
}
}
< span class = "macro" > macro_rules! < / span > int {
(< span class = "macro-nonterminal" > $ty< / span > :ident) => {
< span class = "kw" > impl < / span > Hash < span class = "kw" > for < / span > < span class = "macro-nonterminal" > $ty < / span > {
< span class = "kw" > fn < / span > hash< H> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > H)
< span class = "kw" > where
< / span > H: Hasher,
{
< span class = "kw" > unsafe < / span > { state.write(< span class = "kw-2" > & < / span > mem::transmute::< < span class = "macro-nonterminal" > $ty< / span > , [u8; mem::size_of::< < span class = "macro-nonterminal" > $ty< / span > > ()]> (< span class = "kw-2" > *< / span > < span class = "self" > self< / span > )) }
}
< span class = "kw" > fn < / span > hash_slice< H> (data: < span class = "kw-2" > & < / span > [< span class = "self" > Self< / span > ], state: < span class = "kw-2" > & mut < / span > H)
< span class = "kw" > where
< / span > H: Hasher,
{
< span class = "kw" > let < / span > newlen = data.len() * mem::size_of::< < span class = "macro-nonterminal" > $ty< / span > > ();
< span class = "kw" > let < / span > ptr = data.as_ptr() < span class = "kw" > as < / span > < span class = "kw-2" > *const < / span > u8;
< span class = "kw" > unsafe < / span > { state.write(slice::from_raw_parts(ptr, newlen)) }
}
}
};
}
< span class = "macro" > int!< / span > (i16);
< span class = "macro" > int!< / span > (i32);
< span class = "macro" > int!< / span > (i64);
< span class = "macro" > int!< / span > (i8);
< span class = "macro" > int!< / span > (isize);
< span class = "macro" > int!< / span > (u16);
< span class = "macro" > int!< / span > (u32);
< span class = "macro" > int!< / span > (u64);
< span class = "macro" > int!< / span > (u8);
< span class = "macro" > int!< / span > (usize);
< span class = "kw" > impl < / span > Hash < span class = "kw" > for < / span > bool {
< span class = "kw" > fn < / span > hash< H> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > H)
< span class = "kw" > where
< / span > H: Hasher,
{
(< span class = "kw-2" > *< / span > < span class = "self" > self < / span > < span class = "kw" > as < / span > u8).hash(state)
}
}
< span class = "kw" > impl < / span > Hash < span class = "kw" > for < / span > char {
< span class = "kw" > fn < / span > hash< H> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > H)
< span class = "kw" > where
< / span > H: Hasher,
{
(< span class = "kw-2" > *< / span > < span class = "self" > self < / span > < span class = "kw" > as < / span > u32).hash(state)
}
}
< span class = "kw" > impl < / span > Hash < span class = "kw" > for < / span > str {
< span class = "kw" > fn < / span > hash< H> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > H)
< span class = "kw" > where
< / span > H: Hasher,
{
state.write(< span class = "self" > self< / span > .as_bytes());
state.write(< span class = "kw-2" > & < / span > [< span class = "number" > 0xff< / span > ]);
}
}
< span class = "kw" > impl< / span > < T> Hash < span class = "kw" > for < / span > [T]
< span class = "kw" > where
< / span > T: Hash,
{
< span class = "kw" > fn < / span > hash< H> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > H)
< span class = "kw" > where
< / span > H: Hasher,
{
< span class = "self" > self< / span > .len().hash(state);
T::hash_slice(< span class = "self" > self< / span > , state);
}
}
< span class = "macro" > macro_rules! < / span > array {
($(< span class = "macro-nonterminal" > $n< / span > :expr),+) => {
$(
< span class = "kw" > impl< / span > < T> Hash < span class = "kw" > for < / span > [T; < span class = "macro-nonterminal" > $n< / span > ]
< span class = "kw" > where
< / span > T: Hash,
{
< span class = "kw" > fn < / span > hash< H> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > H)
< span class = "kw" > where
< / span > H: Hasher,
{
Hash::hash(< span class = "kw-2" > & < / span > < span class = "self" > self< / span > [..], state)
}
}
)+
};
}
< span class = "macro" > array!< / span > (
< span class = "number" > 0< / span > , < span class = "number" > 1< / span > , < span class = "number" > 2< / span > , < span class = "number" > 3< / span > , < span class = "number" > 4< / span > , < span class = "number" > 5< / span > , < span class = "number" > 6< / span > , < span class = "number" > 7< / span > , < span class = "number" > 8< / span > , < span class = "number" > 9< / span > , < span class = "number" > 10< / span > , < span class = "number" > 11< / span > , < span class = "number" > 12< / span > , < span class = "number" > 13< / span > , < span class = "number" > 14< / span > , < span class = "number" > 15< / span > , < span class = "number" > 16< / span > , < span class = "number" > 17< / span > , < span class = "number" > 18< / span > , < span class = "number" > 19< / span > , < span class = "number" > 20< / span > , < span class = "number" > 21< / span > , < span class = "number" > 22< / span > , < span class = "number" > 23< / span > , < span class = "number" > 24< / span > , < span class = "number" > 25< / span > ,
< span class = "number" > 26< / span > , < span class = "number" > 27< / span > , < span class = "number" > 28< / span > , < span class = "number" > 29< / span > , < span class = "number" > 30< / span > , < span class = "number" > 31< / span > , < span class = "number" > 32
< / span > );
< span class = "kw" > impl< / span > < < span class = "lifetime" > ' a< / span > , T: < span class = "question-mark" > ?< / span > Sized + Hash> Hash < span class = "kw" > for < / span > < span class = "kw-2" > & < / span > < span class = "lifetime" > ' a < / span > T {
< span class = "kw" > fn < / span > hash< H: Hasher> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > H) {
(< span class = "kw-2" > **< / span > < span class = "self" > self< / span > ).hash(state);
}
}
< span class = "kw" > impl< / span > < < span class = "lifetime" > ' a< / span > , T: < span class = "question-mark" > ?< / span > Sized + Hash> Hash < span class = "kw" > for < / span > < span class = "kw-2" > & < / span > < span class = "lifetime" > ' a < / span > < span class = "kw-2" > mut < / span > T {
< span class = "kw" > fn < / span > hash< H: Hasher> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > H) {
(< span class = "kw-2" > **< / span > < span class = "self" > self< / span > ).hash(state);
}
}
< span class = "kw" > impl < / span > Hash < span class = "kw" > for < / span > () {
< span class = "kw" > fn < / span > hash< H: Hasher> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , _state: < span class = "kw-2" > & mut < / span > H) {}
}
< span class = "macro" > macro_rules! < / span > tuple {
( $(< span class = "macro-nonterminal" > $name< / span > :ident)+) => (
< span class = "kw" > impl< / span > < $(< span class = "macro-nonterminal" > $name< / span > : Hash),< span class = "kw-2" > *< / span > > Hash < span class = "kw" > for < / span > ($(< span class = "macro-nonterminal" > $name< / span > ,)< span class = "kw-2" > *< / span > )
< span class = "kw" > where
< / span > < span class = "macro" > last_type!< / span > ($(< span class = "macro-nonterminal" > $name< / span > ,)+): < span class = "question-mark" > ?< / span > Sized
{
< span class = "attr" > #[allow(non_snake_case)]
< / span > < span class = "kw" > fn < / span > hash< S: Hasher> (< span class = "kw-2" > & < / span > < span class = "self" > self< / span > , state: < span class = "kw-2" > & mut < / span > S) {
< span class = "kw" > let < / span > ($(< span class = "kw-2" > ref < / span > < span class = "macro-nonterminal" > $name< / span > ,)< span class = "kw-2" > *< / span > ) = < span class = "kw-2" > *< / span > < span class = "self" > self< / span > ;
$(< span class = "macro-nonterminal" > $name< / span > .hash(state);)*
}
}
);
}
< span class = "macro" > macro_rules! < / span > last_type {
(< span class = "macro-nonterminal" > $a< / span > :ident,) => { < span class = "macro-nonterminal" > $a < / span > };
(< span class = "macro-nonterminal" > $a< / span > :ident, $(< span class = "macro-nonterminal" > $rest_a< / span > :ident,)+) => { < span class = "macro" > last_type!< / span > ($(< span class = "macro-nonterminal" > $rest_a< / span > ,)+) };
}
< span class = "macro" > tuple! < / span > { A }
< span class = "macro" > tuple! < / span > { A B }
< span class = "macro" > tuple! < / span > { A B C }
< span class = "macro" > tuple! < / span > { A B C D }
< span class = "macro" > tuple! < / span > { A B C D E }
< span class = "macro" > tuple! < / span > { A B C D E F }
< span class = "macro" > tuple! < / span > { A B C D E F G }
< span class = "macro" > tuple! < / span > { A B C D E F G H }
< span class = "macro" > tuple! < / span > { A B C D E F G H I }
< span class = "macro" > tuple! < / span > { A B C D E F G H I J }
< span class = "macro" > tuple! < / span > { A B C D E F G H I J K }
< span class = "macro" > tuple! < / span > { A B C D E F G H I J K L }
< span class = "attr" > #[cfg(test)]
< / span > < span class = "kw" > mod < / span > test {
< span class = "kw" > use super< / span > ::{FnvHasher, Hash, Hasher};
< span class = "attr" > #[test]
< / span > < span class = "kw" > fn < / span > hashes_tuples() {
< span class = "kw" > let < / span > < span class = "kw-2" > mut < / span > h = FnvHasher::default();
().hash(< span class = "kw-2" > & mut < / span > h);
(< span class = "number" > 1_usize< / span > ,).hash(< span class = "kw-2" > & mut < / span > h);
(< span class = "number" > 1_u8< / span > , < span class = "number" > 2_i8< / span > ).hash(< span class = "kw-2" > & mut < / span > h);
(< span class = "number" > 1_u16< / span > , < span class = "number" > 2_i16< / span > , < span class = "number" > 3_u32< / span > ).hash(< span class = "kw-2" > & mut < / span > h);
(< span class = "number" > 1_i32< / span > , < span class = "number" > 2_u64< / span > , < span class = "number" > 3_i64< / span > , < span class = "bool-val" > true< / span > ).hash(< span class = "kw-2" > & mut < / span > h);
(< span class = "number" > 1_isize< / span > , < span class = "string" > ' a' < / span > , < span class = "string" > " abc" < / span > , [< span class = "number" > 1u32< / span > , < span class = "number" > 2< / span > , < span class = "number" > 3< / span > , < span class = "number" > 4< / span > ], < span class = "bool-val" > false< / span > ).hash(< span class = "kw-2" > & mut < / span > h);
h.finish();
}
}
< / code > < / pre > < / div > < / section > < / main > < / body > < / html >
