+/livesplit-wrapper
git clone https://git.julia.blue/+/livesplit-wrapper
b0170e4
gh-pages
1<!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 `/home/runner/.cargo/registry/src/github.com-1ecc6299db9ec823/log-0.4.17/src/lib.rs`. ">< meta name ="keywords "content ="rust, rustlang, rust-lang ">< title > lib.rs - source</ title >< link rel ="preload "as ="font "type ="font/woff2 "crossorigin href ="../../SourceSerif4-Regular.ttf.woff2 ">< link rel ="preload "as ="font "type ="font/woff2 "crossorigin href ="../../FiraSans-Regular.woff2 ">< link rel ="preload "as ="font "type ="font/woff2 "crossorigin href ="../../FiraSans-Medium.woff2 ">< link rel ="preload "as ="font "type ="font/woff2 "crossorigin href ="../../SourceCodePro-Regular.ttf.woff2 ">< link rel ="preload "as ="font "type ="font/woff2 "crossorigin href ="../../SourceSerif4-Bold.ttf.woff2 ">< link rel ="preload "as ="font "type ="font/woff2 "crossorigin href ="../../SourceCodePro-Semibold.ttf.woff2 ">< link rel ="stylesheet "href ="../../normalize.css ">< link rel ="stylesheet "href ="../../rustdoc.css "id ="mainThemeStyle ">< link rel ="stylesheet "href ="../../ayu.css "disabled >< link rel ="stylesheet "href ="../../dark.css "disabled >< link rel ="stylesheet "href ="../../light.css "id ="themeStyle ">< script id ="default-settings "></ script >< script src ="../../storage.js "></ script >< script defer src ="../../source-script.js "></ script >< script defer src ="../../source-files.js "></ script >< script defer src ="../../main.js "></ script >< noscript >< link rel ="stylesheet "href ="../../noscript.css "></ noscript >< link rel ="icon "href ="https://www.rust-lang.org/favicon.ico "></ head >< body class ="rustdoc source "> <!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--> < nav class ="mobile-topbar ">< button class ="sidebar-menu-toggle "> ☰</ button >< a class ="sidebar-logo "href ="../../log/index.html ">< div class ="logo-container ">< img src ="https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png "alt ="logo "></ div ></ a >< h2 class ="location "></ h2 ></ nav >< nav class ="sidebar ">< a class ="sidebar-logo "href ="../../log/index.html ">< div class ="logo-container "> 2< img src ="https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png "alt ="logo "></ div ></ a ></ nav >< main >< div class ="width-limiter ">< div class ="sub-container ">< a class ="sub-logo-container "href ="../../log/index.html "> 3< img src ="https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png "alt ="logo "></ a >< nav class ="sub ">< form class ="search-form ">< div class ="search-container ">< span ></ span >< input class ="search-input "name ="search "autocomplete ="off "spellcheck ="false "placeholder ="Click or press ‘S’ to search, ‘?’ for more options… "type ="search ">< div id ="help-button "title ="help "tabindex ="-1 ">< button type ="button "> ?</ button ></ div >< div id ="settings-menu "tabindex ="-1 ">< a href ="../../settings.html "title ="settings ">< img width ="22 "height ="22 "alt ="Change settings "src ="../../wheel.svg "></ a ></ div ></ div ></ form ></ nav ></ div >< section id ="main-content "class ="content ">< div class ="example-wrap ">< pre class ="line-numbers ">< span id ="1 "> 1</ span > 4< span id ="2 "> 2</ span > 5< span id ="3 "> 3</ span > 6< span id ="4 "> 4</ span > 7< span id ="5 "> 5</ span > 8< span id ="6 "> 6</ span > 9< span id ="7 "> 7</ span > 10< span id ="8 "> 8</ span > 11< span id ="9 "> 9</ span > 12< span id ="10 "> 10</ span > 13< span id ="11 "> 11</ span > 14< span id ="12 "> 12</ span > 15< span id ="13 "> 13</ span > 16< span id ="14 "> 14</ span > 17< span id ="15 "> 15</ span > 18< span id ="16 "> 16</ span > 19< span id ="17 "> 17</ span > 20< span id ="18 "> 18</ span > 21< span id ="19 "> 19</ span > 22< span id ="20 "> 20</ span > 23< span id ="21 "> 21</ span > 24< span id ="22 "> 22</ span > 25< span id ="23 "> 23</ span > 26< span id ="24 "> 24</ span > 27< span id ="25 "> 25</ span > 28< span id ="26 "> 26</ span > 29< span id ="27 "> 27</ span > 30< span id ="28 "> 28</ span > 31< span id ="29 "> 29</ span > 32< span id ="30 "> 30</ span > 33< span id ="31 "> 31</ span > 34< span id ="32 "> 32</ span > 35< span id ="33 "> 33</ span > 36< span id ="34 "> 34</ span > 37< span id ="35 "> 35</ span > 38< span id ="36 "> 36</ span > 39< span id ="37 "> 37</ span > 40< span id ="38 "> 38</ span > 41< span id ="39 "> 39</ span > 42< span id ="40 "> 40</ span > 43< span id ="41 "> 41</ span > 44< span id ="42 "> 42</ span > 45< span id ="43 "> 43</ span > 46< span id ="44 "> 44</ span > 47< span id ="45 "> 45</ span > 48< span id ="46 "> 46</ span > 49< span id ="47 "> 47</ span > 50< span id ="48 "> 48</ span > 51< span id ="49 "> 49</ span > 52< span id ="50 "> 50</ span > 53< span id ="51 "> 51</ span > 54< span id ="52 "> 52</ span > 55< span id ="53 "> 53</ span > 56< span id ="54 "> 54</ span > 57< span id ="55 "> 55</ span > 58< span id ="56 "> 56</ span > 59< span id ="57 "> 57</ span > 60< span id ="58 "> 58</ span > 61< span id ="59 "> 59</ span > 62< span id ="60 "> 60</ span > 63< span id ="61 "> 61</ span > 64< span id ="62 "> 62</ span > 65< span id ="63 "> 63</ span > 66< span id ="64 "> 64</ span > 67< span id ="65 "> 65</ span > 68< span id ="66 "> 66</ span > 69< span id ="67 "> 67</ span > 70< span id ="68 "> 68</ span > 71< span id ="69 "> 69</ span > 72< span id ="70 "> 70</ span > 73< span id ="71 "> 71</ span > 74< span id ="72 "> 72</ span > 75< span id ="73 "> 73</ span > 76< span id ="74 "> 74</ span > 77< span id ="75 "> 75</ span > 78< span id ="76 "> 76</ span > 79< span id ="77 "> 77</ span > 80< span id ="78 "> 78</ span > 81< span id ="79 "> 79</ span > 82< span id ="80 "> 80</ span > 83< span id ="81 "> 81</ span > 84< span id ="82 "> 82</ span > 85< span id ="83 "> 83</ span > 86< span id ="84 "> 84</ span > 87< span id ="85 "> 85</ span > 88< span id ="86 "> 86</ span > 89< span id ="87 "> 87</ span > 90< span id ="88 "> 88</ span > 91< span id ="89 "> 89</ span > 92< span id ="90 "> 90</ span > 93< span id ="91 "> 91</ span > 94< span id ="92 "> 92</ span > 95< span id ="93 "> 93</ span > 96< span id ="94 "> 94</ span > 97< span id ="95 "> 95</ span > 98< span id ="96 "> 96</ span > 99< span id ="97 "> 97</ span > 100< span id ="98 "> 98</ span > 101< span id ="99 "> 99</ span > 102< span id ="100 "> 100</ span > 103< span id ="101 "> 101</ span > 104< span id ="102 "> 102</ span > 105< span id ="103 "> 103</ span > 106< span id ="104 "> 104</ span > 107< span id ="105 "> 105</ span > 108< span id ="106 "> 106</ span > 109< span id ="107 "> 107</ span > 110< span id ="108 "> 108</ span > 111< span id ="109 "> 109</ span > 112< span id ="110 "> 110</ span > 113< span id ="111 "> 111</ span > 114< span id ="112 "> 112</ span > 115< span id ="113 "> 113</ span > 116< span id ="114 "> 114</ span > 117< span id ="115 "> 115</ span > 118< span id ="116 "> 116</ span > 119< span id ="117 "> 117</ span > 120< span id ="118 "> 118</ span > 121< span id ="119 "> 119</ span > 122< span id ="120 "> 120</ span > 123< span id ="121 "> 121</ span > 124< span id ="122 "> 122</ span > 125< span id ="123 "> 123</ span > 126< span id ="124 "> 124</ span > 127< span id ="125 "> 125</ span > 128< span id ="126 "> 126</ span > 129< span id ="127 "> 127</ span > 130< span id ="128 "> 128</ span > 131< span id ="129 "> 129</ span > 132< span id ="130 "> 130</ span > 133< span id ="131 "> 131</ span > 134< span id ="132 "> 132</ span > 135< span id ="133 "> 133</ span > 136< span id ="134 "> 134</ span > 137< span id ="135 "> 135</ span > 138< span id ="136 "> 136</ span > 139< span id ="137 "> 137</ span > 140< span id ="138 "> 138</ span > 141< span id ="139 "> 139</ span > 142< span id ="140 "> 140</ span > 143< span id ="141 "> 141</ span > 144< span id ="142 "> 142</ span > 145< span id ="143 "> 143</ span > 146< span id ="144 "> 144</ span > 147< span id ="145 "> 145</ span > 148< span id ="146 "> 146</ span > 149< span id ="147 "> 147</ span > 150< span id ="148 "> 148</ span > 151< span id ="149 "> 149</ span > 152< span id ="150 "> 150</ span > 153< span id ="151 "> 151</ span > 154< span id ="152 "> 152</ span > 155< span id ="153 "> 153</ span > 156< span id ="154 "> 154</ span > 157< span id ="155 "> 155</ span > 158< span id ="156 "> 156</ span > 159< span id ="157 "> 157</ span > 160< span id ="158 "> 158</ span > 161< span id ="159 "> 159</ span > 162< span id ="160 "> 160</ span > 163< span id ="161 "> 161</ span > 164< span id ="162 "> 162</ span > 165< span id ="163 "> 163</ span > 166< span id ="164 "> 164</ span > 167< span id ="165 "> 165</ span > 168< span id ="166 "> 166</ span > 169< span id ="167 "> 167</ span > 170< span id ="168 "> 168</ span > 171< span id ="169 "> 169</ span > 172< span id ="170 "> 170</ span > 173< span id ="171 "> 171</ span > 174< span id ="172 "> 172</ span > 175< span id ="173 "> 173</ span > 176< span id ="174 "> 174</ span > 177< span id ="175 "> 175</ span > 178< span id ="176 "> 176</ span > 179< span id ="177 "> 177</ span > 180< span id ="178 "> 178</ span > 181< span id ="179 "> 179</ span > 182< span id ="180 "> 180</ span > 183< span id ="181 "> 181</ span > 184< span id ="182 "> 182</ span > 185< span id ="183 "> 183</ span > 186< span id ="184 "> 184</ span > 187< span id ="185 "> 185</ span > 188< span id ="186 "> 186</ span > 189< span id ="187 "> 187</ span > 190< span id ="188 "> 188</ span > 191< span id ="189 "> 189</ span > 192< span id ="190 "> 190</ span > 193< span id ="191 "> 191</ span > 194< span id ="192 "> 192</ span > 195< span id ="193 "> 193</ span > 196< span id ="194 "> 194</ span > 197< span id ="195 "> 195</ span > 198< span id ="196 "> 196</ span > 199< span id ="197 "> 197</ span > 200< span id ="198 "> 198</ span > 201< span id ="199 "> 199</ span > 202< span id ="200 "> 200</ span > 203< span id ="201 "> 201</ span > 204< span id ="202 "> 202</ span > 205< span id ="203 "> 203</ span > 206< span id ="204 "> 204</ span > 207< span id ="205 "> 205</ span > 208< span id ="206 "> 206</ span > 209< span id ="207 "> 207</ span > 210< span id ="208 "> 208</ span > 211< span id ="209 "> 209</ span > 212< span id ="210 "> 210</ span > 213< span id ="211 "> 211</ span > 214< span id ="212 "> 212</ span > 215< span id ="213 "> 213</ span > 216< span id ="214 "> 214</ span > 217< span id ="215 "> 215</ span > 218< span id ="216 "> 216</ span > 219< span id ="217 "> 217</ span > 220< span id ="218 "> 218</ span > 221< span id ="219 "> 219</ span > 222< span id ="220 "> 220</ span > 223< span id ="221 "> 221</ span > 224< span id ="222 "> 222</ span > 225< span id ="223 "> 223</ span > 226< span id ="224 "> 224</ span > 227< span id ="225 "> 225</ span > 228< span id ="226 "> 226</ span > 229< span id ="227 "> 227</ span > 230< span id ="228 "> 228</ span > 231< span id ="229 "> 229</ span > 232< span id ="230 "> 230</ span > 233< span id ="231 "> 231</ span > 234< span id ="232 "> 232</ span > 235< span id ="233 "> 233</ span > 236< span id ="234 "> 234</ span > 237< span id ="235 "> 235</ span > 238< span id ="236 "> 236</ span > 239< span id ="237 "> 237</ span > 240< span id ="238 "> 238</ span > 241< span id ="239 "> 239</ span > 242< span id ="240 "> 240</ span > 243< span id ="241 "> 241</ span > 244< span id ="242 "> 242</ span > 245< span id ="243 "> 243</ span > 246< span id ="244 "> 244</ span > 247< span id ="245 "> 245</ span > 248< span id ="246 "> 246</ span > 249< span id ="247 "> 247</ span > 250< span id ="248 "> 248</ span > 251< span id ="249 "> 249</ span > 252< span id ="250 "> 250</ span > 253< span id ="251 "> 251</ span > 254< span id ="252 "> 252</ span > 255< span id ="253 "> 253</ span > 256< span id ="254 "> 254</ span > 257< span id ="255 "> 255</ span > 258< span id ="256 "> 256</ span > 259< span id ="257 "> 257</ span > 260< span id ="258 "> 258</ span > 261< span id ="259 "> 259</ span > 262< span id ="260 "> 260</ span > 263< span id ="261 "> 261</ span > 264< span id ="262 "> 262</ span > 265< span id ="263 "> 263</ span > 266< span id ="264 "> 264</ span > 267< span id ="265 "> 265</ span > 268< span id ="266 "> 266</ span > 269< span id ="267 "> 267</ span > 270< span id ="268 "> 268</ span > 271< span id ="269 "> 269</ span > 272< span id ="270 "> 270</ span > 273< span id ="271 "> 271</ span > 274< span id ="272 "> 272</ span > 275< span id ="273 "> 273</ span > 276< span id ="274 "> 274</ span > 277< span id ="275 "> 275</ span > 278< span id ="276 "> 276</ span > 279< span id ="277 "> 277</ span > 280< span id ="278 "> 278</ span > 281< span id ="279 "> 279</ span > 282< span id ="280 "> 280</ span > 283< span id ="281 "> 281</ span > 284< span id ="282 "> 282</ span > 285< span id ="283 "> 283</ span > 286< span id ="284 "> 284</ span > 287< span id ="285 "> 285</ span > 288< span id ="286 "> 286</ span > 289< span id ="287 "> 287</ span > 290< span id ="288 "> 288</ span > 291< span id ="289 "> 289</ span > 292< span id ="290 "> 290</ span > 293< span id ="291 "> 291</ span > 294< span id ="292 "> 292</ span > 295< span id ="293 "> 293</ span > 296< span id ="294 "> 294</ span > 297< span id ="295 "> 295</ span > 298< span id ="296 "> 296</ span > 299< span id ="297 "> 297</ span > 300< span id ="298 "> 298</ span > 301< span id ="299 "> 299</ span > 302< span id ="300 "> 300</ span > 303< span id ="301 "> 301</ span > 304< span id ="302 "> 302</ span > 305< span id ="303 "> 303</ span > 306< span id ="304 "> 304</ span > 307< span id ="305 "> 305</ span > 308< span id ="306 "> 306</ span > 309< span id ="307 "> 307</ span > 310< span id ="308 "> 308</ span > 311< span id ="309 "> 309</ span > 312< span id ="310 "> 310</ span > 313< span id ="311 "> 311</ span > 314< span id ="312 "> 312</ span > 315< span id ="313 "> 313</ span > 316< span id ="314 "> 314</ span > 317< span id ="315 "> 315</ span > 318< span id ="316 "> 316</ span > 319< span id ="317 "> 317</ span > 320< span id ="318 "> 318</ span > 321< span id ="319 "> 319</ span > 322< span id ="320 "> 320</ span > 323< span id ="321 "> 321</ span > 324< span id ="322 "> 322</ span > 325< span id ="323 "> 323</ span > 326< span id ="324 "> 324</ span > 327< span id ="325 "> 325</ span > 328< span id ="326 "> 326</ span > 329< span id ="327 "> 327</ span > 330< span id ="328 "> 328</ span > 331< span id ="329 "> 329</ span > 332< span id ="330 "> 330</ span > 333< span id ="331 "> 331</ span > 334< span id ="332 "> 332</ span > 335< span id ="333 "> 333</ span > 336< span id ="334 "> 334</ span > 337< span id ="335 "> 335</ span > 338< span id ="336 "> 336</ span > 339< span id ="337 "> 337</ span > 340< span id ="338 "> 338</ span > 341< span id ="339 "> 339</ span > 342< span id ="340 "> 340</ span > 343< span id ="341 "> 341</ span > 344< span id ="342 "> 342</ span > 345< span id ="343 "> 343</ span > 346< span id ="344 "> 344</ span > 347< span id ="345 "> 345</ span > 348< span id ="346 "> 346</ span > 349< span id ="347 "> 347</ span > 350< span id ="348 "> 348</ span > 351< span id ="349 "> 349</ span > 352< span id ="350 "> 350</ span > 353< span id ="351 "> 351</ span > 354< span id ="352 "> 352</ span > 355< span id ="353 "> 353</ span > 356< span id ="354 "> 354</ span > 357< span id ="355 "> 355</ span > 358< span id ="356 "> 356</ span > 359< span id ="357 "> 357</ span > 360< span id ="358 "> 358</ span > 361< span id ="359 "> 359</ span > 362< span id ="360 "> 360</ span > 363< span id ="361 "> 361</ span > 364< span id ="362 "> 362</ span > 365< span id ="363 "> 363</ span > 366< span id ="364 "> 364</ span > 367< span id ="365 "> 365</ span > 368< span id ="366 "> 366</ span > 369< span id ="367 "> 367</ span > 370< span id ="368 "> 368</ span > 371< span id ="369 "> 369</ span > 372< span id ="370 "> 370</ span > 373< span id ="371 "> 371</ span > 374< span id ="372 "> 372</ span > 375< span id ="373 "> 373</ span > 376< span id ="374 "> 374</ span > 377< span id ="375 "> 375</ span > 378< span id ="376 "> 376</ span > 379< span id ="377 "> 377</ span > 380< span id ="378 "> 378</ span > 381< span id ="379 "> 379</ span > 382< span id ="380 "> 380</ span > 383< span id ="381 "> 381</ span > 384< span id ="382 "> 382</ span > 385< span id ="383 "> 383</ span > 386< span id ="384 "> 384</ span > 387< span id ="385 "> 385</ span > 388< span id ="386 "> 386</ span > 389< span id ="387 "> 387</ span > 390< span id ="388 "> 388</ span > 391< span id ="389 "> 389</ span > 392< span id ="390 "> 390</ span > 393< span id ="391 "> 391</ span > 394< span id ="392 "> 392</ span > 395< span id ="393 "> 393</ span > 396< span id ="394 "> 394</ span > 397< span id ="395 "> 395</ span > 398< span id ="396 "> 396</ span > 399< span id ="397 "> 397</ span > 400< span id ="398 "> 398</ span > 401< span id ="399 "> 399</ span > 402< span id ="400 "> 400</ span > 403< span id ="401 "> 401</ span > 404< span id ="402 "> 402</ span > 405< span id ="403 "> 403</ span > 406< span id ="404 "> 404</ span > 407< span id ="405 "> 405</ span > 408< span id ="406 "> 406</ span > 409< span id ="407 "> 407</ span > 410< span id ="408 "> 408</ span > 411< span id ="409 "> 409</ span > 412< span id ="410 "> 410</ span > 413< span id ="411 "> 411</ span > 414< span id ="412 "> 412</ span > 415< span id ="413 "> 413</ span > 416< span id ="414 "> 414</ span > 417< span id ="415 "> 415</ span > 418< span id ="416 "> 416</ span > 419< span id ="417 "> 417</ span > 420< span id ="418 "> 418</ span > 421< span id ="419 "> 419</ span > 422< span id ="420 "> 420</ span > 423< span id ="421 "> 421</ span > 424< span id ="422 "> 422</ span > 425< span id ="423 "> 423</ span > 426< span id ="424 "> 424</ span > 427< span id ="425 "> 425</ span > 428< span id ="426 "> 426</ span > 429< span id ="427 "> 427</ span > 430< span id ="428 "> 428</ span > 431< span id ="429 "> 429</ span > 432< span id ="430 "> 430</ span > 433< span id ="431 "> 431</ span > 434< span id ="432 "> 432</ span > 435< span id ="433 "> 433</ span > 436< span id ="434 "> 434</ span > 437< span id ="435 "> 435</ span > 438< span id ="436 "> 436</ span > 439< span id ="437 "> 437</ span > 440< span id ="438 "> 438</ span > 441< span id ="439 "> 439</ span > 442< span id ="440 "> 440</ span > 443< span id ="441 "> 441</ span > 444< span id ="442 "> 442</ span > 445< span id ="443 "> 443</ span > 446< span id ="444 "> 444</ span > 447< span id ="445 "> 445</ span > 448< span id ="446 "> 446</ span > 449< span id ="447 "> 447</ span > 450< span id ="448 "> 448</ span > 451< span id ="449 "> 449</ span > 452< span id ="450 "> 450</ span > 453< span id ="451 "> 451</ span > 454< span id ="452 "> 452</ span > 455< span id ="453 "> 453</ span > 456< span id ="454 "> 454</ span > 457< span id ="455 "> 455</ span > 458< span id ="456 "> 456</ span > 459< span id ="457 "> 457</ span > 460< span id ="458 "> 458</ span > 461< span id ="459 "> 459</ span > 462< span id ="460 "> 460</ span > 463< span id ="461 "> 461</ span > 464< span id ="462 "> 462</ span > 465< span id ="463 "> 463</ span > 466< span id ="464 "> 464</ span > 467< span id ="465 "> 465</ span > 468< span id ="466 "> 466</ span > 469< span id ="467 "> 467</ span > 470< span id ="468 "> 468</ span > 471< span id ="469 "> 469</ span > 472< span id ="470 "> 470</ span > 473< span id ="471 "> 471</ span > 474< span id ="472 "> 472</ span > 475< span id ="473 "> 473</ span > 476< span id ="474 "> 474</ span > 477< span id ="475 "> 475</ span > 478< span id ="476 "> 476</ span > 479< span id ="477 "> 477</ span > 480< span id ="478 "> 478</ span > 481< span id ="479 "> 479</ span > 482< span id ="480 "> 480</ span > 483< span id ="481 "> 481</ span > 484< span id ="482 "> 482</ span > 485< span id ="483 "> 483</ span > 486< span id ="484 "> 484</ span > 487< span id ="485 "> 485</ span > 488< span id ="486 "> 486</ span > 489< span id ="487 "> 487</ span > 490< span id ="488 "> 488</ span > 491< span id ="489 "> 489</ span > 492< span id ="490 "> 490</ span > 493< span id ="491 "> 491</ span > 494< span id ="492 "> 492</ span > 495< span id ="493 "> 493</ span > 496< span id ="494 "> 494</ span > 497< span id ="495 "> 495</ span > 498< span id ="496 "> 496</ span > 499< span id ="497 "> 497</ span > 500< span id ="498 "> 498</ span > 501< span id ="499 "> 499</ span > 502< span id ="500 "> 500</ span > 503< span id ="501 "> 501</ span > 504< span id ="502 "> 502</ span > 505< span id ="503 "> 503</ span > 506< span id ="504 "> 504</ span > 507< span id ="505 "> 505</ span > 508< span id ="506 "> 506</ span > 509< span id ="507 "> 507</ span > 510< span id ="508 "> 508</ span > 511< span id ="509 "> 509</ span > 512< span id ="510 "> 510</ span > 513< span id ="511 "> 511</ span > 514< span id ="512 "> 512</ span > 515< span id ="513 "> 513</ span > 516< span id ="514 "> 514</ span > 517< span id ="515 "> 515</ span > 518< span id ="516 "> 516</ span > 519< span id ="517 "> 517</ span > 520< span id ="518 "> 518</ span > 521< span id ="519 "> 519</ span > 522< span id ="520 "> 520</ span > 523< span id ="521 "> 521</ span > 524< span id ="522 "> 522</ span > 525< span id ="523 "> 523</ span > 526< span id ="524 "> 524</ span > 527< span id ="525 "> 525</ span > 528< span id ="526 "> 526</ span > 529< span id ="527 "> 527</ span > 530< span id ="528 "> 528</ span > 531< span id ="529 "> 529</ span > 532< span id ="530 "> 530</ span > 533< span id ="531 "> 531</ span > 534< span id ="532 "> 532</ span > 535< span id ="533 "> 533</ span > 536< span id ="534 "> 534</ span > 537< span id ="535 "> 535</ span > 538< span id ="536 "> 536</ span > 539< span id ="537 "> 537</ span > 540< span id ="538 "> 538</ span > 541< span id ="539 "> 539</ span > 542< span id ="540 "> 540</ span > 543< span id ="541 "> 541</ span > 544< span id ="542 "> 542</ span > 545< span id ="543 "> 543</ span > 546< span id ="544 "> 544</ span > 547< span id ="545 "> 545</ span > 548< span id ="546 "> 546</ span > 549< span id ="547 "> 547</ span > 550< span id ="548 "> 548</ span > 551< span id ="549 "> 549</ span > 552< span id ="550 "> 550</ span > 553< span id ="551 "> 551</ span > 554< span id ="552 "> 552</ span > 555< span id ="553 "> 553</ span > 556< span id ="554 "> 554</ span > 557< span id ="555 "> 555</ span > 558< span id ="556 "> 556</ span > 559< span id ="557 "> 557</ span > 560< span id ="558 "> 558</ span > 561< span id ="559 "> 559</ span > 562< span id ="560 "> 560</ span > 563< span id ="561 "> 561</ span > 564< span id ="562 "> 562</ span > 565< span id ="563 "> 563</ span > 566< span id ="564 "> 564</ span > 567< span id ="565 "> 565</ span > 568< span id ="566 "> 566</ span > 569< span id ="567 "> 567</ span > 570< span id ="568 "> 568</ span > 571< span id ="569 "> 569</ span > 572< span id ="570 "> 570</ span > 573< span id ="571 "> 571</ span > 574< span id ="572 "> 572</ span > 575< span id ="573 "> 573</ span > 576< span id ="574 "> 574</ span > 577< span id ="575 "> 575</ span > 578< span id ="576 "> 576</ span > 579< span id ="577 "> 577</ span > 580< span id ="578 "> 578</ span > 581< span id ="579 "> 579</ span > 582< span id ="580 "> 580</ span > 583< span id ="581 "> 581</ span > 584< span id ="582 "> 582</ span > 585< span id ="583 "> 583</ span > 586< span id ="584 "> 584</ span > 587< span id ="585 "> 585</ span > 588< span id ="586 "> 586</ span > 589< span id ="587 "> 587</ span > 590< span id ="588 "> 588</ span > 591< span id ="589 "> 589</ span > 592< span id ="590 "> 590</ span > 593< span id ="591 "> 591</ span > 594< span id ="592 "> 592</ span > 595< span id ="593 "> 593</ span > 596< span id ="594 "> 594</ span > 597< span id ="595 "> 595</ span > 598< span id ="596 "> 596</ span > 599< span id ="597 "> 597</ span > 600< span id ="598 "> 598</ span > 601< span id ="599 "> 599</ span > 602< span id ="600 "> 600</ span > 603< span id ="601 "> 601</ span > 604< span id ="602 "> 602</ span > 605< span id ="603 "> 603</ span > 606< span id ="604 "> 604</ span > 607< span id ="605 "> 605</ span > 608< span id ="606 "> 606</ span > 609< span id ="607 "> 607</ span > 610< span id ="608 "> 608</ span > 611< span id ="609 "> 609</ span > 612< span id ="610 "> 610</ span > 613< span id ="611 "> 611</ span > 614< span id ="612 "> 612</ span > 615< span id ="613 "> 613</ span > 616< span id ="614 "> 614</ span > 617< span id ="615 "> 615</ span > 618< span id ="616 "> 616</ span > 619< span id ="617 "> 617</ span > 620< span id ="618 "> 618</ span > 621< span id ="619 "> 619</ span > 622< span id ="620 "> 620</ span > 623< span id ="621 "> 621</ span > 624< span id ="622 "> 622</ span > 625< span id ="623 "> 623</ span > 626< span id ="624 "> 624</ span > 627< span id ="625 "> 625</ span > 628< span id ="626 "> 626</ span > 629< span id ="627 "> 627</ span > 630< span id ="628 "> 628</ span > 631< span id ="629 "> 629</ span > 632< span id ="630 "> 630</ span > 633< span id ="631 "> 631</ span > 634< span id ="632 "> 632</ span > 635< span id ="633 "> 633</ span > 636< span id ="634 "> 634</ span > 637< span id ="635 "> 635</ span > 638< span id ="636 "> 636</ span > 639< span id ="637 "> 637</ span > 640< span id ="638 "> 638</ span > 641< span id ="639 "> 639</ span > 642< span id ="640 "> 640</ span > 643< span id ="641 "> 641</ span > 644< span id ="642 "> 642</ span > 645< span id ="643 "> 643</ span > 646< span id ="644 "> 644</ span > 647< span id ="645 "> 645</ span > 648< span id ="646 "> 646</ span > 649< span id ="647 "> 647</ span > 650< span id ="648 "> 648</ span > 651< span id ="649 "> 649</ span > 652< span id ="650 "> 650</ span > 653< span id ="651 "> 651</ span > 654< span id ="652 "> 652</ span > 655< span id ="653 "> 653</ span > 656< span id ="654 "> 654</ span > 657< span id ="655 "> 655</ span > 658< span id ="656 "> 656</ span > 659< span id ="657 "> 657</ span > 660< span id ="658 "> 658</ span > 661< span id ="659 "> 659</ span > 662< span id ="660 "> 660</ span > 663< span id ="661 "> 661</ span > 664< span id ="662 "> 662</ span > 665< span id ="663 "> 663</ span > 666< span id ="664 "> 664</ span > 667< span id ="665 "> 665</ span > 668< span id ="666 "> 666</ span > 669< span id ="667 "> 667</ span > 670< span id ="668 "> 668</ span > 671< span id ="669 "> 669</ span > 672< span id ="670 "> 670</ span > 673< span id ="671 "> 671</ span > 674< span id ="672 "> 672</ span > 675< span id ="673 "> 673</ span > 676< span id ="674 "> 674</ span > 677< span id ="675 "> 675</ span > 678< span id ="676 "> 676</ span > 679< span id ="677 "> 677</ span > 680< span id ="678 "> 678</ span > 681< span id ="679 "> 679</ span > 682< span id ="680 "> 680</ span > 683< span id ="681 "> 681</ span > 684< span id ="682 "> 682</ span > 685< span id ="683 "> 683</ span > 686< span id ="684 "> 684</ span > 687< span id ="685 "> 685</ span > 688< span id ="686 "> 686</ span > 689< span id ="687 "> 687</ span > 690< span id ="688 "> 688</ span > 691< span id ="689 "> 689</ span > 692< span id ="690 "> 690</ span > 693< span id ="691 "> 691</ span > 694< span id ="692 "> 692</ span > 695< span id ="693 "> 693</ span > 696< span id ="694 "> 694</ span > 697< span id ="695 "> 695</ span > 698< span id ="696 "> 696</ span > 699< span id ="697 "> 697</ span > 700< span id ="698 "> 698</ span > 701< span id ="699 "> 699</ span > 702< span id ="700 "> 700</ span > 703< span id ="701 "> 701</ span > 704< span id ="702 "> 702</ span > 705< span id ="703 "> 703</ span > 706< span id ="704 "> 704</ span > 707< span id ="705 "> 705</ span > 708< span id ="706 "> 706</ span > 709< span id ="707 "> 707</ span > 710< span id ="708 "> 708</ span > 711< span id ="709 "> 709</ span > 712< span id ="710 "> 710</ span > 713< span id ="711 "> 711</ span > 714< span id ="712 "> 712</ span > 715< span id ="713 "> 713</ span > 716< span id ="714 "> 714</ span > 717< span id ="715 "> 715</ span > 718< span id ="716 "> 716</ span > 719< span id ="717 "> 717</ span > 720< span id ="718 "> 718</ span > 721< span id ="719 "> 719</ span > 722< span id ="720 "> 720</ span > 723< span id ="721 "> 721</ span > 724< span id ="722 "> 722</ span > 725< span id ="723 "> 723</ span > 726< span id ="724 "> 724</ span > 727< span id ="725 "> 725</ span > 728< span id ="726 "> 726</ span > 729< span id ="727 "> 727</ span > 730< span id ="728 "> 728</ span > 731< span id ="729 "> 729</ span > 732< span id ="730 "> 730</ span > 733< span id ="731 "> 731</ span > 734< span id ="732 "> 732</ span > 735< span id ="733 "> 733</ span > 736< span id ="734 "> 734</ span > 737< span id ="735 "> 735</ span > 738< span id ="736 "> 736</ span > 739< span id ="737 "> 737</ span > 740< span id ="738 "> 738</ span > 741< span id ="739 "> 739</ span > 742< span id ="740 "> 740</ span > 743< span id ="741 "> 741</ span > 744< span id ="742 "> 742</ span > 745< span id ="743 "> 743</ span > 746< span id ="744 "> 744</ span > 747< span id ="745 "> 745</ span > 748< span id ="746 "> 746</ span > 749< span id ="747 "> 747</ span > 750< span id ="748 "> 748</ span > 751< span id ="749 "> 749</ span > 752< span id ="750 "> 750</ span > 753< span id ="751 "> 751</ span > 754< span id ="752 "> 752</ span > 755< span id ="753 "> 753</ span > 756< span id ="754 "> 754</ span > 757< span id ="755 "> 755</ span > 758< span id ="756 "> 756</ span > 759< span id ="757 "> 757</ span > 760< span id ="758 "> 758</ span > 761< span id ="759 "> 759</ span > 762< span id ="760 "> 760</ span > 763< span id ="761 "> 761</ span > 764< span id ="762 "> 762</ span > 765< span id ="763 "> 763</ span > 766< span id ="764 "> 764</ span > 767< span id ="765 "> 765</ span > 768< span id ="766 "> 766</ span > 769< span id ="767 "> 767</ span > 770< span id ="768 "> 768</ span > 771< span id ="769 "> 769</ span > 772< span id ="770 "> 770</ span > 773< span id ="771 "> 771</ span > 774< span id ="772 "> 772</ span > 775< span id ="773 "> 773</ span > 776< span id ="774 "> 774</ span > 777< span id ="775 "> 775</ span > 778< span id ="776 "> 776</ span > 779< span id ="777 "> 777</ span > 780< span id ="778 "> 778</ span > 781< span id ="779 "> 779</ span > 782< span id ="780 "> 780</ span > 783< span id ="781 "> 781</ span > 784< span id ="782 "> 782</ span > 785< span id ="783 "> 783</ span > 786< span id ="784 "> 784</ span > 787< span id ="785 "> 785</ span > 788< span id ="786 "> 786</ span > 789< span id ="787 "> 787</ span > 790< span id ="788 "> 788</ span > 791< span id ="789 "> 789</ span > 792< span id ="790 "> 790</ span > 793< span id ="791 "> 791</ span > 794< span id ="792 "> 792</ span > 795< span id ="793 "> 793</ span > 796< span id ="794 "> 794</ span > 797< span id ="795 "> 795</ span > 798< span id ="796 "> 796</ span > 799< span id ="797 "> 797</ span > 800< span id ="798 "> 798</ span > 801< span id ="799 "> 799</ span > 802< span id ="800 "> 800</ span > 803< span id ="801 "> 801</ span > 804< span id ="802 "> 802</ span > 805< span id ="803 "> 803</ span > 806< span id ="804 "> 804</ span > 807< span id ="805 "> 805</ span > 808< span id ="806 "> 806</ span > 809< span id ="807 "> 807</ span > 810< span id ="808 "> 808</ span > 811< span id ="809 "> 809</ span > 812< span id ="810 "> 810</ span > 813< span id ="811 "> 811</ span > 814< span id ="812 "> 812</ span > 815< span id ="813 "> 813</ span > 816< span id ="814 "> 814</ span > 817< span id ="815 "> 815</ span > 818< span id ="816 "> 816</ span > 819< span id ="817 "> 817</ span > 820< span id ="818 "> 818</ span > 821< span id ="819 "> 819</ span > 822< span id ="820 "> 820</ span > 823< span id ="821 "> 821</ span > 824< span id ="822 "> 822</ span > 825< span id ="823 "> 823</ span > 826< span id ="824 "> 824</ span > 827< span id ="825 "> 825</ span > 828< span id ="826 "> 826</ span > 829< span id ="827 "> 827</ span > 830< span id ="828 "> 828</ span > 831< span id ="829 "> 829</ span > 832< span id ="830 "> 830</ span > 833< span id ="831 "> 831</ span > 834< span id ="832 "> 832</ span > 835< span id ="833 "> 833</ span > 836< span id ="834 "> 834</ span > 837< span id ="835 "> 835</ span > 838< span id ="836 "> 836</ span > 839< span id ="837 "> 837</ span > 840< span id ="838 "> 838</ span > 841< span id ="839 "> 839</ span > 842< span id ="840 "> 840</ span > 843< span id ="841 "> 841</ span > 844< span id ="842 "> 842</ span > 845< span id ="843 "> 843</ span > 846< span id ="844 "> 844</ span > 847< span id ="845 "> 845</ span > 848< span id ="846 "> 846</ span > 849< span id ="847 "> 847</ span > 850< span id ="848 "> 848</ span > 851< span id ="849 "> 849</ span > 852< span id ="850 "> 850</ span > 853< span id ="851 "> 851</ span > 854< span id ="852 "> 852</ span > 855< span id ="853 "> 853</ span > 856< span id ="854 "> 854</ span > 857< span id ="855 "> 855</ span > 858< span id ="856 "> 856</ span > 859< span id ="857 "> 857</ span > 860< span id ="858 "> 858</ span > 861< span id ="859 "> 859</ span > 862< span id ="860 "> 860</ span > 863< span id ="861 "> 861</ span > 864< span id ="862 "> 862</ span > 865< span id ="863 "> 863</ span > 866< span id ="864 "> 864</ span > 867< span id ="865 "> 865</ span > 868< span id ="866 "> 866</ span > 869< span id ="867 "> 867</ span > 870< span id ="868 "> 868</ span > 871< span id ="869 "> 869</ span > 872< span id ="870 "> 870</ span > 873< span id ="871 "> 871</ span > 874< span id ="872 "> 872</ span > 875< span id ="873 "> 873</ span > 876< span id ="874 "> 874</ span > 877< span id ="875 "> 875</ span > 878< span id ="876 "> 876</ span > 879< span id ="877 "> 877</ span > 880< span id ="878 "> 878</ span > 881< span id ="879 "> 879</ span > 882< span id ="880 "> 880</ span > 883< span id ="881 "> 881</ span > 884< span id ="882 "> 882</ span > 885< span id ="883 "> 883</ span > 886< span id ="884 "> 884</ span > 887< span id ="885 "> 885</ span > 888< span id ="886 "> 886</ span > 889< span id ="887 "> 887</ span > 890< span id ="888 "> 888</ span > 891< span id ="889 "> 889</ span > 892< span id ="890 "> 890</ span > 893< span id ="891 "> 891</ span > 894< span id ="892 "> 892</ span > 895< span id ="893 "> 893</ span > 896< span id ="894 "> 894</ span > 897< span id ="895 "> 895</ span > 898< span id ="896 "> 896</ span > 899< span id ="897 "> 897</ span > 900< span id ="898 "> 898</ span > 901< span id ="899 "> 899</ span > 902< span id ="900 "> 900</ span > 903< span id ="901 "> 901</ span > 904< span id ="902 "> 902</ span > 905< span id ="903 "> 903</ span > 906< span id ="904 "> 904</ span > 907< span id ="905 "> 905</ span > 908< span id ="906 "> 906</ span > 909< span id ="907 "> 907</ span > 910< span id ="908 "> 908</ span > 911< span id ="909 "> 909</ span > 912< span id ="910 "> 910</ span > 913< span id ="911 "> 911</ span > 914< span id ="912 "> 912</ span > 915< span id ="913 "> 913</ span > 916< span id ="914 "> 914</ span > 917< span id ="915 "> 915</ span > 918< span id ="916 "> 916</ span > 919< span id ="917 "> 917</ span > 920< span id ="918 "> 918</ span > 921< span id ="919 "> 919</ span > 922< span id ="920 "> 920</ span > 923< span id ="921 "> 921</ span > 924< span id ="922 "> 922</ span > 925< span id ="923 "> 923</ span > 926< span id ="924 "> 924</ span > 927< span id ="925 "> 925</ span > 928< span id ="926 "> 926</ span > 929< span id ="927 "> 927</ span > 930< span id ="928 "> 928</ span > 931< span id ="929 "> 929</ span > 932< span id ="930 "> 930</ span > 933< span id ="931 "> 931</ span > 934< span id ="932 "> 932</ span > 935< span id ="933 "> 933</ span > 936< span id ="934 "> 934</ span > 937< span id ="935 "> 935</ span > 938< span id ="936 "> 936</ span > 939< span id ="937 "> 937</ span > 940< span id ="938 "> 938</ span > 941< span id ="939 "> 939</ span > 942< span id ="940 "> 940</ span > 943< span id ="941 "> 941</ span > 944< span id ="942 "> 942</ span > 945< span id ="943 "> 943</ span > 946< span id ="944 "> 944</ span > 947< span id ="945 "> 945</ span > 948< span id ="946 "> 946</ span > 949< span id ="947 "> 947</ span > 950< span id ="948 "> 948</ span > 951< span id ="949 "> 949</ span > 952< span id ="950 "> 950</ span > 953< span id ="951 "> 951</ span > 954< span id ="952 "> 952</ span > 955< span id ="953 "> 953</ span > 956< span id ="954 "> 954</ span > 957< span id ="955 "> 955</ span > 958< span id ="956 "> 956</ span > 959< span id ="957 "> 957</ span > 960< span id ="958 "> 958</ span > 961< span id ="959 "> 959</ span > 962< span id ="960 "> 960</ span > 963< span id ="961 "> 961</ span > 964< span id ="962 "> 962</ span > 965< span id ="963 "> 963</ span > 966< span id ="964 "> 964</ span > 967< span id ="965 "> 965</ span > 968< span id ="966 "> 966</ span > 969< span id ="967 "> 967</ span > 970< span id ="968 "> 968</ span > 971< span id ="969 "> 969</ span > 972< span id ="970 "> 970</ span > 973< span id ="971 "> 971</ span > 974< span id ="972 "> 972</ span > 975< span id ="973 "> 973</ span > 976< span id ="974 "> 974</ span > 977< span id ="975 "> 975</ span > 978< span id ="976 "> 976</ span > 979< span id ="977 "> 977</ span > 980< span id ="978 "> 978</ span > 981< span id ="979 "> 979</ span > 982< span id ="980 "> 980</ span > 983< span id ="981 "> 981</ span > 984< span id ="982 "> 982</ span > 985< span id ="983 "> 983</ span > 986< span id ="984 "> 984</ span > 987< span id ="985 "> 985</ span > 988< span id ="986 "> 986</ span > 989< span id ="987 "> 987</ span > 990< span id ="988 "> 988</ span > 991< span id ="989 "> 989</ span > 992< span id ="990 "> 990</ span > 993< span id ="991 "> 991</ span > 994< span id ="992 "> 992</ span > 995< span id ="993 "> 993</ span > 996< span id ="994 "> 994</ span > 997< span id ="995 "> 995</ span > 998< span id ="996 "> 996</ span > 999< span id ="997 "> 997</ span > 1000< span id ="998 "> 998</ span > 1001< span id ="999 "> 999</ span > 1002< span id ="1000 "> 1000</ span > 1003< span id ="1001 "> 1001</ span > 1004< span id ="1002 "> 1002</ span > 1005< span id ="1003 "> 1003</ span > 1006< span id ="1004 "> 1004</ span > 1007< span id ="1005 "> 1005</ span > 1008< span id ="1006 "> 1006</ span > 1009< span id ="1007 "> 1007</ span > 1010< span id ="1008 "> 1008</ span > 1011< span id ="1009 "> 1009</ span > 1012< span id ="1010 "> 1010</ span > 1013< span id ="1011 "> 1011</ span > 1014< span id ="1012 "> 1012</ span > 1015< span id ="1013 "> 1013</ span > 1016< span id ="1014 "> 1014</ span > 1017< span id ="1015 "> 1015</ span > 1018< span id ="1016 "> 1016</ span > 1019< span id ="1017 "> 1017</ span > 1020< span id ="1018 "> 1018</ span > 1021< span id ="1019 "> 1019</ span > 1022< span id ="1020 "> 1020</ span > 1023< span id ="1021 "> 1021</ span > 1024< span id ="1022 "> 1022</ span > 1025< span id ="1023 "> 1023</ span > 1026< span id ="1024 "> 1024</ span > 1027< span id ="1025 "> 1025</ span > 1028< span id ="1026 "> 1026</ span > 1029< span id ="1027 "> 1027</ span > 1030< span id ="1028 "> 1028</ span > 1031< span id ="1029 "> 1029</ span > 1032< span id ="1030 "> 1030</ span > 1033< span id ="1031 "> 1031</ span > 1034< span id ="1032 "> 1032</ span > 1035< span id ="1033 "> 1033</ span > 1036< span id ="1034 "> 1034</ span > 1037< span id ="1035 "> 1035</ span > 1038< span id ="1036 "> 1036</ span > 1039< span id ="1037 "> 1037</ span > 1040< span id ="1038 "> 1038</ span > 1041< span id ="1039 "> 1039</ span > 1042< span id ="1040 "> 1040</ span > 1043< span id ="1041 "> 1041</ span > 1044< span id ="1042 "> 1042</ span > 1045< span id ="1043 "> 1043</ span > 1046< span id ="1044 "> 1044</ span > 1047< span id ="1045 "> 1045</ span > 1048< span id ="1046 "> 1046</ span > 1049< span id ="1047 "> 1047</ span > 1050< span id ="1048 "> 1048</ span > 1051< span id ="1049 "> 1049</ span > 1052< span id ="1050 "> 1050</ span > 1053< span id ="1051 "> 1051</ span > 1054< span id ="1052 "> 1052</ span > 1055< span id ="1053 "> 1053</ span > 1056< span id ="1054 "> 1054</ span > 1057< span id ="1055 "> 1055</ span > 1058< span id ="1056 "> 1056</ span > 1059< span id ="1057 "> 1057</ span > 1060< span id ="1058 "> 1058</ span > 1061< span id ="1059 "> 1059</ span > 1062< span id ="1060 "> 1060</ span > 1063< span id ="1061 "> 1061</ span > 1064< span id ="1062 "> 1062</ span > 1065< span id ="1063 "> 1063</ span > 1066< span id ="1064 "> 1064</ span > 1067< span id ="1065 "> 1065</ span > 1068< span id ="1066 "> 1066</ span > 1069< span id ="1067 "> 1067</ span > 1070< span id ="1068 "> 1068</ span > 1071< span id ="1069 "> 1069</ span > 1072< span id ="1070 "> 1070</ span > 1073< span id ="1071 "> 1071</ span > 1074< span id ="1072 "> 1072</ span > 1075< span id ="1073 "> 1073</ span > 1076< span id ="1074 "> 1074</ span > 1077< span id ="1075 "> 1075</ span > 1078< span id ="1076 "> 1076</ span > 1079< span id ="1077 "> 1077</ span > 1080< span id ="1078 "> 1078</ span > 1081< span id ="1079 "> 1079</ span > 1082< span id ="1080 "> 1080</ span > 1083< span id ="1081 "> 1081</ span > 1084< span id ="1082 "> 1082</ span > 1085< span id ="1083 "> 1083</ span > 1086< span id ="1084 "> 1084</ span > 1087< span id ="1085 "> 1085</ span > 1088< span id ="1086 "> 1086</ span > 1089< span id ="1087 "> 1087</ span > 1090< span id ="1088 "> 1088</ span > 1091< span id ="1089 "> 1089</ span > 1092< span id ="1090 "> 1090</ span > 1093< span id ="1091 "> 1091</ span > 1094< span id ="1092 "> 1092</ span > 1095< span id ="1093 "> 1093</ span > 1096< span id ="1094 "> 1094</ span > 1097< span id ="1095 "> 1095</ span > 1098< span id ="1096 "> 1096</ span > 1099< span id ="1097 "> 1097</ span > 1100< span id ="1098 "> 1098</ span > 1101< span id ="1099 "> 1099</ span > 1102< span id ="1100 "> 1100</ span > 1103< span id ="1101 "> 1101</ span > 1104< span id ="1102 "> 1102</ span > 1105< span id ="1103 "> 1103</ span > 1106< span id ="1104 "> 1104</ span > 1107< span id ="1105 "> 1105</ span > 1108< span id ="1106 "> 1106</ span > 1109< span id ="1107 "> 1107</ span > 1110< span id ="1108 "> 1108</ span > 1111< span id ="1109 "> 1109</ span > 1112< span id ="1110 "> 1110</ span > 1113< span id ="1111 "> 1111</ span > 1114< span id ="1112 "> 1112</ span > 1115< span id ="1113 "> 1113</ span > 1116< span id ="1114 "> 1114</ span > 1117< span id ="1115 "> 1115</ span > 1118< span id ="1116 "> 1116</ span > 1119< span id ="1117 "> 1117</ span > 1120< span id ="1118 "> 1118</ span > 1121< span id ="1119 "> 1119</ span > 1122< span id ="1120 "> 1120</ span > 1123< span id ="1121 "> 1121</ span > 1124< span id ="1122 "> 1122</ span > 1125< span id ="1123 "> 1123</ span > 1126< span id ="1124 "> 1124</ span > 1127< span id ="1125 "> 1125</ span > 1128< span id ="1126 "> 1126</ span > 1129< span id ="1127 "> 1127</ span > 1130< span id ="1128 "> 1128</ span > 1131< span id ="1129 "> 1129</ span > 1132< span id ="1130 "> 1130</ span > 1133< span id ="1131 "> 1131</ span > 1134< span id ="1132 "> 1132</ span > 1135< span id ="1133 "> 1133</ span > 1136< span id ="1134 "> 1134</ span > 1137< span id ="1135 "> 1135</ span > 1138< span id ="1136 "> 1136</ span > 1139< span id ="1137 "> 1137</ span > 1140< span id ="1138 "> 1138</ span > 1141< span id ="1139 "> 1139</ span > 1142< span id ="1140 "> 1140</ span > 1143< span id ="1141 "> 1141</ span > 1144< span id ="1142 "> 1142</ span > 1145< span id ="1143 "> 1143</ span > 1146< span id ="1144 "> 1144</ span > 1147< span id ="1145 "> 1145</ span > 1148< span id ="1146 "> 1146</ span > 1149< span id ="1147 "> 1147</ span > 1150< span id ="1148 "> 1148</ span > 1151< span id ="1149 "> 1149</ span > 1152< span id ="1150 "> 1150</ span > 1153< span id ="1151 "> 1151</ span > 1154< span id ="1152 "> 1152</ span > 1155< span id ="1153 "> 1153</ span > 1156< span id ="1154 "> 1154</ span > 1157< span id ="1155 "> 1155</ span > 1158< span id ="1156 "> 1156</ span > 1159< span id ="1157 "> 1157</ span > 1160< span id ="1158 "> 1158</ span > 1161< span id ="1159 "> 1159</ span > 1162< span id ="1160 "> 1160</ span > 1163< span id ="1161 "> 1161</ span > 1164< span id ="1162 "> 1162</ span > 1165< span id ="1163 "> 1163</ span > 1166< span id ="1164 "> 1164</ span > 1167< span id ="1165 "> 1165</ span > 1168< span id ="1166 "> 1166</ span > 1169< span id ="1167 "> 1167</ span > 1170< span id ="1168 "> 1168</ span > 1171< span id ="1169 "> 1169</ span > 1172< span id ="1170 "> 1170</ span > 1173< span id ="1171 "> 1171</ span > 1174< span id ="1172 "> 1172</ span > 1175< span id ="1173 "> 1173</ span > 1176< span id ="1174 "> 1174</ span > 1177< span id ="1175 "> 1175</ span > 1178< span id ="1176 "> 1176</ span > 1179< span id ="1177 "> 1177</ span > 1180< span id ="1178 "> 1178</ span > 1181< span id ="1179 "> 1179</ span > 1182< span id ="1180 "> 1180</ span > 1183< span id ="1181 "> 1181</ span > 1184< span id ="1182 "> 1182</ span > 1185< span id ="1183 "> 1183</ span > 1186< span id ="1184 "> 1184</ span > 1187< span id ="1185 "> 1185</ span > 1188< span id ="1186 "> 1186</ span > 1189< span id ="1187 "> 1187</ span > 1190< span id ="1188 "> 1188</ span > 1191< span id ="1189 "> 1189</ span > 1192< span id ="1190 "> 1190</ span > 1193< span id ="1191 "> 1191</ span > 1194< span id ="1192 "> 1192</ span > 1195< span id ="1193 "> 1193</ span > 1196< span id ="1194 "> 1194</ span > 1197< span id ="1195 "> 1195</ span > 1198< span id ="1196 "> 1196</ span > 1199< span id ="1197 "> 1197</ span > 1200< span id ="1198 "> 1198</ span > 1201< span id ="1199 "> 1199</ span > 1202< span id ="1200 "> 1200</ span > 1203< span id ="1201 "> 1201</ span > 1204< span id ="1202 "> 1202</ span > 1205< span id ="1203 "> 1203</ span > 1206< span id ="1204 "> 1204</ span > 1207< span id ="1205 "> 1205</ span > 1208< span id ="1206 "> 1206</ span > 1209< span id ="1207 "> 1207</ span > 1210< span id ="1208 "> 1208</ span > 1211< span id ="1209 "> 1209</ span > 1212< span id ="1210 "> 1210</ span > 1213< span id ="1211 "> 1211</ span > 1214< span id ="1212 "> 1212</ span > 1215< span id ="1213 "> 1213</ span > 1216< span id ="1214 "> 1214</ span > 1217< span id ="1215 "> 1215</ span > 1218< span id ="1216 "> 1216</ span > 1219< span id ="1217 "> 1217</ span > 1220< span id ="1218 "> 1218</ span > 1221< span id ="1219 "> 1219</ span > 1222< span id ="1220 "> 1220</ span > 1223< span id ="1221 "> 1221</ span > 1224< span id ="1222 "> 1222</ span > 1225< span id ="1223 "> 1223</ span > 1226< span id ="1224 "> 1224</ span > 1227< span id ="1225 "> 1225</ span > 1228< span id ="1226 "> 1226</ span > 1229< span id ="1227 "> 1227</ span > 1230< span id ="1228 "> 1228</ span > 1231< span id ="1229 "> 1229</ span > 1232< span id ="1230 "> 1230</ span > 1233< span id ="1231 "> 1231</ span > 1234< span id ="1232 "> 1232</ span > 1235< span id ="1233 "> 1233</ span > 1236< span id ="1234 "> 1234</ span > 1237< span id ="1235 "> 1235</ span > 1238< span id ="1236 "> 1236</ span > 1239< span id ="1237 "> 1237</ span > 1240< span id ="1238 "> 1238</ span > 1241< span id ="1239 "> 1239</ span > 1242< span id ="1240 "> 1240</ span > 1243< span id ="1241 "> 1241</ span > 1244< span id ="1242 "> 1242</ span > 1245< span id ="1243 "> 1243</ span > 1246< span id ="1244 "> 1244</ span > 1247< span id ="1245 "> 1245</ span > 1248< span id ="1246 "> 1246</ span > 1249< span id ="1247 "> 1247</ span > 1250< span id ="1248 "> 1248</ span > 1251< span id ="1249 "> 1249</ span > 1252< span id ="1250 "> 1250</ span > 1253< span id ="1251 "> 1251</ span > 1254< span id ="1252 "> 1252</ span > 1255< span id ="1253 "> 1253</ span > 1256< span id ="1254 "> 1254</ span > 1257< span id ="1255 "> 1255</ span > 1258< span id ="1256 "> 1256</ span > 1259< span id ="1257 "> 1257</ span > 1260< span id ="1258 "> 1258</ span > 1261< span id ="1259 "> 1259</ span > 1262< span id ="1260 "> 1260</ span > 1263< span id ="1261 "> 1261</ span > 1264< span id ="1262 "> 1262</ span > 1265< span id ="1263 "> 1263</ span > 1266< span id ="1264 "> 1264</ span > 1267< span id ="1265 "> 1265</ span > 1268< span id ="1266 "> 1266</ span > 1269< span id ="1267 "> 1267</ span > 1270< span id ="1268 "> 1268</ span > 1271< span id ="1269 "> 1269</ span > 1272< span id ="1270 "> 1270</ span > 1273< span id ="1271 "> 1271</ span > 1274< span id ="1272 "> 1272</ span > 1275< span id ="1273 "> 1273</ span > 1276< span id ="1274 "> 1274</ span > 1277< span id ="1275 "> 1275</ span > 1278< span id ="1276 "> 1276</ span > 1279< span id ="1277 "> 1277</ span > 1280< span id ="1278 "> 1278</ span > 1281< span id ="1279 "> 1279</ span > 1282< span id ="1280 "> 1280</ span > 1283< span id ="1281 "> 1281</ span > 1284< span id ="1282 "> 1282</ span > 1285< span id ="1283 "> 1283</ span > 1286< span id ="1284 "> 1284</ span > 1287< span id ="1285 "> 1285</ span > 1288< span id ="1286 "> 1286</ span > 1289< span id ="1287 "> 1287</ span > 1290< span id ="1288 "> 1288</ span > 1291< span id ="1289 "> 1289</ span > 1292< span id ="1290 "> 1290</ span > 1293< span id ="1291 "> 1291</ span > 1294< span id ="1292 "> 1292</ span > 1295< span id ="1293 "> 1293</ span > 1296< span id ="1294 "> 1294</ span > 1297< span id ="1295 "> 1295</ span > 1298< span id ="1296 "> 1296</ span > 1299< span id ="1297 "> 1297</ span > 1300< span id ="1298 "> 1298</ span > 1301< span id ="1299 "> 1299</ span > 1302< span id ="1300 "> 1300</ span > 1303< span id ="1301 "> 1301</ span > 1304< span id ="1302 "> 1302</ span > 1305< span id ="1303 "> 1303</ span > 1306< span id ="1304 "> 1304</ span > 1307< span id ="1305 "> 1305</ span > 1308< span id ="1306 "> 1306</ span > 1309< span id ="1307 "> 1307</ span > 1310< span id ="1308 "> 1308</ span > 1311< span id ="1309 "> 1309</ span > 1312< span id ="1310 "> 1310</ span > 1313< span id ="1311 "> 1311</ span > 1314< span id ="1312 "> 1312</ span > 1315< span id ="1313 "> 1313</ span > 1316< span id ="1314 "> 1314</ span > 1317< span id ="1315 "> 1315</ span > 1318< span id ="1316 "> 1316</ span > 1319< span id ="1317 "> 1317</ span > 1320< span id ="1318 "> 1318</ span > 1321< span id ="1319 "> 1319</ span > 1322< span id ="1320 "> 1320</ span > 1323< span id ="1321 "> 1321</ span > 1324< span id ="1322 "> 1322</ span > 1325< span id ="1323 "> 1323</ span > 1326< span id ="1324 "> 1324</ span > 1327< span id ="1325 "> 1325</ span > 1328< span id ="1326 "> 1326</ span > 1329< span id ="1327 "> 1327</ span > 1330< span id ="1328 "> 1328</ span > 1331< span id ="1329 "> 1329</ span > 1332< span id ="1330 "> 1330</ span > 1333< span id ="1331 "> 1331</ span > 1334< span id ="1332 "> 1332</ span > 1335< span id ="1333 "> 1333</ span > 1336< span id ="1334 "> 1334</ span > 1337< span id ="1335 "> 1335</ span > 1338< span id ="1336 "> 1336</ span > 1339< span id ="1337 "> 1337</ span > 1340< span id ="1338 "> 1338</ span > 1341< span id ="1339 "> 1339</ span > 1342< span id ="1340 "> 1340</ span > 1343< span id ="1341 "> 1341</ span > 1344< span id ="1342 "> 1342</ span > 1345< span id ="1343 "> 1343</ span > 1346< span id ="1344 "> 1344</ span > 1347< span id ="1345 "> 1345</ span > 1348< span id ="1346 "> 1346</ span > 1349< span id ="1347 "> 1347</ span > 1350< span id ="1348 "> 1348</ span > 1351< span id ="1349 "> 1349</ span > 1352< span id ="1350 "> 1350</ span > 1353< span id ="1351 "> 1351</ span > 1354< span id ="1352 "> 1352</ span > 1355< span id ="1353 "> 1353</ span > 1356< span id ="1354 "> 1354</ span > 1357< span id ="1355 "> 1355</ span > 1358< span id ="1356 "> 1356</ span > 1359< span id ="1357 "> 1357</ span > 1360< span id ="1358 "> 1358</ span > 1361< span id ="1359 "> 1359</ span > 1362< span id ="1360 "> 1360</ span > 1363< span id ="1361 "> 1361</ span > 1364< span id ="1362 "> 1362</ span > 1365< span id ="1363 "> 1363</ span > 1366< span id ="1364 "> 1364</ span > 1367< span id ="1365 "> 1365</ span > 1368< span id ="1366 "> 1366</ span > 1369< span id ="1367 "> 1367</ span > 1370< span id ="1368 "> 1368</ span > 1371< span id ="1369 "> 1369</ span > 1372< span id ="1370 "> 1370</ span > 1373< span id ="1371 "> 1371</ span > 1374< span id ="1372 "> 1372</ span > 1375< span id ="1373 "> 1373</ span > 1376< span id ="1374 "> 1374</ span > 1377< span id ="1375 "> 1375</ span > 1378< span id ="1376 "> 1376</ span > 1379< span id ="1377 "> 1377</ span > 1380< span id ="1378 "> 1378</ span > 1381< span id ="1379 "> 1379</ span > 1382< span id ="1380 "> 1380</ span > 1383< span id ="1381 "> 1381</ span > 1384< span id ="1382 "> 1382</ span > 1385< span id ="1383 "> 1383</ span > 1386< span id ="1384 "> 1384</ span > 1387< span id ="1385 "> 1385</ span > 1388< span id ="1386 "> 1386</ span > 1389< span id ="1387 "> 1387</ span > 1390< span id ="1388 "> 1388</ span > 1391< span id ="1389 "> 1389</ span > 1392< span id ="1390 "> 1390</ span > 1393< span id ="1391 "> 1391</ span > 1394< span id ="1392 "> 1392</ span > 1395< span id ="1393 "> 1393</ span > 1396< span id ="1394 "> 1394</ span > 1397< span id ="1395 "> 1395</ span > 1398< span id ="1396 "> 1396</ span > 1399< span id ="1397 "> 1397</ span > 1400< span id ="1398 "> 1398</ span > 1401< span id ="1399 "> 1399</ span > 1402< span id ="1400 "> 1400</ span > 1403< span id ="1401 "> 1401</ span > 1404< span id ="1402 "> 1402</ span > 1405< span id ="1403 "> 1403</ span > 1406< span id ="1404 "> 1404</ span > 1407< span id ="1405 "> 1405</ span > 1408< span id ="1406 "> 1406</ span > 1409< span id ="1407 "> 1407</ span > 1410< span id ="1408 "> 1408</ span > 1411< span id ="1409 "> 1409</ span > 1412< span id ="1410 "> 1410</ span > 1413< span id ="1411 "> 1411</ span > 1414< span id ="1412 "> 1412</ span > 1415< span id ="1413 "> 1413</ span > 1416< span id ="1414 "> 1414</ span > 1417< span id ="1415 "> 1415</ span > 1418< span id ="1416 "> 1416</ span > 1419< span id ="1417 "> 1417</ span > 1420< span id ="1418 "> 1418</ span > 1421< span id ="1419 "> 1419</ span > 1422< span id ="1420 "> 1420</ span > 1423< span id ="1421 "> 1421</ span > 1424< span id ="1422 "> 1422</ span > 1425< span id ="1423 "> 1423</ span > 1426< span id ="1424 "> 1424</ span > 1427< span id ="1425 "> 1425</ span > 1428< span id ="1426 "> 1426</ span > 1429< span id ="1427 "> 1427</ span > 1430< span id ="1428 "> 1428</ span > 1431< span id ="1429 "> 1429</ span > 1432< span id ="1430 "> 1430</ span > 1433< span id ="1431 "> 1431</ span > 1434< span id ="1432 "> 1432</ span > 1435< span id ="1433 "> 1433</ span > 1436< span id ="1434 "> 1434</ span > 1437< span id ="1435 "> 1435</ span > 1438< span id ="1436 "> 1436</ span > 1439< span id ="1437 "> 1437</ span > 1440< span id ="1438 "> 1438</ span > 1441< span id ="1439 "> 1439</ span > 1442< span id ="1440 "> 1440</ span > 1443< span id ="1441 "> 1441</ span > 1444< span id ="1442 "> 1442</ span > 1445< span id ="1443 "> 1443</ span > 1446< span id ="1444 "> 1444</ span > 1447< span id ="1445 "> 1445</ span > 1448< span id ="1446 "> 1446</ span > 1449< span id ="1447 "> 1447</ span > 1450< span id ="1448 "> 1448</ span > 1451< span id ="1449 "> 1449</ span > 1452< span id ="1450 "> 1450</ span > 1453< span id ="1451 "> 1451</ span > 1454< span id ="1452 "> 1452</ span > 1455< span id ="1453 "> 1453</ span > 1456< span id ="1454 "> 1454</ span > 1457< span id ="1455 "> 1455</ span > 1458< span id ="1456 "> 1456</ span > 1459< span id ="1457 "> 1457</ span > 1460< span id ="1458 "> 1458</ span > 1461< span id ="1459 "> 1459</ span > 1462< span id ="1460 "> 1460</ span > 1463< span id ="1461 "> 1461</ span > 1464< span id ="1462 "> 1462</ span > 1465< span id ="1463 "> 1463</ span > 1466< span id ="1464 "> 1464</ span > 1467< span id ="1465 "> 1465</ span > 1468< span id ="1466 "> 1466</ span > 1469< span id ="1467 "> 1467</ span > 1470< span id ="1468 "> 1468</ span > 1471< span id ="1469 "> 1469</ span > 1472< span id ="1470 "> 1470</ span > 1473< span id ="1471 "> 1471</ span > 1474< span id ="1472 "> 1472</ span > 1475< span id ="1473 "> 1473</ span > 1476< span id ="1474 "> 1474</ span > 1477< span id ="1475 "> 1475</ span > 1478< span id ="1476 "> 1476</ span > 1479< span id ="1477 "> 1477</ span > 1480< span id ="1478 "> 1478</ span > 1481< span id ="1479 "> 1479</ span > 1482< span id ="1480 "> 1480</ span > 1483< span id ="1481 "> 1481</ span > 1484< span id ="1482 "> 1482</ span > 1485< span id ="1483 "> 1483</ span > 1486< span id ="1484 "> 1484</ span > 1487< span id ="1485 "> 1485</ span > 1488< span id ="1486 "> 1486</ span > 1489< span id ="1487 "> 1487</ span > 1490< span id ="1488 "> 1488</ span > 1491< span id ="1489 "> 1489</ span > 1492< span id ="1490 "> 1490</ span > 1493< span id ="1491 "> 1491</ span > 1494< span id ="1492 "> 1492</ span > 1495< span id ="1493 "> 1493</ span > 1496< span id ="1494 "> 1494</ span > 1497< span id ="1495 "> 1495</ span > 1498< span id ="1496 "> 1496</ span > 1499< span id ="1497 "> 1497</ span > 1500< span id ="1498 "> 1498</ span > 1501< span id ="1499 "> 1499</ span > 1502< span id ="1500 "> 1500</ span > 1503< span id ="1501 "> 1501</ span > 1504< span id ="1502 "> 1502</ span > 1505< span id ="1503 "> 1503</ span > 1506< span id ="1504 "> 1504</ span > 1507< span id ="1505 "> 1505</ span > 1508< span id ="1506 "> 1506</ span > 1509< span id ="1507 "> 1507</ span > 1510< span id ="1508 "> 1508</ span > 1511< span id ="1509 "> 1509</ span > 1512< span id ="1510 "> 1510</ span > 1513< span id ="1511 "> 1511</ span > 1514< span id ="1512 "> 1512</ span > 1515< span id ="1513 "> 1513</ span > 1516< span id ="1514 "> 1514</ span > 1517< span id ="1515 "> 1515</ span > 1518< span id ="1516 "> 1516</ span > 1519< span id ="1517 "> 1517</ span > 1520< span id ="1518 "> 1518</ span > 1521< span id ="1519 "> 1519</ span > 1522< span id ="1520 "> 1520</ span > 1523< span id ="1521 "> 1521</ span > 1524< span id ="1522 "> 1522</ span > 1525< span id ="1523 "> 1523</ span > 1526< span id ="1524 "> 1524</ span > 1527< span id ="1525 "> 1525</ span > 1528< span id ="1526 "> 1526</ span > 1529< span id ="1527 "> 1527</ span > 1530< span id ="1528 "> 1528</ span > 1531< span id ="1529 "> 1529</ span > 1532< span id ="1530 "> 1530</ span > 1533< span id ="1531 "> 1531</ span > 1534< span id ="1532 "> 1532</ span > 1535< span id ="1533 "> 1533</ span > 1536< span id ="1534 "> 1534</ span > 1537< span id ="1535 "> 1535</ span > 1538< span id ="1536 "> 1536</ span > 1539< span id ="1537 "> 1537</ span > 1540< span id ="1538 "> 1538</ span > 1541< span id ="1539 "> 1539</ span > 1542< span id ="1540 "> 1540</ span > 1543< span id ="1541 "> 1541</ span > 1544< span id ="1542 "> 1542</ span > 1545< span id ="1543 "> 1543</ span > 1546< span id ="1544 "> 1544</ span > 1547< span id ="1545 "> 1545</ span > 1548< span id ="1546 "> 1546</ span > 1549< span id ="1547 "> 1547</ span > 1550< span id ="1548 "> 1548</ span > 1551< span id ="1549 "> 1549</ span > 1552< span id ="1550 "> 1550</ span > 1553< span id ="1551 "> 1551</ span > 1554< span id ="1552 "> 1552</ span > 1555< span id ="1553 "> 1553</ span > 1556< span id ="1554 "> 1554</ span > 1557< span id ="1555 "> 1555</ span > 1558< span id ="1556 "> 1556</ span > 1559< span id ="1557 "> 1557</ span > 1560< span id ="1558 "> 1558</ span > 1561< span id ="1559 "> 1559</ span > 1562< span id ="1560 "> 1560</ span > 1563< span id ="1561 "> 1561</ span > 1564< span id ="1562 "> 1562</ span > 1565< span id ="1563 "> 1563</ span > 1566< span id ="1564 "> 1564</ span > 1567< span id ="1565 "> 1565</ span > 1568< span id ="1566 "> 1566</ span > 1569< span id ="1567 "> 1567</ span > 1570< span id ="1568 "> 1568</ span > 1571< span id ="1569 "> 1569</ span > 1572< span id ="1570 "> 1570</ span > 1573< span id ="1571 "> 1571</ span > 1574< span id ="1572 "> 1572</ span > 1575< span id ="1573 "> 1573</ span > 1576< span id ="1574 "> 1574</ span > 1577< span id ="1575 "> 1575</ span > 1578< span id ="1576 "> 1576</ span > 1579< span id ="1577 "> 1577</ span > 1580< span id ="1578 "> 1578</ span > 1581< span id ="1579 "> 1579</ span > 1582< span id ="1580 "> 1580</ span > 1583< span id ="1581 "> 1581</ span > 1584< span id ="1582 "> 1582</ span > 1585< span id ="1583 "> 1583</ span > 1586< span id ="1584 "> 1584</ span > 1587< span id ="1585 "> 1585</ span > 1588< span id ="1586 "> 1586</ span > 1589< span id ="1587 "> 1587</ span > 1590< span id ="1588 "> 1588</ span > 1591< span id ="1589 "> 1589</ span > 1592< span id ="1590 "> 1590</ span > 1593< span id ="1591 "> 1591</ span > 1594< span id ="1592 "> 1592</ span > 1595< span id ="1593 "> 1593</ span > 1596< span id ="1594 "> 1594</ span > 1597< span id ="1595 "> 1595</ span > 1598< span id ="1596 "> 1596</ span > 1599< span id ="1597 "> 1597</ span > 1600< span id ="1598 "> 1598</ span > 1601< span id ="1599 "> 1599</ span > 1602< span id ="1600 "> 1600</ span > 1603< span id ="1601 "> 1601</ span > 1604< span id ="1602 "> 1602</ span > 1605< span id ="1603 "> 1603</ span > 1606< span id ="1604 "> 1604</ span > 1607< span id ="1605 "> 1605</ span > 1608< span id ="1606 "> 1606</ span > 1609< span id ="1607 "> 1607</ span > 1610< span id ="1608 "> 1608</ span > 1611< span id ="1609 "> 1609</ span > 1612< span id ="1610 "> 1610</ span > 1613< span id ="1611 "> 1611</ span > 1614< span id ="1612 "> 1612</ span > 1615< span id ="1613 "> 1613</ span > 1616< span id ="1614 "> 1614</ span > 1617< span id ="1615 "> 1615</ span > 1618< span id ="1616 "> 1616</ span > 1619< span id ="1617 "> 1617</ span > 1620< span id ="1618 "> 1618</ span > 1621< span id ="1619 "> 1619</ span > 1622< span id ="1620 "> 1620</ span > 1623< span id ="1621 "> 1621</ span > 1624< span id ="1622 "> 1622</ span > 1625< span id ="1623 "> 1623</ span > 1626< span id ="1624 "> 1624</ span > 1627< span id ="1625 "> 1625</ span > 1628< span id ="1626 "> 1626</ span > 1629< span id ="1627 "> 1627</ span > 1630< span id ="1628 "> 1628</ span > 1631< span id ="1629 "> 1629</ span > 1632< span id ="1630 "> 1630</ span > 1633< span id ="1631 "> 1631</ span > 1634< span id ="1632 "> 1632</ span > 1635< span id ="1633 "> 1633</ span > 1636< span id ="1634 "> 1634</ span > 1637< span id ="1635 "> 1635</ span > 1638< span id ="1636 "> 1636</ span > 1639< span id ="1637 "> 1637</ span > 1640< span id ="1638 "> 1638</ span > 1641< span id ="1639 "> 1639</ span > 1642< span id ="1640 "> 1640</ span > 1643< span id ="1641 "> 1641</ span > 1644< span id ="1642 "> 1642</ span > 1645< span id ="1643 "> 1643</ span > 1646< span id ="1644 "> 1644</ span > 1647< span id ="1645 "> 1645</ span > 1648< span id ="1646 "> 1646</ span > 1649< span id ="1647 "> 1647</ span > 1650< span id ="1648 "> 1648</ span > 1651< span id ="1649 "> 1649</ span > 1652< span id ="1650 "> 1650</ span > 1653< span id ="1651 "> 1651</ span > 1654< span id ="1652 "> 1652</ span > 1655< span id ="1653 "> 1653</ span > 1656< span id ="1654 "> 1654</ span > 1657< span id ="1655 "> 1655</ span > 1658< span id ="1656 "> 1656</ span > 1659< span id ="1657 "> 1657</ span > 1660< span id ="1658 "> 1658</ span > 1661< span id ="1659 "> 1659</ span > 1662< span id ="1660 "> 1660</ span > 1663< span id ="1661 "> 1661</ span > 1664< span id ="1662 "> 1662</ span > 1665< span id ="1663 "> 1663</ span > 1666< span id ="1664 "> 1664</ span > 1667< span id ="1665 "> 1665</ span > 1668< span id ="1666 "> 1666</ span > 1669< span id ="1667 "> 1667</ span > 1670< span id ="1668 "> 1668</ span > 1671< span id ="1669 "> 1669</ span > 1672< span id ="1670 "> 1670</ span > 1673< span id ="1671 "> 1671</ span > 1674< span id ="1672 "> 1672</ span > 1675< span id ="1673 "> 1673</ span > 1676< span id ="1674 "> 1674</ span > 1677< span id ="1675 "> 1675</ span > 1678< span id ="1676 "> 1676</ span > 1679< span id ="1677 "> 1677</ span > 1680< span id ="1678 "> 1678</ span > 1681< span id ="1679 "> 1679</ span > 1682< span id ="1680 "> 1680</ span > 1683< span id ="1681 "> 1681</ span > 1684< span id ="1682 "> 1682</ span > 1685< span id ="1683 "> 1683</ span > 1686< span id ="1684 "> 1684</ span > 1687< span id ="1685 "> 1685</ span > 1688< span id ="1686 "> 1686</ span > 1689< span id ="1687 "> 1687</ span > 1690< span id ="1688 "> 1688</ span > 1691< span id ="1689 "> 1689</ span > 1692< span id ="1690 "> 1690</ span > 1693< span id ="1691 "> 1691</ span > 1694< span id ="1692 "> 1692</ span > 1695< span id ="1693 "> 1693</ span > 1696< span id ="1694 "> 1694</ span > 1697< span id ="1695 "> 1695</ span > 1698< span id ="1696 "> 1696</ span > 1699< span id ="1697 "> 1697</ span > 1700< span id ="1698 "> 1698</ span > 1701< span id ="1699 "> 1699</ span > 1702< span id ="1700 "> 1700</ span > 1703< span id ="1701 "> 1701</ span > 1704< span id ="1702 "> 1702</ span > 1705< span id ="1703 "> 1703</ span > 1706< span id ="1704 "> 1704</ span > 1707< span id ="1705 "> 1705</ span > 1708< span id ="1706 "> 1706</ span > 1709< span id ="1707 "> 1707</ span > 1710< span id ="1708 "> 1708</ span > 1711< span id ="1709 "> 1709</ span > 1712< span id ="1710 "> 1710</ span > 1713< span id ="1711 "> 1711</ span > 1714< span id ="1712 "> 1712</ span > 1715< span id ="1713 "> 1713</ span > 1716< span id ="1714 "> 1714</ span > 1717< span id ="1715 "> 1715</ span > 1718< span id ="1716 "> 1716</ span > 1719< span id ="1717 "> 1717</ span > 1720< span id ="1718 "> 1718</ span > 1721< span id ="1719 "> 1719</ span > 1722< span id ="1720 "> 1720</ span > 1723< span id ="1721 "> 1721</ span > 1724< span id ="1722 "> 1722</ span > 1725< span id ="1723 "> 1723</ span > 1726< span id ="1724 "> 1724</ span > 1727< span id ="1725 "> 1725</ span > 1728< span id ="1726 "> 1726</ span > 1729< span id ="1727 "> 1727</ span > 1730< span id ="1728 "> 1728</ span > 1731< span id ="1729 "> 1729</ span > 1732< span id ="1730 "> 1730</ span > 1733< span id ="1731 "> 1731</ span > 1734< span id ="1732 "> 1732</ span > 1735< span id ="1733 "> 1733</ span > 1736< span id ="1734 "> 1734</ span > 1737< span id ="1735 "> 1735</ span > 1738< span id ="1736 "> 1736</ span > 1739< span id ="1737 "> 1737</ span > 1740< span id ="1738 "> 1738</ span > 1741< span id ="1739 "> 1739</ span > 1742< span id ="1740 "> 1740</ span > 1743< span id ="1741 "> 1741</ span > 1744< span id ="1742 "> 1742</ span > 1745< span id ="1743 "> 1743</ span > 1746< span id ="1744 "> 1744</ span > 1747< span id ="1745 "> 1745</ span > 1748< span id ="1746 "> 1746</ span > 1749< span id ="1747 "> 1747</ span > 1750< span id ="1748 "> 1748</ span > 1751< span id ="1749 "> 1749</ span > 1752< span id ="1750 "> 1750</ span > 1753< span id ="1751 "> 1751</ span > 1754< span id ="1752 "> 1752</ span > 1755< span id ="1753 "> 1753</ span > 1756< span id ="1754 "> 1754</ span > 1757< span id ="1755 "> 1755</ span > 1758< span id ="1756 "> 1756</ span > 1759< span id ="1757 "> 1757</ span > 1760< span id ="1758 "> 1758</ span > 1761< span id ="1759 "> 1759</ span > 1762< span id ="1760 "> 1760</ span > 1763< span id ="1761 "> 1761</ span > 1764< span id ="1762 "> 1762</ span > 1765< span id ="1763 "> 1763</ span > 1766< span id ="1764 "> 1764</ span > 1767< span id ="1765 "> 1765</ span > 1768< span id ="1766 "> 1766</ span > 1769< span id ="1767 "> 1767</ span > 1770< span id ="1768 "> 1768</ span > 1771< span id ="1769 "> 1769</ span > 1772< span id ="1770 "> 1770</ span > 1773< span id ="1771 "> 1771</ span > 1774< span id ="1772 "> 1772</ span > 1775< span id ="1773 "> 1773</ span > 1776< span id ="1774 "> 1774</ span > 1777< span id ="1775 "> 1775</ span > 1778< span id ="1776 "> 1776</ span > 1779< span id ="1777 "> 1777</ span > 1780< span id ="1778 "> 1778</ span > 1781< span id ="1779 "> 1779</ span > 1782< span id ="1780 "> 1780</ span > 1783< span id ="1781 "> 1781</ span > 1784< span id ="1782 "> 1782</ span > 1785< span id ="1783 "> 1783</ span > 1786< span id ="1784 "> 1784</ span > 1787< span id ="1785 "> 1785</ span > 1788< span id ="1786 "> 1786</ span > 1789< span id ="1787 "> 1787</ span > 1790< span id ="1788 "> 1788</ span > 1791< span id ="1789 "> 1789</ span > 1792< span id ="1790 "> 1790</ span > 1793< span id ="1791 "> 1791</ span > 1794< span id ="1792 "> 1792</ span > 1795< span id ="1793 "> 1793</ span > 1796< span id ="1794 "> 1794</ span > 1797< span id ="1795 "> 1795</ span > 1798< span id ="1796 "> 1796</ span > 1799< span id ="1797 "> 1797</ span > 1800< span id ="1798 "> 1798</ span > 1801< span id ="1799 "> 1799</ span > 1802< span id ="1800 "> 1800</ span > 1803< span id ="1801 "> 1801</ span > 1804< span id ="1802 "> 1802</ span > 1805< span id ="1803 "> 1803</ span > 1806< span id ="1804 "> 1804</ span > 1807< span id ="1805 "> 1805</ span > 1808< span id ="1806 "> 1806</ span > 1809< span id ="1807 "> 1807</ span > 1810< span id ="1808 "> 1808</ span > 1811< span id ="1809 "> 1809</ span > 1812< span id ="1810 "> 1810</ span > 1813< span id ="1811 "> 1811</ span > 1814< span id ="1812 "> 1812</ span > 1815< span id ="1813 "> 1813</ span > 1816< span id ="1814 "> 1814</ span > 1817< span id ="1815 "> 1815</ span > 1818< span id ="1816 "> 1816</ span > 1819< span id ="1817 "> 1817</ span > 1820< span id ="1818 "> 1818</ span > 1821< span id ="1819 "> 1819</ span > 1822< span id ="1820 "> 1820</ span > 1823< span id ="1821 "> 1821</ span > 1824< span id ="1822 "> 1822</ span > 1825< span id ="1823 "> 1823</ span > 1826< span id ="1824 "> 1824</ span > 1827< span id ="1825 "> 1825</ span > 1828< span id ="1826 "> 1826</ span > 1829< span id ="1827 "> 1827</ span > 1830< span id ="1828 "> 1828</ span > 1831< span id ="1829 "> 1829</ span > 1832< span id ="1830 "> 1830</ span > 1833< span id ="1831 "> 1831</ span > 1834< span id ="1832 "> 1832</ span > 1835< span id ="1833 "> 1833</ span > 1836< span id ="1834 "> 1834</ span > 1837< span id ="1835 "> 1835</ span > 1838< span id ="1836 "> 1836</ span > 1839< span id ="1837 "> 1837</ span > 1840< span id ="1838 "> 1838</ span > 1841< span id ="1839 "> 1839</ span > 1842< span id ="1840 "> 1840</ span > 1843< span id ="1841 "> 1841</ span > 1844< span id ="1842 "> 1842</ span > 1845< span id ="1843 "> 1843</ span > 1846< span id ="1844 "> 1844</ span > 1847< span id ="1845 "> 1845</ span > 1848< span id ="1846 "> 1846</ span > 1849< span id ="1847 "> 1847</ span > 1850< span id ="1848 "> 1848</ span > 1851< span id ="1849 "> 1849</ span > 1852< span id ="1850 "> 1850</ span > 1853< span id ="1851 "> 1851</ span > 1854< span id ="1852 "> 1852</ span > 1855< span id ="1853 "> 1853</ span > 1856< span id ="1854 "> 1854</ span > 1857< span id ="1855 "> 1855</ span > 1858< span id ="1856 "> 1856</ span > 1859< span id ="1857 "> 1857</ span > 1860< span id ="1858 "> 1858</ span > 1861< span id ="1859 "> 1859</ span > 1862< span id ="1860 "> 1860</ span > 1863< span id ="1861 "> 1861</ span > 1864< span id ="1862 "> 1862</ span > 1865< span id ="1863 "> 1863</ span > 1866< span id ="1864 "> 1864</ span > 1867< span id ="1865 "> 1865</ span > 1868< span id ="1866 "> 1866</ span > 1869< span id ="1867 "> 1867</ span > 1870< span id ="1868 "> 1868</ span > 1871< span id ="1869 "> 1869</ span > 1872< span id ="1870 "> 1870</ span > 1873< span id ="1871 "> 1871</ span > 1874< span id ="1872 "> 1872</ span > 1875< span id ="1873 "> 1873</ span > 1876< span id ="1874 "> 1874</ span > 1877< span id ="1875 "> 1875</ span > 1878< span id ="1876 "> 1876</ span > 1879< span id ="1877 "> 1877</ span > 1880< span id ="1878 "> 1878</ span > 1881< span id ="1879 "> 1879</ span > 1882< span id ="1880 "> 1880</ span > 1883< span id ="1881 "> 1881</ span > 1884< span id ="1882 "> 1882</ span > 1885< span id ="1883 "> 1883</ span > 1886< span id ="1884 "> 1884</ span > 1887< span id ="1885 "> 1885</ span > 1888< span id ="1886 "> 1886</ span > 1889< span id ="1887 "> 1887</ span > 1890< span id ="1888 "> 1888</ span > 1891< span id ="1889 "> 1889</ span > 1892< span id ="1890 "> 1890</ span > 1893< span id ="1891 "> 1891</ span > 1894< span id ="1892 "> 1892</ span > 1895< span id ="1893 "> 1893</ span > 1896< span id ="1894 "> 1894</ span > 1897< span id ="1895 "> 1895</ span > 1898< span id ="1896 "> 1896</ span > 1899< span id ="1897 "> 1897</ span > 1900< span id ="1898 "> 1898</ span > 1901< span id ="1899 "> 1899</ span > 1902< span id ="1900 "> 1900</ span > 1903< span id ="1901 "> 1901</ span > 1904< span id ="1902 "> 1902</ span > 1905< span id ="1903 "> 1903</ span > 1906< span id ="1904 "> 1904</ span > 1907< span id ="1905 "> 1905</ span > 1908< span id ="1906 "> 1906</ span > 1909< span id ="1907 "> 1907</ span > 1910< span id ="1908 "> 1908</ span > 1911< span id ="1909 "> 1909</ span > 1912< span id ="1910 "> 1910</ span > 1913< span id ="1911 "> 1911</ span > 1914< span id ="1912 "> 1912</ span > 1915< span id ="1913 "> 1913</ span > 1916< span id ="1914 "> 1914</ span > 1917< span id ="1915 "> 1915</ span > 1918< span id ="1916 "> 1916</ span > 1919< span id ="1917 "> 1917</ span > 1920< span id ="1918 "> 1918</ span > 1921< span id ="1919 "> 1919</ span > 1922< span id ="1920 "> 1920</ span > 1923< span id ="1921 "> 1921</ span > 1924< span id ="1922 "> 1922</ span > 1925< span id ="1923 "> 1923</ span > 1926< span id ="1924 "> 1924</ span > 1927< span id ="1925 "> 1925</ span > 1928< span id ="1926 "> 1926</ span > 1929< span id ="1927 "> 1927</ span > 1930< span id ="1928 "> 1928</ span > 1931< span id ="1929 "> 1929</ span > 1932< span id ="1930 "> 1930</ span > 1933< span id ="1931 "> 1931</ span > 1934< span id ="1932 "> 1932</ span > 1935< span id ="1933 "> 1933</ span > 1936< span id ="1934 "> 1934</ span > 1937< span id ="1935 "> 1935</ span > 1938< span id ="1936 "> 1936</ span > 1939< span id ="1937 "> 1937</ span > 1940< span id ="1938 "> 1938</ span > 1941< span id ="1939 "> 1939</ span > 1942< span id ="1940 "> 1940</ span > 1943< span id ="1941 "> 1941</ span > 1944< span id ="1942 "> 1942</ span > 1945< span id ="1943 "> 1943</ span > 1946< span id ="1944 "> 1944</ span > 1947< span id ="1945 "> 1945</ span > 1948< span id ="1946 "> 1946</ span > 1949< span id ="1947 "> 1947</ span > 1950< span id ="1948 "> 1948</ span > 1951< span id ="1949 "> 1949</ span > 1952< span id ="1950 "> 1950</ span > 1953< span id ="1951 "> 1951</ span > 1954< span id ="1952 "> 1952</ span > 1955< span id ="1953 "> 1953</ span > 1956< span id ="1954 "> 1954</ span > 1957< span id ="1955 "> 1955</ span > 1958< span id ="1956 "> 1956</ span > 1959< span id ="1957 "> 1957</ span > 1960< span id ="1958 "> 1958</ span > 1961< span id ="1959 "> 1959</ span > 1962< span id ="1960 "> 1960</ span > 1963< span id ="1961 "> 1961</ span > 1964< span id ="1962 "> 1962</ span > 1965< span id ="1963 "> 1963</ span > 1966< span id ="1964 "> 1964</ span > 1967< span id ="1965 "> 1965</ span > 1968< span id ="1966 "> 1966</ span > 1969< span id ="1967 "> 1967</ span > 1970< span id ="1968 "> 1968</ span > 1971< span id ="1969 "> 1969</ span > 1972< span id ="1970 "> 1970</ span > 1973< span id ="1971 "> 1971</ span > 1974</ pre >< pre class ="rust ">< code >< span class ="comment "> // Copyright 2015 The Rust Project Developers. See the COPYRIGHT 1975// file at the top-level directory of this distribution and at 1976// http://rust-lang.org/COPYRIGHT. 1977// 1978// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or 1979// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license 1980// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your 1981// option. This file may not be copied, modified, or distributed 1982// except according to those terms. 1983 1984</ span >< span class ="doccomment "> //! A lightweight logging facade. 1985//! 1986//! The `log` crate provides a single logging API that abstracts over the 1987//! actual logging implementation. Libraries can use the logging API provided 1988//! by this crate, and the consumer of those libraries can choose the logging 1989//! implementation that is most suitable for its use case. 1990//! 1991//! If no logging implementation is selected, the facade falls back to a "noop" 1992//! implementation that ignores all log messages. The overhead in this case 1993//! is very small - just an integer load, comparison and jump. 1994//! 1995//! A log request consists of a _target_, a _level_, and a _body_. A target is a 1996//! string which defaults to the module path of the location of the log request, 1997//! though that default may be overridden. Logger implementations typically use 1998//! the target to filter requests based on some user configuration. 1999//! 2000//! # Usage 2001//! 2002//! The basic use of the log crate is through the five logging macros: [`error!`], 2003//! [`warn!`], [`info!`], [`debug!`] and [`trace!`] 2004//! where `error!` represents the highest-priority log messages 2005//! and `trace!` the lowest. The log messages are filtered by configuring 2006//! the log level to exclude messages with a lower priority. 2007//! Each of these macros accept format strings similarly to [`println!`]. 2008//! 2009//! 2010//! [`error!`]: ./macro.error.html 2011//! [`warn!`]: ./macro.warn.html 2012//! [`info!`]: ./macro.info.html 2013//! [`debug!`]: ./macro.debug.html 2014//! [`trace!`]: ./macro.trace.html 2015//! [`println!`]: https://doc.rust-lang.org/stable/std/macro.println.html 2016//! 2017//! ## In libraries 2018//! 2019//! Libraries should link only to the `log` crate, and use the provided 2020//! macros to log whatever information will be useful to downstream consumers. 2021//! 2022//! ### Examples 2023//! 2024//! ```edition2018 2025//! # #[derive(Debug)] pub struct Yak(String); 2026//! # impl Yak { fn shave(&mut self, _: u32) {} } 2027//! # fn find_a_razor() -> Result<u32, u32> { Ok(1) } 2028//! use log::{info, warn}; 2029//! 2030//! pub fn shave_the_yak(yak: &mut Yak) { 2031//! info!(target: "yak_events", "Commencing yak shaving for {:?}", yak); 2032//! 2033//! loop { 2034//! match find_a_razor() { 2035//! Ok(razor) => { 2036//! info!("Razor located: {}", razor); 2037//! yak.shave(razor); 2038//! break; 2039//! } 2040//! Err(err) => { 2041//! warn!("Unable to locate a razor: {}, retrying", err); 2042//! } 2043//! } 2044//! } 2045//! } 2046//! # fn main() {} 2047//! ``` 2048//! 2049//! ## In executables 2050//! 2051//! Executables should choose a logging implementation and initialize it early in the 2052//! runtime of the program. Logging implementations will typically include a 2053//! function to do this. Any log messages generated before 2054//! the implementation is initialized will be ignored. 2055//! 2056//! The executable itself may use the `log` crate to log as well. 2057//! 2058//! ### Warning 2059//! 2060//! The logging system may only be initialized once. 2061//! 2062//! ## Structured logging 2063//! 2064//! If you enable the `kv_unstable` feature you can associate structured values 2065//! with your log records. If we take the example from before, we can include 2066//! some additional context besides what's in the formatted message: 2067//! 2068//! ```edition2018 2069//! # #[macro_use] extern crate serde; 2070//! # #[derive(Debug, Serialize)] pub struct Yak(String); 2071//! # impl Yak { fn shave(&mut self, _: u32) {} } 2072//! # fn find_a_razor() -> Result<u32, std::io::Error> { Ok(1) } 2073//! # #[cfg(feature = "kv_unstable_serde")] 2074//! # fn main() { 2075//! use log::{info, warn, as_serde, as_error}; 2076//! 2077//! pub fn shave_the_yak(yak: &mut Yak) { 2078//! info!(target: "yak_events", yak = as_serde!(yak); "Commencing yak shaving"); 2079//! 2080//! loop { 2081//! match find_a_razor() { 2082//! Ok(razor) => { 2083//! info!(razor = razor; "Razor located"); 2084//! yak.shave(razor); 2085//! break; 2086//! } 2087//! Err(err) => { 2088//! warn!(err = as_error!(err); "Unable to locate a razor, retrying"); 2089//! } 2090//! } 2091//! } 2092//! } 2093//! # } 2094//! # #[cfg(not(feature = "kv_unstable_serde"))] 2095//! # fn main() {} 2096//! ``` 2097//! 2098//! # Available logging implementations 2099//! 2100//! In order to produce log output executables have to use 2101//! a logger implementation compatible with the facade. 2102//! There are many available implementations to choose from, 2103//! here are some of the most popular ones: 2104//! 2105//! * Simple minimal loggers: 2106//! * [env_logger] 2107//! * [simple_logger] 2108//! * [simplelog] 2109//! * [pretty_env_logger] 2110//! * [stderrlog] 2111//! * [flexi_logger] 2112//! * Complex configurable frameworks: 2113//! * [log4rs] 2114//! * [fern] 2115//! * Adaptors for other facilities: 2116//! * [syslog] 2117//! * [slog-stdlog] 2118//! * [systemd-journal-logger] 2119//! * [android_log] 2120//! * [win_dbg_logger] 2121//! * [db_logger] 2122//! * For WebAssembly binaries: 2123//! * [console_log] 2124//! * For dynamic libraries: 2125//! * You may need to construct an FFI-safe wrapper over `log` to initialize in your libraries 2126//! 2127//! # Implementing a Logger 2128//! 2129//! Loggers implement the [`Log`] trait. Here's a very basic example that simply 2130//! logs all messages at the [`Error`][level_link], [`Warn`][level_link] or 2131//! [`Info`][level_link] levels to stdout: 2132//! 2133//! ```edition2018 2134//! use log::{Record, Level, Metadata}; 2135//! 2136//! struct SimpleLogger; 2137//! 2138//! impl log::Log for SimpleLogger { 2139//! fn enabled(&self, metadata: &Metadata) -> bool { 2140//! metadata.level() <= Level::Info 2141//! } 2142//! 2143//! fn log(&self, record: &Record) { 2144//! if self.enabled(record.metadata()) { 2145//! println!("{} - {}", record.level(), record.args()); 2146//! } 2147//! } 2148//! 2149//! fn flush(&self) {} 2150//! } 2151//! 2152//! # fn main() {} 2153//! ``` 2154//! 2155//! Loggers are installed by calling the [`set_logger`] function. The maximum 2156//! log level also needs to be adjusted via the [`set_max_level`] function. The 2157//! logging facade uses this as an optimization to improve performance of log 2158//! messages at levels that are disabled. It's important to set it, as it 2159//! defaults to [`Off`][filter_link], so no log messages will ever be captured! 2160//! In the case of our example logger, we'll want to set the maximum log level 2161//! to [`Info`][filter_link], since we ignore any [`Debug`][level_link] or 2162//! [`Trace`][level_link] level log messages. A logging implementation should 2163//! provide a function that wraps a call to [`set_logger`] and 2164//! [`set_max_level`], handling initialization of the logger: 2165//! 2166//! ```edition2018 2167//! # use log::{Level, Metadata}; 2168//! # struct SimpleLogger; 2169//! # impl log::Log for SimpleLogger { 2170//! # fn enabled(&self, _: &Metadata) -> bool { false } 2171//! # fn log(&self, _: &log::Record) {} 2172//! # fn flush(&self) {} 2173//! # } 2174//! # fn main() {} 2175//! use log::{SetLoggerError, LevelFilter}; 2176//! 2177//! static LOGGER: SimpleLogger = SimpleLogger; 2178//! 2179//! pub fn init() -> Result<(), SetLoggerError> { 2180//! log::set_logger(&LOGGER) 2181//! .map(|()| log::set_max_level(LevelFilter::Info)) 2182//! } 2183//! ``` 2184//! 2185//! Implementations that adjust their configurations at runtime should take care 2186//! to adjust the maximum log level as well. 2187//! 2188//! # Use with `std` 2189//! 2190//! `set_logger` requires you to provide a `&'static Log`, which can be hard to 2191//! obtain if your logger depends on some runtime configuration. The 2192//! `set_boxed_logger` function is available with the `std` Cargo feature. It is 2193//! identical to `set_logger` except that it takes a `Box<Log>` rather than a 2194//! `&'static Log`: 2195//! 2196//! ```edition2018 2197//! # use log::{Level, LevelFilter, Log, SetLoggerError, Metadata}; 2198//! # struct SimpleLogger; 2199//! # impl log::Log for SimpleLogger { 2200//! # fn enabled(&self, _: &Metadata) -> bool { false } 2201//! # fn log(&self, _: &log::Record) {} 2202//! # fn flush(&self) {} 2203//! # } 2204//! # fn main() {} 2205//! # #[cfg(feature = "std")] 2206//! pub fn init() -> Result<(), SetLoggerError> { 2207//! log::set_boxed_logger(Box::new(SimpleLogger)) 2208//! .map(|()| log::set_max_level(LevelFilter::Info)) 2209//! } 2210//! ``` 2211//! 2212//! # Compile time filters 2213//! 2214//! Log levels can be statically disabled at compile time via Cargo features. Log invocations at 2215//! disabled levels will be skipped and will not even be present in the resulting binary. 2216//! This level is configured separately for release and debug builds. The features are: 2217//! 2218//! * `max_level_off` 2219//! * `max_level_error` 2220//! * `max_level_warn` 2221//! * `max_level_info` 2222//! * `max_level_debug` 2223//! * `max_level_trace` 2224//! * `release_max_level_off` 2225//! * `release_max_level_error` 2226//! * `release_max_level_warn` 2227//! * `release_max_level_info` 2228//! * `release_max_level_debug` 2229//! * `release_max_level_trace` 2230//! 2231//! These features control the value of the `STATIC_MAX_LEVEL` constant. The logging macros check 2232//! this value before logging a message. By default, no levels are disabled. 2233//! 2234//! Libraries should avoid using the max level features because they're global and can't be changed 2235//! once they're set. 2236//! 2237//! For example, a crate can disable trace level logs in debug builds and trace, debug, and info 2238//! level logs in release builds with the following configuration: 2239//! 2240//! ```toml 2241//! [dependencies] 2242//! log = { version = "0.4", features = ["max_level_debug", "release_max_level_warn"] } 2243//! ``` 2244//! # Crate Feature Flags 2245//! 2246//! The following crate feature flags are available in addition to the filters. They are 2247//! configured in your `Cargo.toml`. 2248//! 2249//! * `std` allows use of `std` crate instead of the default `core`. Enables using `std::error` and 2250//! `set_boxed_logger` functionality. 2251//! * `serde` enables support for serialization and deserialization of `Level` and `LevelFilter`. 2252//! 2253//! ```toml 2254//! [dependencies] 2255//! log = { version = "0.4", features = ["std", "serde"] } 2256//! ``` 2257//! 2258//! # Version compatibility 2259//! 2260//! The 0.3 and 0.4 versions of the `log` crate are almost entirely compatible. Log messages 2261//! made using `log` 0.3 will forward transparently to a logger implementation using `log` 0.4. Log 2262//! messages made using `log` 0.4 will forward to a logger implementation using `log` 0.3, but the 2263//! module path and file name information associated with the message will unfortunately be lost. 2264//! 2265//! [`Log`]: trait.Log.html 2266//! [level_link]: enum.Level.html 2267//! [filter_link]: enum.LevelFilter.html 2268//! [`set_logger`]: fn.set_logger.html 2269//! [`set_max_level`]: fn.set_max_level.html 2270//! [`try_set_logger_raw`]: fn.try_set_logger_raw.html 2271//! [`shutdown_logger_raw`]: fn.shutdown_logger_raw.html 2272//! [env_logger]: https://docs.rs/env_logger/*/env_logger/ 2273//! [simple_logger]: https://github.com/borntyping/rust-simple_logger 2274//! [simplelog]: https://github.com/drakulix/simplelog.rs 2275//! [pretty_env_logger]: https://docs.rs/pretty_env_logger/*/pretty_env_logger/ 2276//! [stderrlog]: https://docs.rs/stderrlog/*/stderrlog/ 2277//! [flexi_logger]: https://docs.rs/flexi_logger/*/flexi_logger/ 2278//! [syslog]: https://docs.rs/syslog/*/syslog/ 2279//! [slog-stdlog]: https://docs.rs/slog-stdlog/*/slog_stdlog/ 2280//! [log4rs]: https://docs.rs/log4rs/*/log4rs/ 2281//! [fern]: https://docs.rs/fern/*/fern/ 2282//! [systemd-journal-logger]: https://docs.rs/systemd-journal-logger/*/systemd_journal_logger/ 2283//! [android_log]: https://docs.rs/android_log/*/android_log/ 2284//! [win_dbg_logger]: https://docs.rs/win_dbg_logger/*/win_dbg_logger/ 2285//! [console_log]: https://docs.rs/console_log/*/console_log/ 2286 2287</ span >< span class ="attribute "> #![doc( 2288 html_logo_url =< span class ="string "> "https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png"</ span > , 2289 html_favicon_url =< span class ="string "> "https://www.rust-lang.org/favicon.ico"</ span > , 2290 html_root_url =< span class ="string "> "https://docs.rs/log/0.4.17" 2291</ span > )] 2292#![warn(missing_docs)] 2293#![deny(missing_debug_implementations, unconditional_recursion)] 2294#![cfg_attr(all(not(feature =< span class ="string "> "std"</ span > ), not(test)), no_std)] 2295</ span >< span class ="comment "> // When compiled for the rustc compiler itself we want to make sure that this is 2296// an unstable crate 2297</ span >< span class ="attribute "> #![cfg_attr(rustbuild, feature(staged_api, rustc_private))] 2298#![cfg_attr(rustbuild, unstable(feature =< span class ="string "> "rustc_private"</ span > , issue =< span class ="string "> "27812"</ span > ))] 2299 2300#[cfg(all(not(feature =< span class ="string "> "std"</ span > ), not(test)))] 2301</ span >< span class ="kw "> extern crate</ span > core< span class ="kw "> as</ span > std; 2302 2303< span class ="attribute "> #[macro_use] 2304</ span >< span class ="kw "> extern crate</ span > cfg_if; 2305 2306< span class ="kw "> use</ span > std::cmp; 2307< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 2308</ span >< span class ="kw "> use</ span > std::error; 2309< span class ="kw "> use</ span > std::fmt; 2310< span class ="kw "> use</ span > std::mem; 2311< span class ="kw "> use</ span > std::str::FromStr; 2312 2313< span class ="attribute "> #[macro_use] 2314</ span >< span class ="kw "> mod</ span > macros; 2315< span class ="kw "> mod</ span > serde; 2316 2317< span class ="attribute "> #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 2318</ span >< span class ="kw "> pub mod</ span > kv; 2319 2320< span class ="attribute "> #[cfg(has_atomics)] 2321</ span >< span class ="kw "> use</ span > std::sync::atomic::{AtomicUsize, Ordering}; 2322 2323< span class ="attribute "> #[cfg(not(has_atomics))] 2324</ span >< span class ="kw "> use</ span > std::cell::Cell; 2325< span class ="attribute "> #[cfg(not(has_atomics))] 2326</ span >< span class ="kw "> use</ span > std::sync::atomic::Ordering; 2327 2328< span class ="attribute "> #[cfg(not(has_atomics))] 2329</ span >< span class ="kw "> struct</ span > AtomicUsize { 2330 v: Cell<usize>, 2331} 2332 2333< span class ="attribute "> #[cfg(not(has_atomics))] 2334</ span >< span class ="kw "> impl</ span > AtomicUsize { 2335< span class ="kw "> const fn</ span > new(v: usize) -> AtomicUsize { 2336 AtomicUsize { v: Cell::new(v) } 2337 } 2338 2339< span class ="kw "> fn</ span > load(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , _order: Ordering) -> usize { 2340< span class ="self "> self</ span > .v.get() 2341 } 2342 2343< span class ="kw "> fn</ span > store(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , val: usize, _order: Ordering) { 2344< span class ="self "> self</ span > .v.set(val) 2345 } 2346 2347< span class ="attribute "> #[cfg(atomic_cas)] 2348</ span >< span class ="kw "> fn</ span > compare_exchange( 2349< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , 2350 current: usize, 2351 new: usize, 2352 _success: Ordering, 2353 _failure: Ordering, 2354 ) ->< span class ="prelude-ty "> Result</ span > <usize, usize> { 2355< span class ="kw "> let</ span > prev =< span class ="self "> self</ span > .v.get(); 2356< span class ="kw "> if</ span > current == prev { 2357< span class ="self "> self</ span > .v.set(new); 2358 } 2359< span class ="prelude-val "> Ok</ span > (prev) 2360 } 2361} 2362 2363< span class ="comment "> // Any platform without atomics is unlikely to have multiple cores, so 2364// writing via Cell will not be a race condition. 2365</ span >< span class ="attribute "> #[cfg(not(has_atomics))] 2366</ span >< span class ="kw "> unsafe impl</ span > Sync< span class ="kw "> for</ span > AtomicUsize {} 2367 2368< span class ="comment "> // The LOGGER static holds a pointer to the global logger. It is protected by 2369// the STATE static which determines whether LOGGER has been initialized yet. 2370</ span >< span class ="kw "> static</ span >< span class ="kw-2 "> mut</ span > LOGGER:< span class ="kw-2 "> &</ span >< span class ="kw "> dyn</ span > Log =< span class ="kw-2 "> &</ span > NopLogger; 2371 2372< span class ="kw "> static</ span > STATE: AtomicUsize = AtomicUsize::new(< span class ="number "> 0</ span > ); 2373 2374< span class ="comment "> // There are three different states that we care about: the logger's 2375// uninitialized, the logger's initializing (set_logger's been called but 2376// LOGGER hasn't actually been set yet), or the logger's active. 2377</ span >< span class ="kw "> const</ span > UNINITIALIZED: usize =< span class ="number "> 0</ span > ; 2378< span class ="kw "> const</ span > INITIALIZING: usize =< span class ="number "> 1</ span > ; 2379< span class ="kw "> const</ span > INITIALIZED: usize =< span class ="number "> 2</ span > ; 2380 2381< span class ="kw "> static</ span > MAX_LOG_LEVEL_FILTER: AtomicUsize = AtomicUsize::new(< span class ="number "> 0</ span > ); 2382 2383< span class ="kw "> static</ span > LOG_LEVEL_NAMES: [< span class ="kw-2 "> &</ span > str;< span class ="number "> 6</ span > ] = [< span class ="string "> "OFF"</ span > ,< span class ="string "> "ERROR"</ span > ,< span class ="string "> "WARN"</ span > ,< span class ="string "> "INFO"</ span > ,< span class ="string "> "DEBUG"</ span > ,< span class ="string "> "TRACE"</ span > ]; 2384 2385< span class ="kw "> static</ span > SET_LOGGER_ERROR:< span class ="kw-2 "> &</ span > str =< span class ="string "> "attempted to set a logger after the logging system \ 2386 was already initialized"</ span > ; 2387< span class ="kw "> static</ span > LEVEL_PARSE_ERROR:< span class ="kw-2 "> &</ span > str = 2388< span class ="string "> "attempted to convert a string that doesn't match an existing log level"</ span > ; 2389 2390< span class ="doccomment "> /// An enum representing the available verbosity levels of the logger. 2391/// 2392/// Typical usage includes: checking if a certain `Level` is enabled with 2393/// [`log_enabled!`](macro.log_enabled.html), specifying the `Level` of 2394/// [`log!`](macro.log.html), and comparing a `Level` directly to a 2395/// [`LevelFilter`](enum.LevelFilter.html). 2396</ span >< span class ="attribute "> #[repr(usize)] 2397#[derive(Copy, Eq, Debug, Hash)] 2398</ span >< span class ="kw "> pub enum</ span > Level { 2399< span class ="doccomment "> /// The "error" level. 2400 /// 2401 /// Designates very serious errors. 2402</ span >< span class ="comment "> // This way these line up with the discriminants for LevelFilter below 2403 // This works because Rust treats field-less enums the same way as C does: 2404 // https://doc.rust-lang.org/reference/items/enumerations.html#custom-discriminant-values-for-field-less-enumerations 2405</ span > Error =< span class ="number "> 1</ span > , 2406< span class ="doccomment "> /// The "warn" level. 2407 /// 2408 /// Designates hazardous situations. 2409</ span > Warn, 2410< span class ="doccomment "> /// The "info" level. 2411 /// 2412 /// Designates useful information. 2413</ span > Info, 2414< span class ="doccomment "> /// The "debug" level. 2415 /// 2416 /// Designates lower priority information. 2417</ span > Debug, 2418< span class ="doccomment "> /// The "trace" level. 2419 /// 2420 /// Designates very low priority, often extremely verbose, information. 2421</ span > Trace, 2422} 2423 2424< span class ="kw "> impl</ span > Clone< span class ="kw "> for</ span > Level { 2425< span class ="attribute "> #[inline] 2426</ span >< span class ="kw "> fn</ span > clone(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) -> Level { 2427< span class ="kw-2 "> *</ span >< span class ="self "> self 2428</ span > } 2429} 2430 2431< span class ="kw "> impl</ span > PartialEq< span class ="kw "> for</ span > Level { 2432< span class ="attribute "> #[inline] 2433</ span >< span class ="kw "> fn</ span > eq(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2434< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize ==< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2435 } 2436} 2437 2438< span class ="kw "> impl</ span > PartialEq<LevelFilter>< span class ="kw "> for</ span > Level { 2439< span class ="attribute "> #[inline] 2440</ span >< span class ="kw "> fn</ span > eq(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2441< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize ==< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2442 } 2443} 2444 2445< span class ="kw "> impl</ span > PartialOrd< span class ="kw "> for</ span > Level { 2446< span class ="attribute "> #[inline] 2447</ span >< span class ="kw "> fn</ span > partial_cmp(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) ->< span class ="prelude-ty "> Option</ span > <cmp::Ordering> { 2448< span class ="prelude-val "> Some</ span > (< span class ="self "> self</ span > .cmp(other)) 2449 } 2450 2451< span class ="attribute "> #[inline] 2452</ span >< span class ="kw "> fn</ span > lt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2453 (< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize) << span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2454 } 2455 2456< span class ="attribute "> #[inline] 2457</ span >< span class ="kw "> fn</ span > le(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2458< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize <=< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2459 } 2460 2461< span class ="attribute "> #[inline] 2462</ span >< span class ="kw "> fn</ span > gt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2463< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize >< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2464 } 2465 2466< span class ="attribute "> #[inline] 2467</ span >< span class ="kw "> fn</ span > ge(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2468< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize >=< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2469 } 2470} 2471 2472< span class ="kw "> impl</ span > PartialOrd<LevelFilter>< span class ="kw "> for</ span > Level { 2473< span class ="attribute "> #[inline] 2474</ span >< span class ="kw "> fn</ span > partial_cmp(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) ->< span class ="prelude-ty "> Option</ span > <cmp::Ordering> { 2475< span class ="prelude-val "> Some</ span > ((< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize).cmp(< span class ="kw-2 "> &</ span > (< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize))) 2476 } 2477 2478< span class ="attribute "> #[inline] 2479</ span >< span class ="kw "> fn</ span > lt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2480 (< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize) << span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2481 } 2482 2483< span class ="attribute "> #[inline] 2484</ span >< span class ="kw "> fn</ span > le(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2485< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize <=< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2486 } 2487 2488< span class ="attribute "> #[inline] 2489</ span >< span class ="kw "> fn</ span > gt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2490< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize >< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2491 } 2492 2493< span class ="attribute "> #[inline] 2494</ span >< span class ="kw "> fn</ span > ge(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2495< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize >=< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2496 } 2497} 2498 2499< span class ="kw "> impl</ span > Ord< span class ="kw "> for</ span > Level { 2500< span class ="attribute "> #[inline] 2501</ span >< span class ="kw "> fn</ span > cmp(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> cmp::Ordering { 2502 (< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize).cmp(< span class ="kw-2 "> &</ span > (< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize)) 2503 } 2504} 2505 2506< span class ="kw "> fn</ span > ok_or<T, E>(t:< span class ="prelude-ty "> Option</ span > <T>, e: E) ->< span class ="prelude-ty "> Result</ span > <T, E> { 2507< span class ="kw "> match</ span > t { 2508< span class ="prelude-val "> Some</ span > (t) =>< span class ="prelude-val "> Ok</ span > (t), 2509< span class ="prelude-val "> None</ span > =>< span class ="prelude-val "> Err</ span > (e), 2510 } 2511} 2512 2513< span class ="comment "> // Reimplemented here because std::ascii is not available in libcore 2514</ span >< span class ="kw "> fn</ span > eq_ignore_ascii_case(a:< span class ="kw-2 "> &</ span > str, b:< span class ="kw-2 "> &</ span > str) -> bool { 2515< span class ="kw "> fn</ span > to_ascii_uppercase(c: u8) -> u8 { 2516< span class ="kw "> if</ span > c >=< span class ="string "> b'a'</ span > && c <=< span class ="string "> b'z'</ span > { 2517 c -< span class ="string "> b'a'</ span > +< span class ="string "> b'A' 2518</ span > }< span class ="kw "> else</ span > { 2519 c 2520 } 2521 } 2522 2523< span class ="kw "> if</ span > a.len() == b.len() { 2524 a.bytes() 2525 .zip(b.bytes()) 2526 .all(|(a, b)| to_ascii_uppercase(a) == to_ascii_uppercase(b)) 2527 }< span class ="kw "> else</ span > { 2528< span class ="bool-val "> false 2529</ span > } 2530} 2531 2532< span class ="kw "> impl</ span > FromStr< span class ="kw "> for</ span > Level { 2533< span class ="kw "> type</ span >< span class ="prelude-val "> Err</ span > = ParseLevelError; 2534< span class ="kw "> fn</ span > from_str(level:< span class ="kw-2 "> &</ span > str) ->< span class ="prelude-ty "> Result</ span > <Level,< span class ="self "> Self</ span > ::Err> { 2535 ok_or( 2536 LOG_LEVEL_NAMES 2537 .iter() 2538 .position(|< span class ="kw-2 "> &</ span > name| eq_ignore_ascii_case(name, level)) 2539 .into_iter() 2540 .filter(|< span class ="kw-2 "> &</ span > idx| idx !=< span class ="number "> 0</ span > ) 2541 .map(|idx| Level::from_usize(idx).unwrap()) 2542 .next(), 2543 ParseLevelError(()), 2544 ) 2545 } 2546} 2547 2548< span class ="kw "> impl</ span > fmt::Display< span class ="kw "> for</ span > Level { 2549< span class ="kw "> fn</ span > fmt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , fmt:< span class ="kw-2 "> &mut</ span > fmt::Formatter) -> fmt::Result { 2550 fmt.pad(< span class ="self "> self</ span > .as_str()) 2551 } 2552} 2553 2554< span class ="kw "> impl</ span > Level { 2555< span class ="kw "> fn</ span > from_usize(u: usize) ->< span class ="prelude-ty "> Option</ span > <Level> { 2556< span class ="kw "> match</ span > u { 2557< span class ="number "> 1</ span > =>< span class ="prelude-val "> Some</ span > (Level::Error), 2558< span class ="number "> 2</ span > =>< span class ="prelude-val "> Some</ span > (Level::Warn), 2559< span class ="number "> 3</ span > =>< span class ="prelude-val "> Some</ span > (Level::Info), 2560< span class ="number "> 4</ span > =>< span class ="prelude-val "> Some</ span > (Level::Debug), 2561< span class ="number "> 5</ span > =>< span class ="prelude-val "> Some</ span > (Level::Trace), 2562< span class ="kw "> _</ span > =>< span class ="prelude-val "> None</ span > , 2563 } 2564 } 2565 2566< span class ="doccomment "> /// Returns the most verbose logging level. 2567</ span >< span class ="attribute "> #[inline] 2568</ span >< span class ="kw "> pub fn</ span > max() -> Level { 2569 Level::Trace 2570 } 2571 2572< span class ="doccomment "> /// Converts the `Level` to the equivalent `LevelFilter`. 2573</ span >< span class ="attribute "> #[inline] 2574</ span >< span class ="kw "> pub fn</ span > to_level_filter(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) -> LevelFilter { 2575 LevelFilter::from_usize(< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize).unwrap() 2576 } 2577 2578< span class ="doccomment "> /// Returns the string representation of the `Level`. 2579 /// 2580 /// This returns the same string as the `fmt::Display` implementation. 2581</ span >< span class ="kw "> pub fn</ span > as_str(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str { 2582 LOG_LEVEL_NAMES[< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize] 2583 } 2584 2585< span class ="doccomment "> /// Iterate through all supported logging levels. 2586 /// 2587 /// The order of iteration is from more severe to less severe log messages. 2588 /// 2589 /// # Examples 2590 /// 2591 /// ``` 2592 /// use log::Level; 2593 /// 2594 /// let mut levels = Level::iter(); 2595 /// 2596 /// assert_eq!(Some(Level::Error), levels.next()); 2597 /// assert_eq!(Some(Level::Trace), levels.last()); 2598 /// ``` 2599</ span >< span class ="kw "> pub fn</ span > iter() ->< span class ="kw "> impl</ span > Iterator<Item =< span class ="self "> Self</ span > > { 2600 (< span class ="number "> 1</ span > ..< span class ="number "> 6</ span > ).map(|i|< span class ="self "> Self</ span > ::from_usize(i).unwrap()) 2601 } 2602} 2603 2604< span class ="doccomment "> /// An enum representing the available verbosity level filters of the logger. 2605/// 2606/// A `LevelFilter` may be compared directly to a [`Level`]. Use this type 2607/// to get and set the maximum log level with [`max_level()`] and [`set_max_level`]. 2608/// 2609/// [`Level`]: enum.Level.html 2610/// [`max_level()`]: fn.max_level.html 2611/// [`set_max_level`]: fn.set_max_level.html 2612</ span >< span class ="attribute "> #[repr(usize)] 2613#[derive(Copy, Eq, Debug, Hash)] 2614</ span >< span class ="kw "> pub enum</ span > LevelFilter { 2615< span class ="doccomment "> /// A level lower than all log levels. 2616</ span > Off, 2617< span class ="doccomment "> /// Corresponds to the `Error` log level. 2618</ span > Error, 2619< span class ="doccomment "> /// Corresponds to the `Warn` log level. 2620</ span > Warn, 2621< span class ="doccomment "> /// Corresponds to the `Info` log level. 2622</ span > Info, 2623< span class ="doccomment "> /// Corresponds to the `Debug` log level. 2624</ span > Debug, 2625< span class ="doccomment "> /// Corresponds to the `Trace` log level. 2626</ span > Trace, 2627} 2628 2629< span class ="comment "> // Deriving generates terrible impls of these traits 2630 2631</ span >< span class ="kw "> impl</ span > Clone< span class ="kw "> for</ span > LevelFilter { 2632< span class ="attribute "> #[inline] 2633</ span >< span class ="kw "> fn</ span > clone(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) -> LevelFilter { 2634< span class ="kw-2 "> *</ span >< span class ="self "> self 2635</ span > } 2636} 2637 2638< span class ="kw "> impl</ span > PartialEq< span class ="kw "> for</ span > LevelFilter { 2639< span class ="attribute "> #[inline] 2640</ span >< span class ="kw "> fn</ span > eq(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2641< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize ==< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2642 } 2643} 2644 2645< span class ="kw "> impl</ span > PartialEq<Level>< span class ="kw "> for</ span > LevelFilter { 2646< span class ="attribute "> #[inline] 2647</ span >< span class ="kw "> fn</ span > eq(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2648 other.eq(< span class ="self "> self</ span > ) 2649 } 2650} 2651 2652< span class ="kw "> impl</ span > PartialOrd< span class ="kw "> for</ span > LevelFilter { 2653< span class ="attribute "> #[inline] 2654</ span >< span class ="kw "> fn</ span > partial_cmp(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) ->< span class ="prelude-ty "> Option</ span > <cmp::Ordering> { 2655< span class ="prelude-val "> Some</ span > (< span class ="self "> self</ span > .cmp(other)) 2656 } 2657 2658< span class ="attribute "> #[inline] 2659</ span >< span class ="kw "> fn</ span > lt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2660 (< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize) << span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2661 } 2662 2663< span class ="attribute "> #[inline] 2664</ span >< span class ="kw "> fn</ span > le(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2665< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize <=< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2666 } 2667 2668< span class ="attribute "> #[inline] 2669</ span >< span class ="kw "> fn</ span > gt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2670< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize >< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2671 } 2672 2673< span class ="attribute "> #[inline] 2674</ span >< span class ="kw "> fn</ span > ge(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> bool { 2675< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize >=< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2676 } 2677} 2678 2679< span class ="kw "> impl</ span > PartialOrd<Level>< span class ="kw "> for</ span > LevelFilter { 2680< span class ="attribute "> #[inline] 2681</ span >< span class ="kw "> fn</ span > partial_cmp(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) ->< span class ="prelude-ty "> Option</ span > <cmp::Ordering> { 2682< span class ="prelude-val "> Some</ span > ((< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize).cmp(< span class ="kw-2 "> &</ span > (< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize))) 2683 } 2684 2685< span class ="attribute "> #[inline] 2686</ span >< span class ="kw "> fn</ span > lt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2687 (< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize) << span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2688 } 2689 2690< span class ="attribute "> #[inline] 2691</ span >< span class ="kw "> fn</ span > le(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2692< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize <=< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2693 } 2694 2695< span class ="attribute "> #[inline] 2696</ span >< span class ="kw "> fn</ span > gt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2697< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize >< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2698 } 2699 2700< span class ="attribute "> #[inline] 2701</ span >< span class ="kw "> fn</ span > ge(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > Level) -> bool { 2702< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize >=< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize 2703 } 2704} 2705 2706< span class ="kw "> impl</ span > Ord< span class ="kw "> for</ span > LevelFilter { 2707< span class ="attribute "> #[inline] 2708</ span >< span class ="kw "> fn</ span > cmp(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , other:< span class ="kw-2 "> &</ span > LevelFilter) -> cmp::Ordering { 2709 (< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize).cmp(< span class ="kw-2 "> &</ span > (< span class ="kw-2 "> *</ span > other< span class ="kw "> as</ span > usize)) 2710 } 2711} 2712 2713< span class ="kw "> impl</ span > FromStr< span class ="kw "> for</ span > LevelFilter { 2714< span class ="kw "> type</ span >< span class ="prelude-val "> Err</ span > = ParseLevelError; 2715< span class ="kw "> fn</ span > from_str(level:< span class ="kw-2 "> &</ span > str) ->< span class ="prelude-ty "> Result</ span > <LevelFilter,< span class ="self "> Self</ span > ::Err> { 2716 ok_or( 2717 LOG_LEVEL_NAMES 2718 .iter() 2719 .position(|< span class ="kw-2 "> &</ span > name| eq_ignore_ascii_case(name, level)) 2720 .map(|p| LevelFilter::from_usize(p).unwrap()), 2721 ParseLevelError(()), 2722 ) 2723 } 2724} 2725 2726< span class ="kw "> impl</ span > fmt::Display< span class ="kw "> for</ span > LevelFilter { 2727< span class ="kw "> fn</ span > fmt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , fmt:< span class ="kw-2 "> &mut</ span > fmt::Formatter) -> fmt::Result { 2728 fmt.pad(< span class ="self "> self</ span > .as_str()) 2729 } 2730} 2731 2732< span class ="kw "> impl</ span > LevelFilter { 2733< span class ="kw "> fn</ span > from_usize(u: usize) ->< span class ="prelude-ty "> Option</ span > <LevelFilter> { 2734< span class ="kw "> match</ span > u { 2735< span class ="number "> 0</ span > =>< span class ="prelude-val "> Some</ span > (LevelFilter::Off), 2736< span class ="number "> 1</ span > =>< span class ="prelude-val "> Some</ span > (LevelFilter::Error), 2737< span class ="number "> 2</ span > =>< span class ="prelude-val "> Some</ span > (LevelFilter::Warn), 2738< span class ="number "> 3</ span > =>< span class ="prelude-val "> Some</ span > (LevelFilter::Info), 2739< span class ="number "> 4</ span > =>< span class ="prelude-val "> Some</ span > (LevelFilter::Debug), 2740< span class ="number "> 5</ span > =>< span class ="prelude-val "> Some</ span > (LevelFilter::Trace), 2741< span class ="kw "> _</ span > =>< span class ="prelude-val "> None</ span > , 2742 } 2743 } 2744 2745< span class ="doccomment "> /// Returns the most verbose logging level filter. 2746</ span >< span class ="attribute "> #[inline] 2747</ span >< span class ="kw "> pub fn</ span > max() -> LevelFilter { 2748 LevelFilter::Trace 2749 } 2750 2751< span class ="doccomment "> /// Converts `self` to the equivalent `Level`. 2752 /// 2753 /// Returns `None` if `self` is `LevelFilter::Off`. 2754</ span >< span class ="attribute "> #[inline] 2755</ span >< span class ="kw "> pub fn</ span > to_level(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="prelude-ty "> Option</ span > <Level> { 2756 Level::from_usize(< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize) 2757 } 2758 2759< span class ="doccomment "> /// Returns the string representation of the `LevelFilter`. 2760 /// 2761 /// This returns the same string as the `fmt::Display` implementation. 2762</ span >< span class ="kw "> pub fn</ span > as_str(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str { 2763 LOG_LEVEL_NAMES[< span class ="kw-2 "> *</ span >< span class ="self "> self</ span >< span class ="kw "> as</ span > usize] 2764 } 2765 2766< span class ="doccomment "> /// Iterate through all supported filtering levels. 2767 /// 2768 /// The order of iteration is from less to more verbose filtering. 2769 /// 2770 /// # Examples 2771 /// 2772 /// ``` 2773 /// use log::LevelFilter; 2774 /// 2775 /// let mut levels = LevelFilter::iter(); 2776 /// 2777 /// assert_eq!(Some(LevelFilter::Off), levels.next()); 2778 /// assert_eq!(Some(LevelFilter::Trace), levels.last()); 2779 /// ``` 2780</ span >< span class ="kw "> pub fn</ span > iter() ->< span class ="kw "> impl</ span > Iterator<Item =< span class ="self "> Self</ span > > { 2781 (< span class ="number "> 0</ span > ..< span class ="number "> 6</ span > ).map(|i|< span class ="self "> Self</ span > ::from_usize(i).unwrap()) 2782 } 2783} 2784 2785< span class ="attribute "> #[derive(Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Debug)] 2786</ span >< span class ="kw "> enum</ span > MaybeStaticStr<< span class ="lifetime "> 'a</ span > > { 2787 Static(< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str), 2788 Borrowed(< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str), 2789} 2790 2791< span class ="kw "> impl</ span > << span class ="lifetime "> 'a</ span > > MaybeStaticStr<< span class ="lifetime "> 'a</ span > > { 2792< span class ="attribute "> #[inline] 2793</ span >< span class ="kw "> fn</ span > get(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str { 2794< span class ="kw "> match</ span >< span class ="kw-2 "> *</ span >< span class ="self "> self</ span > { 2795 MaybeStaticStr::Static(s) => s, 2796 MaybeStaticStr::Borrowed(s) => s, 2797 } 2798 } 2799} 2800 2801< span class ="doccomment "> /// The "payload" of a log message. 2802/// 2803/// # Use 2804/// 2805/// `Record` structures are passed as parameters to the [`log`][method.log] 2806/// method of the [`Log`] trait. Logger implementors manipulate these 2807/// structures in order to display log messages. `Record`s are automatically 2808/// created by the [`log!`] macro and so are not seen by log users. 2809/// 2810/// Note that the [`level()`] and [`target()`] accessors are equivalent to 2811/// `self.metadata().level()` and `self.metadata().target()` respectively. 2812/// These methods are provided as a convenience for users of this structure. 2813/// 2814/// # Example 2815/// 2816/// The following example shows a simple logger that displays the level, 2817/// module path, and message of any `Record` that is passed to it. 2818/// 2819/// ```edition2018 2820/// struct SimpleLogger; 2821/// 2822/// impl log::Log for SimpleLogger { 2823/// fn enabled(&self, metadata: &log::Metadata) -> bool { 2824/// true 2825/// } 2826/// 2827/// fn log(&self, record: &log::Record) { 2828/// if !self.enabled(record.metadata()) { 2829/// return; 2830/// } 2831/// 2832/// println!("{}:{} -- {}", 2833/// record.level(), 2834/// record.target(), 2835/// record.args()); 2836/// } 2837/// fn flush(&self) {} 2838/// } 2839/// ``` 2840/// 2841/// [method.log]: trait.Log.html#tymethod.log 2842/// [`Log`]: trait.Log.html 2843/// [`log!`]: macro.log.html 2844/// [`level()`]: struct.Record.html#method.level 2845/// [`target()`]: struct.Record.html#method.target 2846</ span >< span class ="attribute "> #[derive(Clone, Debug)] 2847</ span >< span class ="kw "> pub struct</ span > Record<< span class ="lifetime "> 'a</ span > > { 2848 metadata: Metadata<< span class ="lifetime "> 'a</ span > >, 2849 args: fmt::Arguments<< span class ="lifetime "> 'a</ span > >, 2850 module_path:< span class ="prelude-ty "> Option</ span > <MaybeStaticStr<< span class ="lifetime "> 'a</ span > >>, 2851 file:< span class ="prelude-ty "> Option</ span > <MaybeStaticStr<< span class ="lifetime "> 'a</ span > >>, 2852 line:< span class ="prelude-ty "> Option</ span > <u32>, 2853< span class ="attribute "> #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 2854</ span > key_values: KeyValues<< span class ="lifetime "> 'a</ span > >, 2855} 2856 2857< span class ="comment "> // This wrapper type is only needed so we can 2858// `#[derive(Debug)]` on `Record`. It also 2859// provides a useful `Debug` implementation for 2860// the underlying `Source`. 2861</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 2862#[derive(Clone)] 2863</ span >< span class ="kw "> struct</ span > KeyValues<< span class ="lifetime "> 'a</ span > >(< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span >< span class ="kw "> dyn</ span > kv::Source); 2864 2865< span class ="attribute "> #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 2866</ span >< span class ="kw "> impl</ span > << span class ="lifetime "> 'a</ span > > fmt::Debug< span class ="kw "> for</ span > KeyValues<< span class ="lifetime "> 'a</ span > > { 2867< 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) -> fmt::Result { 2868< span class ="kw "> let</ span >< span class ="kw-2 "> mut</ span > visitor = f.debug_map(); 2869< span class ="self "> self</ span > .< span class ="number "> 0</ span > .visit(< span class ="kw-2 "> &mut</ span > visitor).map_err(|< span class ="kw "> _</ span > | fmt::Error)< span class ="question-mark "> ?</ span > ; 2870 visitor.finish() 2871 } 2872} 2873 2874< span class ="kw "> impl</ span > << span class ="lifetime "> 'a</ span > > Record<< span class ="lifetime "> 'a</ span > > { 2875< span class ="doccomment "> /// Returns a new builder. 2876</ span >< span class ="attribute "> #[inline] 2877</ span >< span class ="kw "> pub fn</ span > builder() -> RecordBuilder<< span class ="lifetime "> 'a</ span > > { 2878 RecordBuilder::new() 2879 } 2880 2881< span class ="doccomment "> /// The message body. 2882</ span >< span class ="attribute "> #[inline] 2883</ span >< span class ="kw "> pub fn</ span > args(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="kw-2 "> &</ span > fmt::Arguments<< span class ="lifetime "> 'a</ span > > { 2884< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > .args 2885 } 2886 2887< span class ="doccomment "> /// Metadata about the log directive. 2888</ span >< span class ="attribute "> #[inline] 2889</ span >< span class ="kw "> pub fn</ span > metadata(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="kw-2 "> &</ span > Metadata<< span class ="lifetime "> 'a</ span > > { 2890< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > .metadata 2891 } 2892 2893< span class ="doccomment "> /// The verbosity level of the message. 2894</ span >< span class ="attribute "> #[inline] 2895</ span >< span class ="kw "> pub fn</ span > level(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) -> Level { 2896< span class ="self "> self</ span > .metadata.level() 2897 } 2898 2899< span class ="doccomment "> /// The name of the target of the directive. 2900</ span >< span class ="attribute "> #[inline] 2901</ span >< span class ="kw "> pub fn</ span > target(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str { 2902< span class ="self "> self</ span > .metadata.target() 2903 } 2904 2905< span class ="doccomment "> /// The module path of the message. 2906</ span >< span class ="attribute "> #[inline] 2907</ span >< span class ="kw "> pub fn</ span > module_path(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str> { 2908< span class ="self "> self</ span > .module_path.map(|s| s.get()) 2909 } 2910 2911< span class ="doccomment "> /// The module path of the message, if it is a `'static` string. 2912</ span >< span class ="attribute "> #[inline] 2913</ span >< span class ="kw "> pub fn</ span > module_path_static(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str> { 2914< span class ="kw "> match</ span >< span class ="self "> self</ span > .module_path { 2915< span class ="prelude-val "> Some</ span > (MaybeStaticStr::Static(s)) =>< span class ="prelude-val "> Some</ span > (s), 2916< span class ="kw "> _</ span > =>< span class ="prelude-val "> None</ span > , 2917 } 2918 } 2919 2920< span class ="doccomment "> /// The source file containing the message. 2921</ span >< span class ="attribute "> #[inline] 2922</ span >< span class ="kw "> pub fn</ span > file(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str> { 2923< span class ="self "> self</ span > .file.map(|s| s.get()) 2924 } 2925 2926< span class ="doccomment "> /// The module path of the message, if it is a `'static` string. 2927</ span >< span class ="attribute "> #[inline] 2928</ span >< span class ="kw "> pub fn</ span > file_static(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str> { 2929< span class ="kw "> match</ span >< span class ="self "> self</ span > .file { 2930< span class ="prelude-val "> Some</ span > (MaybeStaticStr::Static(s)) =>< span class ="prelude-val "> Some</ span > (s), 2931< span class ="kw "> _</ span > =>< span class ="prelude-val "> None</ span > , 2932 } 2933 } 2934 2935< span class ="doccomment "> /// The line containing the message. 2936</ span >< span class ="attribute "> #[inline] 2937</ span >< span class ="kw "> pub fn</ span > line(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="prelude-ty "> Option</ span > <u32> { 2938< span class ="self "> self</ span > .line 2939 } 2940 2941< span class ="doccomment "> /// The structured key-value pairs associated with the message. 2942</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 2943 #[inline] 2944</ span >< span class ="kw "> pub fn</ span > key_values(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="kw-2 "> &</ span >< span class ="kw "> dyn</ span > kv::Source { 2945< span class ="self "> self</ span > .key_values.< span class ="number "> 0 2946</ span > } 2947 2948< span class ="doccomment "> /// Create a new [`RecordBuilder`](struct.RecordBuilder.html) based on this record. 2949</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 2950 #[inline] 2951</ span >< span class ="kw "> pub fn</ span > to_builder(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) -> RecordBuilder { 2952 RecordBuilder { 2953 record: Record { 2954 metadata: Metadata { 2955 level:< span class ="self "> self</ span > .metadata.level, 2956 target:< span class ="self "> self</ span > .metadata.target, 2957 }, 2958 args:< span class ="self "> self</ span > .args, 2959 module_path:< span class ="self "> self</ span > .module_path, 2960 file:< span class ="self "> self</ span > .file, 2961 line:< span class ="self "> self</ span > .line, 2962 key_values:< span class ="self "> self</ span > .key_values.clone(), 2963 }, 2964 } 2965 } 2966} 2967 2968< span class ="doccomment "> /// Builder for [`Record`](struct.Record.html). 2969/// 2970/// Typically should only be used by log library creators or for testing and "shim loggers". 2971/// The `RecordBuilder` can set the different parameters of `Record` object, and returns 2972/// the created object when `build` is called. 2973/// 2974/// # Examples 2975/// 2976/// ```edition2018 2977/// use log::{Level, Record}; 2978/// 2979/// let record = Record::builder() 2980/// .args(format_args!("Error!")) 2981/// .level(Level::Error) 2982/// .target("myApp") 2983/// .file(Some("server.rs")) 2984/// .line(Some(144)) 2985/// .module_path(Some("server")) 2986/// .build(); 2987/// ``` 2988/// 2989/// Alternatively, use [`MetadataBuilder`](struct.MetadataBuilder.html): 2990/// 2991/// ```edition2018 2992/// use log::{Record, Level, MetadataBuilder}; 2993/// 2994/// let error_metadata = MetadataBuilder::new() 2995/// .target("myApp") 2996/// .level(Level::Error) 2997/// .build(); 2998/// 2999/// let record = Record::builder() 3000/// .metadata(error_metadata) 3001/// .args(format_args!("Error!")) 3002/// .line(Some(433)) 3003/// .file(Some("app.rs")) 3004/// .module_path(Some("server")) 3005/// .build(); 3006/// ``` 3007</ span >< span class ="attribute "> #[derive(Debug)] 3008</ span >< span class ="kw "> pub struct</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3009 record: Record<< span class ="lifetime "> 'a</ span > >, 3010} 3011 3012< span class ="kw "> impl</ span > << span class ="lifetime "> 'a</ span > > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3013< span class ="doccomment "> /// Construct new `RecordBuilder`. 3014 /// 3015 /// The default options are: 3016 /// 3017 /// - `args`: [`format_args!("")`] 3018 /// - `metadata`: [`Metadata::builder().build()`] 3019 /// - `module_path`: `None` 3020 /// - `file`: `None` 3021 /// - `line`: `None` 3022 /// 3023 /// [`format_args!("")`]: https://doc.rust-lang.org/std/macro.format_args.html 3024 /// [`Metadata::builder().build()`]: struct.MetadataBuilder.html#method.build 3025</ span >< span class ="attribute "> #[inline] 3026</ span >< span class ="kw "> pub fn</ span > new() -> RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3027 RecordBuilder { 3028 record: Record { 3029 args:< span class ="macro "> format_args!</ span > (< span class ="string "> ""</ span > ), 3030 metadata: Metadata::builder().build(), 3031 module_path:< span class ="prelude-val "> None</ span > , 3032 file:< span class ="prelude-val "> None</ span > , 3033 line:< span class ="prelude-val "> None</ span > , 3034< span class ="attribute "> #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 3035</ span > key_values: KeyValues(< span class ="kw-2 "> &</ span > Option::None::<(kv::Key, kv::Value)>), 3036 }, 3037 } 3038 } 3039 3040< span class ="doccomment "> /// Set [`args`](struct.Record.html#method.args). 3041</ span >< span class ="attribute "> #[inline] 3042</ span >< span class ="kw "> pub fn</ span > args(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , args: fmt::Arguments<< span class ="lifetime "> 'a</ span > >) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3043< span class ="self "> self</ span > .record.args = args; 3044< span class ="self "> self 3045</ span > } 3046 3047< span class ="doccomment "> /// Set [`metadata`](struct.Record.html#method.metadata). Construct a `Metadata` object with [`MetadataBuilder`](struct.MetadataBuilder.html). 3048</ span >< span class ="attribute "> #[inline] 3049</ span >< span class ="kw "> pub fn</ span > metadata(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , metadata: Metadata<< span class ="lifetime "> 'a</ span > >) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3050< span class ="self "> self</ span > .record.metadata = metadata; 3051< span class ="self "> self 3052</ span > } 3053 3054< span class ="doccomment "> /// Set [`Metadata::level`](struct.Metadata.html#method.level). 3055</ span >< span class ="attribute "> #[inline] 3056</ span >< span class ="kw "> pub fn</ span > level(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , level: Level) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3057< span class ="self "> self</ span > .record.metadata.level = level; 3058< span class ="self "> self 3059</ span > } 3060 3061< span class ="doccomment "> /// Set [`Metadata::target`](struct.Metadata.html#method.target) 3062</ span >< span class ="attribute "> #[inline] 3063</ span >< span class ="kw "> pub fn</ span > target(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , target:< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3064< span class ="self "> self</ span > .record.metadata.target = target; 3065< span class ="self "> self 3066</ span > } 3067 3068< span class ="doccomment "> /// Set [`module_path`](struct.Record.html#method.module_path) 3069</ span >< span class ="attribute "> #[inline] 3070</ span >< span class ="kw "> pub fn</ span > module_path(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , path:< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str>) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3071< span class ="self "> self</ span > .record.module_path = path.map(MaybeStaticStr::Borrowed); 3072< span class ="self "> self 3073</ span > } 3074 3075< span class ="doccomment "> /// Set [`module_path`](struct.Record.html#method.module_path) to a `'static` string 3076</ span >< span class ="attribute "> #[inline] 3077</ span >< span class ="kw "> pub fn</ span > module_path_static(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , path:< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str>) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3078< span class ="self "> self</ span > .record.module_path = path.map(MaybeStaticStr::Static); 3079< span class ="self "> self 3080</ span > } 3081 3082< span class ="doccomment "> /// Set [`file`](struct.Record.html#method.file) 3083</ span >< span class ="attribute "> #[inline] 3084</ span >< span class ="kw "> pub fn</ span > file(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , file:< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str>) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3085< span class ="self "> self</ span > .record.file = file.map(MaybeStaticStr::Borrowed); 3086< span class ="self "> self 3087</ span > } 3088 3089< span class ="doccomment "> /// Set [`file`](struct.Record.html#method.file) to a `'static` string. 3090</ span >< span class ="attribute "> #[inline] 3091</ span >< span class ="kw "> pub fn</ span > file_static(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , file:< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str>) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3092< span class ="self "> self</ span > .record.file = file.map(MaybeStaticStr::Static); 3093< span class ="self "> self 3094</ span > } 3095 3096< span class ="doccomment "> /// Set [`line`](struct.Record.html#method.line) 3097</ span >< span class ="attribute "> #[inline] 3098</ span >< span class ="kw "> pub fn</ span > line(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , line:< span class ="prelude-ty "> Option</ span > <u32>) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3099< span class ="self "> self</ span > .record.line = line; 3100< span class ="self "> self 3101</ span > } 3102 3103< span class ="doccomment "> /// Set [`key_values`](struct.Record.html#method.key_values) 3104</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 3105 #[inline] 3106</ span >< span class ="kw "> pub fn</ span > key_values(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , kvs:< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span >< span class ="kw "> dyn</ span > kv::Source) ->< span class ="kw-2 "> &mut</ span > RecordBuilder<< span class ="lifetime "> 'a</ span > > { 3107< span class ="self "> self</ span > .record.key_values = KeyValues(kvs); 3108< span class ="self "> self 3109</ span > } 3110 3111< span class ="doccomment "> /// Invoke the builder and return a `Record` 3112</ span >< span class ="attribute "> #[inline] 3113</ span >< span class ="kw "> pub fn</ span > build(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) -> Record<< span class ="lifetime "> 'a</ span > > { 3114< span class ="self "> self</ span > .record.clone() 3115 } 3116} 3117 3118< span class ="doccomment "> /// Metadata about a log message. 3119/// 3120/// # Use 3121/// 3122/// `Metadata` structs are created when users of the library use 3123/// logging macros. 3124/// 3125/// They are consumed by implementations of the `Log` trait in the 3126/// `enabled` method. 3127/// 3128/// `Record`s use `Metadata` to determine the log message's severity 3129/// and target. 3130/// 3131/// Users should use the `log_enabled!` macro in their code to avoid 3132/// constructing expensive log messages. 3133/// 3134/// # Examples 3135/// 3136/// ```edition2018 3137/// use log::{Record, Level, Metadata}; 3138/// 3139/// struct MyLogger; 3140/// 3141/// impl log::Log for MyLogger { 3142/// fn enabled(&self, metadata: &Metadata) -> bool { 3143/// metadata.level() <= Level::Info 3144/// } 3145/// 3146/// fn log(&self, record: &Record) { 3147/// if self.enabled(record.metadata()) { 3148/// println!("{} - {}", record.level(), record.args()); 3149/// } 3150/// } 3151/// fn flush(&self) {} 3152/// } 3153/// 3154/// # fn main(){} 3155/// ``` 3156</ span >< span class ="attribute "> #[derive(Clone, Eq, PartialEq, Ord, PartialOrd, Hash, Debug)] 3157</ span >< span class ="kw "> pub struct</ span > Metadata<< span class ="lifetime "> 'a</ span > > { 3158 level: Level, 3159 target:< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str, 3160} 3161 3162< span class ="kw "> impl</ span > << span class ="lifetime "> 'a</ span > > Metadata<< span class ="lifetime "> 'a</ span > > { 3163< span class ="doccomment "> /// Returns a new builder. 3164</ span >< span class ="attribute "> #[inline] 3165</ span >< span class ="kw "> pub fn</ span > builder() -> MetadataBuilder<< span class ="lifetime "> 'a</ span > > { 3166 MetadataBuilder::new() 3167 } 3168 3169< span class ="doccomment "> /// The verbosity level of the message. 3170</ span >< span class ="attribute "> #[inline] 3171</ span >< span class ="kw "> pub fn</ span > level(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) -> Level { 3172< span class ="self "> self</ span > .level 3173 } 3174 3175< span class ="doccomment "> /// The name of the target of the directive. 3176</ span >< span class ="attribute "> #[inline] 3177</ span >< span class ="kw "> pub fn</ span > target(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) ->< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str { 3178< span class ="self "> self</ span > .target 3179 } 3180} 3181 3182< span class ="doccomment "> /// Builder for [`Metadata`](struct.Metadata.html). 3183/// 3184/// Typically should only be used by log library creators or for testing and "shim loggers". 3185/// The `MetadataBuilder` can set the different parameters of a `Metadata` object, and returns 3186/// the created object when `build` is called. 3187/// 3188/// # Example 3189/// 3190/// ```edition2018 3191/// let target = "myApp"; 3192/// use log::{Level, MetadataBuilder}; 3193/// let metadata = MetadataBuilder::new() 3194/// .level(Level::Debug) 3195/// .target(target) 3196/// .build(); 3197/// ``` 3198</ span >< span class ="attribute "> #[derive(Eq, PartialEq, Ord, PartialOrd, Hash, Debug)] 3199</ span >< span class ="kw "> pub struct</ span > MetadataBuilder<< span class ="lifetime "> 'a</ span > > { 3200 metadata: Metadata<< span class ="lifetime "> 'a</ span > >, 3201} 3202 3203< span class ="kw "> impl</ span > << span class ="lifetime "> 'a</ span > > MetadataBuilder<< span class ="lifetime "> 'a</ span > > { 3204< span class ="doccomment "> /// Construct a new `MetadataBuilder`. 3205 /// 3206 /// The default options are: 3207 /// 3208 /// - `level`: `Level::Info` 3209 /// - `target`: `""` 3210</ span >< span class ="attribute "> #[inline] 3211</ span >< span class ="kw "> pub fn</ span > new() -> MetadataBuilder<< span class ="lifetime "> 'a</ span > > { 3212 MetadataBuilder { 3213 metadata: Metadata { 3214 level: Level::Info, 3215 target:< span class ="string "> ""</ span > , 3216 }, 3217 } 3218 } 3219 3220< span class ="doccomment "> /// Setter for [`level`](struct.Metadata.html#method.level). 3221</ span >< span class ="attribute "> #[inline] 3222</ span >< span class ="kw "> pub fn</ span > level(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , arg: Level) ->< span class ="kw-2 "> &mut</ span > MetadataBuilder<< span class ="lifetime "> 'a</ span > > { 3223< span class ="self "> self</ span > .metadata.level = arg; 3224< span class ="self "> self 3225</ span > } 3226 3227< span class ="doccomment "> /// Setter for [`target`](struct.Metadata.html#method.target). 3228</ span >< span class ="attribute "> #[inline] 3229</ span >< span class ="kw "> pub fn</ span > target(< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , target:< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'a</ span > str) ->< span class ="kw-2 "> &mut</ span > MetadataBuilder<< span class ="lifetime "> 'a</ span > > { 3230< span class ="self "> self</ span > .metadata.target = target; 3231< span class ="self "> self 3232</ span > } 3233 3234< span class ="doccomment "> /// Returns a `Metadata` object. 3235</ span >< span class ="attribute "> #[inline] 3236</ span >< span class ="kw "> pub fn</ span > build(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) -> Metadata<< span class ="lifetime "> 'a</ span > > { 3237< span class ="self "> self</ span > .metadata.clone() 3238 } 3239} 3240 3241< span class ="doccomment "> /// A trait encapsulating the operations required of a logger. 3242</ span >< span class ="kw "> pub trait</ span > Log: Sync + Send { 3243< span class ="doccomment "> /// Determines if a log message with the specified metadata would be 3244 /// logged. 3245 /// 3246 /// This is used by the `log_enabled!` macro to allow callers to avoid 3247 /// expensive computation of log message arguments if the message would be 3248 /// discarded anyway. 3249 /// 3250 /// # For implementors 3251 /// 3252 /// This method isn't called automatically by the `log!` macros. 3253 /// It's up to an implementation of the `Log` trait to call `enabled` in its own 3254 /// `log` method implementation to guarantee that filtering is applied. 3255</ span >< span class ="kw "> fn</ span > enabled(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , metadata:< span class ="kw-2 "> &</ span > Metadata) -> bool; 3256 3257< span class ="doccomment "> /// Logs the `Record`. 3258 /// 3259 /// # For implementors 3260 /// 3261 /// Note that `enabled` is *not* necessarily called before this method. 3262 /// Implementations of `log` should perform all necessary filtering 3263 /// internally. 3264</ span >< span class ="kw "> fn</ span > log(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , record:< span class ="kw-2 "> &</ span > Record); 3265 3266< span class ="doccomment "> /// Flushes any buffered records. 3267</ span >< span class ="kw "> fn</ span > flush(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ); 3268} 3269 3270< span class ="comment "> // Just used as a dummy initial value for LOGGER 3271</ span >< span class ="kw "> struct</ span > NopLogger; 3272 3273< span class ="kw "> impl</ span > Log< span class ="kw "> for</ span > NopLogger { 3274< span class ="kw "> fn</ span > enabled(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ,< span class ="kw "> _</ span > :< span class ="kw-2 "> &</ span > Metadata) -> bool { 3275< span class ="bool-val "> false 3276</ span > } 3277 3278< span class ="kw "> fn</ span > log(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ,< span class ="kw "> _</ span > :< span class ="kw-2 "> &</ span > Record) {} 3279< span class ="kw "> fn</ span > flush(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) {} 3280} 3281 3282< span class ="kw "> impl</ span > <T> Log< span class ="kw "> for</ span >< span class ="kw-2 "> &</ span >< span class ="lifetime "> '_</ span > T 3283< span class ="kw "> where 3284</ span > T:< span class ="question-mark "> ?</ span > Sized + Log, 3285{ 3286< span class ="kw "> fn</ span > enabled(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , metadata:< span class ="kw-2 "> &</ span > Metadata) -> bool { 3287 (< span class ="kw-2 "> **</ span >< span class ="self "> self</ span > ).enabled(metadata) 3288 } 3289 3290< span class ="kw "> fn</ span > log(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , record:< span class ="kw-2 "> &</ span > Record) { 3291 (< span class ="kw-2 "> **</ span >< span class ="self "> self</ span > ).log(record) 3292 } 3293< span class ="kw "> fn</ span > flush(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) { 3294 (< span class ="kw-2 "> **</ span >< span class ="self "> self</ span > ).flush() 3295 } 3296} 3297 3298< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 3299</ span >< span class ="kw "> impl</ span > <T> Log< span class ="kw "> for</ span > std::boxed::Box<T> 3300< span class ="kw "> where 3301</ span > T:< span class ="question-mark "> ?</ span > Sized + Log, 3302{ 3303< span class ="kw "> fn</ span > enabled(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , metadata:< span class ="kw-2 "> &</ span > Metadata) -> bool { 3304< span class ="self "> self</ span > .as_ref().enabled(metadata) 3305 } 3306 3307< span class ="kw "> fn</ span > log(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , record:< span class ="kw-2 "> &</ span > Record) { 3308< span class ="self "> self</ span > .as_ref().log(record) 3309 } 3310< span class ="kw "> fn</ span > flush(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) { 3311< span class ="self "> self</ span > .as_ref().flush() 3312 } 3313} 3314 3315< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 3316</ span >< span class ="kw "> impl</ span > <T> Log< span class ="kw "> for</ span > std::sync::Arc<T> 3317< span class ="kw "> where 3318</ span > T:< span class ="question-mark "> ?</ span > Sized + Log, 3319{ 3320< span class ="kw "> fn</ span > enabled(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , metadata:< span class ="kw-2 "> &</ span > Metadata) -> bool { 3321< span class ="self "> self</ span > .as_ref().enabled(metadata) 3322 } 3323 3324< span class ="kw "> fn</ span > log(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , record:< span class ="kw-2 "> &</ span > Record) { 3325< span class ="self "> self</ span > .as_ref().log(record) 3326 } 3327< span class ="kw "> fn</ span > flush(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > ) { 3328< span class ="self "> self</ span > .as_ref().flush() 3329 } 3330} 3331 3332< span class ="doccomment "> /// Sets the global maximum log level. 3333/// 3334/// Generally, this should only be called by the active logging implementation. 3335/// 3336/// Note that `Trace` is the maximum level, because it provides the maximum amount of detail in the emitted logs. 3337</ span >< span class ="attribute "> #[inline] 3338</ span >< span class ="kw "> pub fn</ span > set_max_level(level: LevelFilter) { 3339 MAX_LOG_LEVEL_FILTER.store(level< span class ="kw "> as</ span > usize, Ordering::Relaxed) 3340} 3341 3342< span class ="doccomment "> /// Returns the current maximum log level. 3343/// 3344/// The [`log!`], [`error!`], [`warn!`], [`info!`], [`debug!`], and [`trace!`] macros check 3345/// this value and discard any message logged at a higher level. The maximum 3346/// log level is set by the [`set_max_level`] function. 3347/// 3348/// [`log!`]: macro.log.html 3349/// [`error!`]: macro.error.html 3350/// [`warn!`]: macro.warn.html 3351/// [`info!`]: macro.info.html 3352/// [`debug!`]: macro.debug.html 3353/// [`trace!`]: macro.trace.html 3354/// [`set_max_level`]: fn.set_max_level.html 3355</ span >< span class ="attribute "> #[inline(always)] 3356</ span >< span class ="kw "> pub fn</ span > max_level() -> LevelFilter { 3357< span class ="comment "> // Since `LevelFilter` is `repr(usize)`, 3358 // this transmute is sound if and only if `MAX_LOG_LEVEL_FILTER` 3359 // is set to a usize that is a valid discriminant for `LevelFilter`. 3360 // Since `MAX_LOG_LEVEL_FILTER` is private, the only time it's set 3361 // is by `set_max_level` above, i.e. by casting a `LevelFilter` to `usize`. 3362 // So any usize stored in `MAX_LOG_LEVEL_FILTER` is a valid discriminant. 3363</ span >< span class ="kw "> unsafe</ span > { mem::transmute(MAX_LOG_LEVEL_FILTER.load(Ordering::Relaxed)) } 3364} 3365 3366< span class ="doccomment "> /// Sets the global logger to a `Box<Log>`. 3367/// 3368/// This is a simple convenience wrapper over `set_logger`, which takes a 3369/// `Box<Log>` rather than a `&'static Log`. See the documentation for 3370/// [`set_logger`] for more details. 3371/// 3372/// Requires the `std` feature. 3373/// 3374/// # Errors 3375/// 3376/// An error is returned if a logger has already been set. 3377/// 3378/// [`set_logger`]: fn.set_logger.html 3379</ span >< span class ="attribute "> #[cfg(all(feature =< span class ="string "> "std"</ span > , atomic_cas))] 3380</ span >< span class ="kw "> pub fn</ span > set_boxed_logger(logger: Box<< span class ="kw "> dyn</ span > Log>) ->< span class ="prelude-ty "> Result</ span > <(), SetLoggerError> { 3381 set_logger_inner(|| Box::leak(logger)) 3382} 3383 3384< span class ="doccomment "> /// Sets the global logger to a `&'static Log`. 3385/// 3386/// This function may only be called once in the lifetime of a program. Any log 3387/// events that occur before the call to `set_logger` completes will be ignored. 3388/// 3389/// This function does not typically need to be called manually. Logger 3390/// implementations should provide an initialization method that installs the 3391/// logger internally. 3392/// 3393/// # Availability 3394/// 3395/// This method is available even when the `std` feature is disabled. However, 3396/// it is currently unavailable on `thumbv6` targets, which lack support for 3397/// some atomic operations which are used by this function. Even on those 3398/// targets, [`set_logger_racy`] will be available. 3399/// 3400/// # Errors 3401/// 3402/// An error is returned if a logger has already been set. 3403/// 3404/// # Examples 3405/// 3406/// ```edition2018 3407/// use log::{error, info, warn, Record, Level, Metadata, LevelFilter}; 3408/// 3409/// static MY_LOGGER: MyLogger = MyLogger; 3410/// 3411/// struct MyLogger; 3412/// 3413/// impl log::Log for MyLogger { 3414/// fn enabled(&self, metadata: &Metadata) -> bool { 3415/// metadata.level() <= Level::Info 3416/// } 3417/// 3418/// fn log(&self, record: &Record) { 3419/// if self.enabled(record.metadata()) { 3420/// println!("{} - {}", record.level(), record.args()); 3421/// } 3422/// } 3423/// fn flush(&self) {} 3424/// } 3425/// 3426/// # fn main(){ 3427/// log::set_logger(&MY_LOGGER).unwrap(); 3428/// log::set_max_level(LevelFilter::Info); 3429/// 3430/// info!("hello log"); 3431/// warn!("warning"); 3432/// error!("oops"); 3433/// # } 3434/// ``` 3435/// 3436/// [`set_logger_racy`]: fn.set_logger_racy.html 3437</ span >< span class ="attribute "> #[cfg(atomic_cas)] 3438</ span >< span class ="kw "> pub fn</ span > set_logger(logger:< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span >< span class ="kw "> dyn</ span > Log) ->< span class ="prelude-ty "> Result</ span > <(), SetLoggerError> { 3439 set_logger_inner(|| logger) 3440} 3441 3442< span class ="attribute "> #[cfg(atomic_cas)] 3443</ span >< span class ="kw "> fn</ span > set_logger_inner<F>(make_logger: F) ->< span class ="prelude-ty "> Result</ span > <(), SetLoggerError> 3444< span class ="kw "> where 3445</ span > F: FnOnce() ->< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span >< span class ="kw "> dyn</ span > Log, 3446{ 3447< span class ="kw "> let</ span > old_state =< span class ="kw "> match</ span > STATE.compare_exchange( 3448 UNINITIALIZED, 3449 INITIALIZING, 3450 Ordering::SeqCst, 3451 Ordering::SeqCst, 3452 ) { 3453< span class ="prelude-val "> Ok</ span > (s) |< span class ="prelude-val "> Err</ span > (s) => s, 3454 }; 3455< span class ="kw "> match</ span > old_state { 3456 UNINITIALIZED => { 3457< span class ="kw "> unsafe</ span > { 3458 LOGGER = make_logger(); 3459 } 3460 STATE.store(INITIALIZED, Ordering::SeqCst); 3461< span class ="prelude-val "> Ok</ span > (()) 3462 } 3463 INITIALIZING => { 3464< span class ="kw "> while</ span > STATE.load(Ordering::SeqCst) == INITIALIZING { 3465< span class ="comment "> // TODO: replace with `hint::spin_loop` once MSRV is 1.49.0. 3466</ span >< span class ="attribute "> #[allow(deprecated)] 3467</ span > std::sync::atomic::spin_loop_hint(); 3468 } 3469< span class ="prelude-val "> Err</ span > (SetLoggerError(())) 3470 } 3471< span class ="kw "> _</ span > =>< span class ="prelude-val "> Err</ span > (SetLoggerError(())), 3472 } 3473} 3474 3475< span class ="doccomment "> /// A thread-unsafe version of [`set_logger`]. 3476/// 3477/// This function is available on all platforms, even those that do not have 3478/// support for atomics that is needed by [`set_logger`]. 3479/// 3480/// In almost all cases, [`set_logger`] should be preferred. 3481/// 3482/// # Safety 3483/// 3484/// This function is only safe to call when no other logger initialization 3485/// function is called while this function still executes. 3486/// 3487/// This can be upheld by (for example) making sure that **there are no other 3488/// threads**, and (on embedded) that **interrupts are disabled**. 3489/// 3490/// It is safe to use other logging functions while this function runs 3491/// (including all logging macros). 3492/// 3493/// [`set_logger`]: fn.set_logger.html 3494</ span >< span class ="kw "> pub unsafe fn</ span > set_logger_racy(logger:< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span >< span class ="kw "> dyn</ span > Log) ->< span class ="prelude-ty "> Result</ span > <(), SetLoggerError> { 3495< span class ="kw "> match</ span > STATE.load(Ordering::SeqCst) { 3496 UNINITIALIZED => { 3497 LOGGER = logger; 3498 STATE.store(INITIALIZED, Ordering::SeqCst); 3499< span class ="prelude-val "> Ok</ span > (()) 3500 } 3501 INITIALIZING => { 3502< span class ="comment "> // This is just plain UB, since we were racing another initialization function 3503</ span >< span class ="macro "> unreachable!</ span > (< span class ="string "> "set_logger_racy must not be used with other initialization functions"</ span > ) 3504 } 3505< span class ="kw "> _</ span > =>< span class ="prelude-val "> Err</ span > (SetLoggerError(())), 3506 } 3507} 3508 3509< span class ="doccomment "> /// The type returned by [`set_logger`] if [`set_logger`] has already been called. 3510/// 3511/// [`set_logger`]: fn.set_logger.html 3512</ span >< span class ="attribute "> #[allow(missing_copy_implementations)] 3513#[derive(Debug)] 3514</ span >< span class ="kw "> pub struct</ span > SetLoggerError(()); 3515 3516< span class ="kw "> impl</ span > fmt::Display< span class ="kw "> for</ span > SetLoggerError { 3517< span class ="kw "> fn</ span > fmt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , fmt:< span class ="kw-2 "> &mut</ span > fmt::Formatter) -> fmt::Result { 3518 fmt.write_str(SET_LOGGER_ERROR) 3519 } 3520} 3521 3522< span class ="comment "> // The Error trait is not available in libcore 3523</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 3524</ span >< span class ="kw "> impl</ span > error::Error< span class ="kw "> for</ span > SetLoggerError {} 3525 3526< span class ="doccomment "> /// The type returned by [`from_str`] when the string doesn't match any of the log levels. 3527/// 3528/// [`from_str`]: https://doc.rust-lang.org/std/str/trait.FromStr.html#tymethod.from_str 3529</ span >< span class ="attribute "> #[allow(missing_copy_implementations)] 3530#[derive(Debug, PartialEq)] 3531</ span >< span class ="kw "> pub struct</ span > ParseLevelError(()); 3532 3533< span class ="kw "> impl</ span > fmt::Display< span class ="kw "> for</ span > ParseLevelError { 3534< span class ="kw "> fn</ span > fmt(< span class ="kw-2 "> &</ span >< span class ="self "> self</ span > , fmt:< span class ="kw-2 "> &mut</ span > fmt::Formatter) -> fmt::Result { 3535 fmt.write_str(LEVEL_PARSE_ERROR) 3536 } 3537} 3538 3539< span class ="comment "> // The Error trait is not available in libcore 3540</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 3541</ span >< span class ="kw "> impl</ span > error::Error< span class ="kw "> for</ span > ParseLevelError {} 3542 3543< span class ="doccomment "> /// Returns a reference to the logger. 3544/// 3545/// If a logger has not been set, a no-op implementation is returned. 3546</ span >< span class ="kw "> pub fn</ span > logger() ->< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span >< span class ="kw "> dyn</ span > Log { 3547< span class ="kw "> if</ span > STATE.load(Ordering::SeqCst) != INITIALIZED { 3548< span class ="kw "> static</ span > NOP: NopLogger = NopLogger; 3549< span class ="kw-2 "> &</ span > NOP 3550 }< span class ="kw "> else</ span > { 3551< span class ="kw "> unsafe</ span > { LOGGER } 3552 } 3553} 3554 3555< span class ="comment "> // WARNING: this is not part of the crate's public API and is subject to change at any time 3556</ span >< span class ="attribute "> #[doc(hidden)] 3557#[cfg(not(feature =< span class ="string "> "kv_unstable"</ span > ))] 3558</ span >< span class ="kw "> pub fn</ span > __private_api_log( 3559 args: fmt::Arguments, 3560 level: Level, 3561< span class ="kw-2 "> &</ span > (target, module_path, file, line):< span class ="kw-2 "> &</ span > (< span class ="kw-2 "> &</ span > str,< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str,< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str, u32), 3562 kvs:< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span > [(< span class ="kw-2 "> &</ span > str,< span class ="kw-2 "> &</ span > str)]>, 3563) { 3564< span class ="kw "> if</ span > kvs.is_some() { 3565< span class ="macro "> panic!</ span > ( 3566< span class ="string "> "key-value support is experimental and must be enabled using the `kv_unstable` feature" 3567</ span > ) 3568 } 3569 3570 logger().log( 3571< span class ="kw-2 "> &</ span > Record::builder() 3572 .args(args) 3573 .level(level) 3574 .target(target) 3575 .module_path_static(< span class ="prelude-val "> Some</ span > (module_path)) 3576 .file_static(< span class ="prelude-val "> Some</ span > (file)) 3577 .line(< span class ="prelude-val "> Some</ span > (line)) 3578 .build(), 3579 ); 3580} 3581 3582< span class ="comment "> // WARNING: this is not part of the crate's public API and is subject to change at any time 3583</ span >< span class ="attribute "> #[doc(hidden)] 3584#[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 3585</ span >< span class ="kw "> pub fn</ span > __private_api_log( 3586 args: fmt::Arguments, 3587 level: Level, 3588< span class ="kw-2 "> &</ span > (target, module_path, file, line):< span class ="kw-2 "> &</ span > (< span class ="kw-2 "> &</ span > str,< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str,< span class ="kw-2 "> &</ span >< span class ="lifetime "> 'static</ span > str, u32), 3589 kvs:< span class ="prelude-ty "> Option</ span > << span class ="kw-2 "> &</ span > [(< span class ="kw-2 "> &</ span > str,< span class ="kw-2 "> &</ span >< span class ="kw "> dyn</ span > kv::ToValue)]>, 3590) { 3591 logger().log( 3592< span class ="kw-2 "> &</ span > Record::builder() 3593 .args(args) 3594 .level(level) 3595 .target(target) 3596 .module_path_static(< span class ="prelude-val "> Some</ span > (module_path)) 3597 .file_static(< span class ="prelude-val "> Some</ span > (file)) 3598 .line(< span class ="prelude-val "> Some</ span > (line)) 3599 .key_values(< span class ="kw-2 "> &</ span > kvs) 3600 .build(), 3601 ); 3602} 3603 3604< span class ="comment "> // WARNING: this is not part of the crate's public API and is subject to change at any time 3605</ span >< span class ="attribute "> #[doc(hidden)] 3606</ span >< span class ="kw "> pub fn</ span > __private_api_enabled(level: Level, target:< span class ="kw-2 "> &</ span > str) -> bool { 3607 logger().enabled(< span class ="kw-2 "> &</ span > Metadata::builder().level(level).target(target).build()) 3608} 3609 3610< span class ="comment "> // WARNING: this is not part of the crate's public API and is subject to change at any time 3611</ span >< span class ="attribute "> #[doc(hidden)] 3612</ span >< span class ="kw "> pub mod</ span > __private_api { 3613< span class ="kw "> pub use</ span > std::option::Option; 3614} 3615 3616< span class ="doccomment "> /// The statically resolved maximum log level. 3617/// 3618/// See the crate level documentation for information on how to configure this. 3619/// 3620/// This value is checked by the log macros, but not by the `Log`ger returned by 3621/// the [`logger`] function. Code that manually calls functions on that value 3622/// should compare the level against this value. 3623/// 3624/// [`logger`]: fn.logger.html 3625</ span >< span class ="kw "> pub const</ span > STATIC_MAX_LEVEL: LevelFilter = MAX_LEVEL_INNER; 3626 3627< span class ="macro "> cfg_if!</ span > { 3628< span class ="kw "> if</ span >< span class ="attribute "> #[cfg(all(not(debug_assertions), feature =< span class ="string "> "release_max_level_off"</ span > ))]</ span > { 3629< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Off; 3630 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(all(not(debug_assertions), feature =< span class ="string "> "release_max_level_error"</ span > ))]</ span > { 3631< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Error; 3632 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(all(not(debug_assertions), feature =< span class ="string "> "release_max_level_warn"</ span > ))]</ span > { 3633< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Warn; 3634 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(all(not(debug_assertions), feature =< span class ="string "> "release_max_level_info"</ span > ))]</ span > { 3635< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Info; 3636 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(all(not(debug_assertions), feature =< span class ="string "> "release_max_level_debug"</ span > ))]</ span > { 3637< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Debug; 3638 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(all(not(debug_assertions), feature =< span class ="string "> "release_max_level_trace"</ span > ))]</ span > { 3639< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Trace; 3640 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "max_level_off"</ span > )]</ span > { 3641< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Off; 3642 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "max_level_error"</ span > )]</ span > { 3643< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Error; 3644 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "max_level_warn"</ span > )]</ span > { 3645< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Warn; 3646 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "max_level_info"</ span > )]</ span > { 3647< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Info; 3648 }< span class ="kw "> else if</ span >< span class ="attribute "> #[cfg(feature =< span class ="string "> "max_level_debug"</ span > )]</ span > { 3649< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Debug; 3650 }< span class ="kw "> else</ span > { 3651< span class ="kw "> const</ span > MAX_LEVEL_INNER: LevelFilter = LevelFilter::Trace; 3652 } 3653} 3654 3655< span class ="attribute "> #[cfg(test)] 3656</ span >< span class ="kw "> mod</ span > tests { 3657< span class ="kw "> extern crate</ span > std; 3658< span class ="kw "> use super</ span > ::{Level, LevelFilter, ParseLevelError}; 3659< span class ="kw "> use</ span > tests::std::string::ToString; 3660 3661< span class ="attribute "> #[test] 3662</ span >< span class ="kw "> fn</ span > test_levelfilter_from_str() { 3663< span class ="kw "> let</ span > tests = [ 3664 (< span class ="string "> "off"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Off)), 3665 (< span class ="string "> "error"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Error)), 3666 (< span class ="string "> "warn"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Warn)), 3667 (< span class ="string "> "info"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Info)), 3668 (< span class ="string "> "debug"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Debug)), 3669 (< span class ="string "> "trace"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Trace)), 3670 (< span class ="string "> "OFF"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Off)), 3671 (< span class ="string "> "ERROR"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Error)), 3672 (< span class ="string "> "WARN"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Warn)), 3673 (< span class ="string "> "INFO"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Info)), 3674 (< span class ="string "> "DEBUG"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Debug)), 3675 (< span class ="string "> "TRACE"</ span > ,< span class ="prelude-val "> Ok</ span > (LevelFilter::Trace)), 3676 (< span class ="string "> "asdf"</ span > ,< span class ="prelude-val "> Err</ span > (ParseLevelError(()))), 3677 ]; 3678< span class ="kw "> for</ span >< span class ="kw-2 "> &</ span > (s,< span class ="kw-2 "> ref</ span > expected)< span class ="kw "> in</ span >< span class ="kw-2 "> &</ span > tests { 3679< span class ="macro "> assert_eq!</ span > (expected,< span class ="kw-2 "> &</ span > s.parse()); 3680 } 3681 } 3682 3683< span class ="attribute "> #[test] 3684</ span >< span class ="kw "> fn</ span > test_level_from_str() { 3685< span class ="kw "> let</ span > tests = [ 3686 (< span class ="string "> "OFF"</ span > ,< span class ="prelude-val "> Err</ span > (ParseLevelError(()))), 3687 (< span class ="string "> "error"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Error)), 3688 (< span class ="string "> "warn"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Warn)), 3689 (< span class ="string "> "info"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Info)), 3690 (< span class ="string "> "debug"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Debug)), 3691 (< span class ="string "> "trace"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Trace)), 3692 (< span class ="string "> "ERROR"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Error)), 3693 (< span class ="string "> "WARN"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Warn)), 3694 (< span class ="string "> "INFO"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Info)), 3695 (< span class ="string "> "DEBUG"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Debug)), 3696 (< span class ="string "> "TRACE"</ span > ,< span class ="prelude-val "> Ok</ span > (Level::Trace)), 3697 (< span class ="string "> "asdf"</ span > ,< span class ="prelude-val "> Err</ span > (ParseLevelError(()))), 3698 ]; 3699< span class ="kw "> for</ span >< span class ="kw-2 "> &</ span > (s,< span class ="kw-2 "> ref</ span > expected)< span class ="kw "> in</ span >< span class ="kw-2 "> &</ span > tests { 3700< span class ="macro "> assert_eq!</ span > (expected,< span class ="kw-2 "> &</ span > s.parse()); 3701 } 3702 } 3703 3704< span class ="attribute "> #[test] 3705</ span >< span class ="kw "> fn</ span > test_level_as_str() { 3706< span class ="kw "> let</ span > tests =< span class ="kw-2 "> &</ span > [ 3707 (Level::Error,< span class ="string "> "ERROR"</ span > ), 3708 (Level::Warn,< span class ="string "> "WARN"</ span > ), 3709 (Level::Info,< span class ="string "> "INFO"</ span > ), 3710 (Level::Debug,< span class ="string "> "DEBUG"</ span > ), 3711 (Level::Trace,< span class ="string "> "TRACE"</ span > ), 3712 ]; 3713< span class ="kw "> for</ span > (input, expected)< span class ="kw "> in</ span > tests { 3714< span class ="macro "> assert_eq!</ span > (< span class ="kw-2 "> *</ span > expected, input.as_str()); 3715 } 3716 } 3717 3718< span class ="attribute "> #[test] 3719</ span >< span class ="kw "> fn</ span > test_level_show() { 3720< span class ="macro "> assert_eq!</ span > (< span class ="string "> "INFO"</ span > , Level::Info.to_string()); 3721< span class ="macro "> assert_eq!</ span > (< span class ="string "> "ERROR"</ span > , Level::Error.to_string()); 3722 } 3723 3724< span class ="attribute "> #[test] 3725</ span >< span class ="kw "> fn</ span > test_levelfilter_show() { 3726< span class ="macro "> assert_eq!</ span > (< span class ="string "> "OFF"</ span > , LevelFilter::Off.to_string()); 3727< span class ="macro "> assert_eq!</ span > (< span class ="string "> "ERROR"</ span > , LevelFilter::Error.to_string()); 3728 } 3729 3730< span class ="attribute "> #[test] 3731</ span >< span class ="kw "> fn</ span > test_cross_cmp() { 3732< span class ="macro "> assert!</ span > (Level::Debug > LevelFilter::Error); 3733< span class ="macro "> assert!</ span > (LevelFilter::Warn < Level::Trace); 3734< span class ="macro "> assert!</ span > (LevelFilter::Off < Level::Error); 3735 } 3736 3737< span class ="attribute "> #[test] 3738</ span >< span class ="kw "> fn</ span > test_cross_eq() { 3739< span class ="macro "> assert!</ span > (Level::Error == LevelFilter::Error); 3740< span class ="macro "> assert!</ span > (LevelFilter::Off != Level::Error); 3741< span class ="macro "> assert!</ span > (Level::Trace == LevelFilter::Trace); 3742 } 3743 3744< span class ="attribute "> #[test] 3745</ span >< span class ="kw "> fn</ span > test_to_level() { 3746< span class ="macro "> assert_eq!</ span > (< span class ="prelude-val "> Some</ span > (Level::Error), LevelFilter::Error.to_level()); 3747< span class ="macro "> assert_eq!</ span > (< span class ="prelude-val "> None</ span > , LevelFilter::Off.to_level()); 3748< span class ="macro "> assert_eq!</ span > (< span class ="prelude-val "> Some</ span > (Level::Debug), LevelFilter::Debug.to_level()); 3749 } 3750 3751< span class ="attribute "> #[test] 3752</ span >< span class ="kw "> fn</ span > test_to_level_filter() { 3753< span class ="macro "> assert_eq!</ span > (LevelFilter::Error, Level::Error.to_level_filter()); 3754< span class ="macro "> assert_eq!</ span > (LevelFilter::Trace, Level::Trace.to_level_filter()); 3755 } 3756 3757< span class ="attribute "> #[test] 3758</ span >< span class ="kw "> fn</ span > test_level_filter_as_str() { 3759< span class ="kw "> let</ span > tests =< span class ="kw-2 "> &</ span > [ 3760 (LevelFilter::Off,< span class ="string "> "OFF"</ span > ), 3761 (LevelFilter::Error,< span class ="string "> "ERROR"</ span > ), 3762 (LevelFilter::Warn,< span class ="string "> "WARN"</ span > ), 3763 (LevelFilter::Info,< span class ="string "> "INFO"</ span > ), 3764 (LevelFilter::Debug,< span class ="string "> "DEBUG"</ span > ), 3765 (LevelFilter::Trace,< span class ="string "> "TRACE"</ span > ), 3766 ]; 3767< span class ="kw "> for</ span > (input, expected)< span class ="kw "> in</ span > tests { 3768< span class ="macro "> assert_eq!</ span > (< span class ="kw-2 "> *</ span > expected, input.as_str()); 3769 } 3770 } 3771 3772< span class ="attribute "> #[test] 3773 #[cfg(feature =< span class ="string "> "std"</ span > )] 3774</ span >< span class ="kw "> fn</ span > test_error_trait() { 3775< span class ="kw "> use</ span >< span class ="kw "> super</ span > ::SetLoggerError; 3776< span class ="kw "> let</ span > e = SetLoggerError(()); 3777< span class ="macro "> assert_eq!</ span > ( 3778< span class ="kw-2 "> &</ span > e.to_string(), 3779< span class ="string "> "attempted to set a logger after the logging system \ 3780 was already initialized" 3781</ span > ); 3782 } 3783 3784< span class ="attribute "> #[test] 3785</ span >< span class ="kw "> fn</ span > test_metadata_builder() { 3786< span class ="kw "> use</ span >< span class ="kw "> super</ span > ::MetadataBuilder; 3787< span class ="kw "> let</ span > target =< span class ="string "> "myApp"</ span > ; 3788< span class ="kw "> let</ span > metadata_test = MetadataBuilder::new() 3789 .level(Level::Debug) 3790 .target(target) 3791 .build(); 3792< span class ="macro "> assert_eq!</ span > (metadata_test.level(), Level::Debug); 3793< span class ="macro "> assert_eq!</ span > (metadata_test.target(),< span class ="string "> "myApp"</ span > ); 3794 } 3795 3796< span class ="attribute "> #[test] 3797</ span >< span class ="kw "> fn</ span > test_metadata_convenience_builder() { 3798< span class ="kw "> use</ span >< span class ="kw "> super</ span > ::Metadata; 3799< span class ="kw "> let</ span > target =< span class ="string "> "myApp"</ span > ; 3800< span class ="kw "> let</ span > metadata_test = Metadata::builder() 3801 .level(Level::Debug) 3802 .target(target) 3803 .build(); 3804< span class ="macro "> assert_eq!</ span > (metadata_test.level(), Level::Debug); 3805< span class ="macro "> assert_eq!</ span > (metadata_test.target(),< span class ="string "> "myApp"</ span > ); 3806 } 3807 3808< span class ="attribute "> #[test] 3809</ span >< span class ="kw "> fn</ span > test_record_builder() { 3810< span class ="kw "> use super</ span > ::{MetadataBuilder, RecordBuilder}; 3811< span class ="kw "> let</ span > target =< span class ="string "> "myApp"</ span > ; 3812< span class ="kw "> let</ span > metadata = MetadataBuilder::new().target(target).build(); 3813< span class ="kw "> let</ span > fmt_args =< span class ="macro "> format_args!</ span > (< span class ="string "> "hello"</ span > ); 3814< span class ="kw "> let</ span > record_test = RecordBuilder::new() 3815 .args(fmt_args) 3816 .metadata(metadata) 3817 .module_path(< span class ="prelude-val "> Some</ span > (< span class ="string "> "foo"</ span > )) 3818 .file(< span class ="prelude-val "> Some</ span > (< span class ="string "> "bar"</ span > )) 3819 .line(< span class ="prelude-val "> Some</ span > (< span class ="number "> 30</ span > )) 3820 .build(); 3821< span class ="macro "> assert_eq!</ span > (record_test.metadata().target(),< span class ="string "> "myApp"</ span > ); 3822< span class ="macro "> assert_eq!</ span > (record_test.module_path(),< span class ="prelude-val "> Some</ span > (< span class ="string "> "foo"</ span > )); 3823< span class ="macro "> assert_eq!</ span > (record_test.file(),< span class ="prelude-val "> Some</ span > (< span class ="string "> "bar"</ span > )); 3824< span class ="macro "> assert_eq!</ span > (record_test.line(),< span class ="prelude-val "> Some</ span > (< span class ="number "> 30</ span > )); 3825 } 3826 3827< span class ="attribute "> #[test] 3828</ span >< span class ="kw "> fn</ span > test_record_convenience_builder() { 3829< span class ="kw "> use super</ span > ::{Metadata, Record}; 3830< span class ="kw "> let</ span > target =< span class ="string "> "myApp"</ span > ; 3831< span class ="kw "> let</ span > metadata = Metadata::builder().target(target).build(); 3832< span class ="kw "> let</ span > fmt_args =< span class ="macro "> format_args!</ span > (< span class ="string "> "hello"</ span > ); 3833< span class ="kw "> let</ span > record_test = Record::builder() 3834 .args(fmt_args) 3835 .metadata(metadata) 3836 .module_path(< span class ="prelude-val "> Some</ span > (< span class ="string "> "foo"</ span > )) 3837 .file(< span class ="prelude-val "> Some</ span > (< span class ="string "> "bar"</ span > )) 3838 .line(< span class ="prelude-val "> Some</ span > (< span class ="number "> 30</ span > )) 3839 .build(); 3840< span class ="macro "> assert_eq!</ span > (record_test.target(),< span class ="string "> "myApp"</ span > ); 3841< span class ="macro "> assert_eq!</ span > (record_test.module_path(),< span class ="prelude-val "> Some</ span > (< span class ="string "> "foo"</ span > )); 3842< span class ="macro "> assert_eq!</ span > (record_test.file(),< span class ="prelude-val "> Some</ span > (< span class ="string "> "bar"</ span > )); 3843< span class ="macro "> assert_eq!</ span > (record_test.line(),< span class ="prelude-val "> Some</ span > (< span class ="number "> 30</ span > )); 3844 } 3845 3846< span class ="attribute "> #[test] 3847</ span >< span class ="kw "> fn</ span > test_record_complete_builder() { 3848< span class ="kw "> use super</ span > ::{Level, Record}; 3849< span class ="kw "> let</ span > target =< span class ="string "> "myApp"</ span > ; 3850< span class ="kw "> let</ span > record_test = Record::builder() 3851 .module_path(< span class ="prelude-val "> Some</ span > (< span class ="string "> "foo"</ span > )) 3852 .file(< span class ="prelude-val "> Some</ span > (< span class ="string "> "bar"</ span > )) 3853 .line(< span class ="prelude-val "> Some</ span > (< span class ="number "> 30</ span > )) 3854 .target(target) 3855 .level(Level::Error) 3856 .build(); 3857< span class ="macro "> assert_eq!</ span > (record_test.target(),< span class ="string "> "myApp"</ span > ); 3858< span class ="macro "> assert_eq!</ span > (record_test.level(), Level::Error); 3859< span class ="macro "> assert_eq!</ span > (record_test.module_path(),< span class ="prelude-val "> Some</ span > (< span class ="string "> "foo"</ span > )); 3860< span class ="macro "> assert_eq!</ span > (record_test.file(),< span class ="prelude-val "> Some</ span > (< span class ="string "> "bar"</ span > )); 3861< span class ="macro "> assert_eq!</ span > (record_test.line(),< span class ="prelude-val "> Some</ span > (< span class ="number "> 30</ span > )); 3862 } 3863 3864< span class ="attribute "> #[test] 3865 #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 3866</ span >< span class ="kw "> fn</ span > test_record_key_values_builder() { 3867< span class ="kw "> use</ span >< span class ="kw "> super</ span > ::Record; 3868< span class ="kw "> use</ span > kv::{< span class ="self "> self</ span > , Visitor}; 3869 3870< span class ="kw "> struct</ span > TestVisitor { 3871 seen_pairs: usize, 3872 } 3873 3874< span class ="kw "> impl</ span > << span class ="lifetime "> 'kvs</ span > > Visitor<< span class ="lifetime "> 'kvs</ span > >< span class ="kw "> for</ span > TestVisitor { 3875< span class ="kw "> fn</ span > visit_pair( 3876< span class ="kw-2 "> &mut</ span >< span class ="self "> self</ span > , 3877< span class ="kw "> _</ span > : kv::Key<< span class ="lifetime "> 'kvs</ span > >, 3878< span class ="kw "> _</ span > : kv::Value<< span class ="lifetime "> 'kvs</ span > >, 3879 ) ->< span class ="prelude-ty "> Result</ span > <(), kv::Error> { 3880< span class ="self "> self</ span > .seen_pairs +=< span class ="number "> 1</ span > ; 3881< span class ="prelude-val "> Ok</ span > (()) 3882 } 3883 } 3884 3885< span class ="kw "> let</ span > kvs:< span class ="kw-2 "> &</ span > [(< span class ="kw-2 "> &</ span > str, i32)] =< span class ="kw-2 "> &</ span > [(< span class ="string "> "a"</ span > ,< span class ="number "> 1</ span > ), (< span class ="string "> "b"</ span > ,< span class ="number "> 2</ span > )]; 3886< span class ="kw "> let</ span > record_test = Record::builder().key_values(< span class ="kw-2 "> &</ span > kvs).build(); 3887 3888< span class ="kw "> let</ span >< span class ="kw-2 "> mut</ span > visitor = TestVisitor { seen_pairs:< span class ="number "> 0</ span > }; 3889 3890 record_test.key_values().visit(< span class ="kw-2 "> &mut</ span > visitor).unwrap(); 3891 3892< span class ="macro "> assert_eq!</ span > (< span class ="number "> 2</ span > , visitor.seen_pairs); 3893 } 3894 3895< span class ="attribute "> #[test] 3896 #[cfg(feature =< span class ="string "> "kv_unstable"</ span > )] 3897</ span >< span class ="kw "> fn</ span > test_record_key_values_get_coerce() { 3898< span class ="kw "> use</ span >< span class ="kw "> super</ span > ::Record; 3899 3900< span class ="kw "> let</ span > kvs:< span class ="kw-2 "> &</ span > [(< span class ="kw-2 "> &</ span > str,< span class ="kw-2 "> &</ span > str)] =< span class ="kw-2 "> &</ span > [(< span class ="string "> "a"</ span > ,< span class ="string "> "1"</ span > ), (< span class ="string "> "b"</ span > ,< span class ="string "> "2"</ span > )]; 3901< span class ="kw "> let</ span > record = Record::builder().key_values(< span class ="kw-2 "> &</ span > kvs).build(); 3902 3903< span class ="macro "> assert_eq!</ span > ( 3904< span class ="string "> "2"</ span > , 3905 record 3906 .key_values() 3907 .get(< span class ="string "> "b"</ span > .into()) 3908 .expect(< span class ="string "> "missing key"</ span > ) 3909 .to_borrowed_str() 3910 .expect(< span class ="string "> "invalid value"</ span > ) 3911 ); 3912 } 3913 3914< span class ="comment "> // Test that the `impl Log for Foo` blocks work 3915 // This test mostly operates on a type level, so failures will be compile errors 3916</ span >< span class ="attribute "> #[test] 3917</ span >< span class ="kw "> fn</ span > test_foreign_impl() { 3918< span class ="kw "> use</ span >< span class ="kw "> super</ span > ::Log; 3919< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 3920</ span >< span class ="kw "> use</ span > std::sync::Arc; 3921 3922< span class ="kw "> fn</ span > assert_is_log<T: Log +< span class ="question-mark "> ?</ span > Sized>() {} 3923 3924 assert_is_log::<< span class ="kw-2 "> &</ span >< span class ="kw "> dyn</ span > Log>(); 3925 3926< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 3927</ span > assert_is_log::<Box<< span class ="kw "> dyn</ span > Log>>(); 3928 3929< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 3930</ span > assert_is_log::<Arc<< span class ="kw "> dyn</ span > Log>>(); 3931 3932< span class ="comment "> // Assert these statements for all T: Log + ?Sized 3933</ span >< span class ="attribute "> #[allow(unused)] 3934</ span >< span class ="kw "> fn</ span > forall<T: Log +< span class ="question-mark "> ?</ span > Sized>() { 3935< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 3936</ span > assert_is_log::<Box<T>>(); 3937 3938 assert_is_log::<< span class ="kw-2 "> &</ span > T>(); 3939 3940< span class ="attribute "> #[cfg(feature =< span class ="string "> "std"</ span > )] 3941</ span > assert_is_log::<Arc<T>>(); 3942 } 3943 } 3944} 3945</ code ></ pre ></ div > 3946</ section ></ div ></ main >< div id ="rustdoc-vars "data-root-path ="../../ "data-current-crate ="log "data-themes ="ayu,dark,light "data-resource-suffix =""data-rustdoc-version ="1.66.0-nightly (4a1467723 2022-09-23) "></ div ></ body ></ html >