+/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/macros.rs`. ">< meta name ="keywords "content ="rust, rustlang, rust-lang ">< title > macros.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</ pre >< pre class ="rust ">< code >< span class ="comment "> // Copyright 2014-2015 The Rust Project Developers. See the COPYRIGHT 284// file at the top-level directory of this distribution and at 285// http://rust-lang.org/COPYRIGHT. 286// 287// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or 288// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license 289// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your 290// option. This file may not be copied, modified, or distributed 291// except according to those terms. 292 293</ span >< span class ="doccomment "> /// The standard logging macro. 294/// 295/// This macro will generically log with the specified `Level` and `format!` 296/// based argument list. 297/// 298/// # Examples 299/// 300/// ```edition2018 301/// use log::{log, Level}; 302/// 303/// # fn main() { 304/// let data = (42, "Forty-two"); 305/// let private_data = "private"; 306/// 307/// log!(Level::Error, "Received errors: {}, {}", data.0, data.1); 308/// log!(target: "app_events", Level::Warn, "App warning: {}, {}, {}", 309/// data.0, data.1, private_data); 310/// # } 311/// ``` 312</ span >< span class ="attribute "> #[macro_export(local_inner_macros)] 313</ span >< span class ="macro "> macro_rules!</ span > log { 314< span class ="comment "> // log!(target: "my_target", Level::Info; key1 = 42, key2 = true; "a {} event", "log"); 315</ span > (target:< span class ="macro-nonterminal "> $target</ span > :expr,< span class ="macro-nonterminal "> $lvl</ span > :expr, $(< span class ="macro-nonterminal "> $key</ span > :tt =< span class ="macro-nonterminal "> $value</ span > :expr),+; $(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => ({ 316< span class ="kw "> let</ span > lvl =< span class ="macro-nonterminal "> $lvl</ span > ; 317< span class ="kw "> if</ span > lvl <=< span class ="macro-nonterminal "> $crate::STATIC_MAX_LEVEL</ span > && lvl <=< span class ="macro-nonterminal "> $crate::max_level</ span > () { 318< span class ="macro-nonterminal "> $crate::__private_api_log</ span > ( 319< span class ="macro "> __log_format_args!</ span > ($(< span class ="macro-nonterminal "> $arg</ span > )+), 320 lvl, 321< span class ="kw-2 "> &</ span > (< span class ="macro-nonterminal "> $target</ span > ,< span class ="macro "> __log_module_path!</ span > (),< span class ="macro "> __log_file!</ span > (),< span class ="macro "> __log_line!</ span > ()), 322< span class ="macro-nonterminal "> $crate::__private_api::Option::Some</ span > (< span class ="kw-2 "> &</ span > [$((< span class ="macro "> __log_key!</ span > (< span class ="macro-nonterminal "> $key</ span > ),< span class ="kw-2 "> &</ span >< span class ="macro-nonterminal "> $value</ span > )),+]) 323 ); 324 } 325 }); 326 327< span class ="comment "> // log!(target: "my_target", Level::Info; "a {} event", "log"); 328</ span > (target:< span class ="macro-nonterminal "> $target</ span > :expr,< span class ="macro-nonterminal "> $lvl</ span > :expr, $(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => ({ 329< span class ="kw "> let</ span > lvl =< span class ="macro-nonterminal "> $lvl</ span > ; 330< span class ="kw "> if</ span > lvl <=< span class ="macro-nonterminal "> $crate::STATIC_MAX_LEVEL</ span > && lvl <=< span class ="macro-nonterminal "> $crate::max_level</ span > () { 331< span class ="macro-nonterminal "> $crate::__private_api_log</ span > ( 332< span class ="macro "> __log_format_args!</ span > ($(< span class ="macro-nonterminal "> $arg</ span > )+), 333 lvl, 334< span class ="kw-2 "> &</ span > (< span class ="macro-nonterminal "> $target</ span > ,< span class ="macro "> __log_module_path!</ span > (),< span class ="macro "> __log_file!</ span > (),< span class ="macro "> __log_line!</ span > ()), 335< span class ="macro-nonterminal "> $crate::__private_api::Option::None</ span > , 336 ); 337 } 338 }); 339 340< span class ="comment "> // log!(Level::Info, "a log event") 341</ span > (< span class ="macro-nonterminal "> $lvl</ span > :expr, $(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (target:< span class ="macro "> __log_module_path!</ span > (),< span class ="macro-nonterminal "> $lvl</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)); 342} 343 344< span class ="doccomment "> /// Logs a message at the error level. 345/// 346/// # Examples 347/// 348/// ```edition2018 349/// use log::error; 350/// 351/// # fn main() { 352/// let (err_info, port) = ("No connection", 22); 353/// 354/// error!("Error: {} on port {}", err_info, port); 355/// error!(target: "app_events", "App Error: {}, Port: {}", err_info, 22); 356/// # } 357/// ``` 358</ span >< span class ="attribute "> #[macro_export(local_inner_macros)] 359</ span >< span class ="macro "> macro_rules!</ span > error { 360< span class ="comment "> // error!(target: "my_target", key1 = 42, key2 = true; "a {} event", "log") 361 // error!(target: "my_target", "a {} event", "log") 362</ span > (target:< span class ="macro-nonterminal "> $target</ span > :expr, $(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (target:< span class ="macro-nonterminal "> $target</ span > ,< span class ="macro-nonterminal "> $crate::Level::Error</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)); 363 364< span class ="comment "> // error!("a {} event", "log") 365</ span > ($(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (< span class ="macro-nonterminal "> $crate::Level::Error</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)) 366} 367 368< span class ="doccomment "> /// Logs a message at the warn level. 369/// 370/// # Examples 371/// 372/// ```edition2018 373/// use log::warn; 374/// 375/// # fn main() { 376/// let warn_description = "Invalid Input"; 377/// 378/// warn!("Warning! {}!", warn_description); 379/// warn!(target: "input_events", "App received warning: {}", warn_description); 380/// # } 381/// ``` 382</ span >< span class ="attribute "> #[macro_export(local_inner_macros)] 383</ span >< span class ="macro "> macro_rules!</ span > warn { 384< span class ="comment "> // warn!(target: "my_target", key1 = 42, key2 = true; "a {} event", "log") 385 // warn!(target: "my_target", "a {} event", "log") 386</ span > (target:< span class ="macro-nonterminal "> $target</ span > :expr, $(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (target:< span class ="macro-nonterminal "> $target</ span > ,< span class ="macro-nonterminal "> $crate::Level::Warn</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)); 387 388< span class ="comment "> // warn!("a {} event", "log") 389</ span > ($(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (< span class ="macro-nonterminal "> $crate::Level::Warn</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)) 390} 391 392< span class ="doccomment "> /// Logs a message at the info level. 393/// 394/// # Examples 395/// 396/// ```edition2018 397/// use log::info; 398/// 399/// # fn main() { 400/// # struct Connection { port: u32, speed: f32 } 401/// let conn_info = Connection { port: 40, speed: 3.20 }; 402/// 403/// info!("Connected to port {} at {} Mb/s", conn_info.port, conn_info.speed); 404/// info!(target: "connection_events", "Successfull connection, port: {}, speed: {}", 405/// conn_info.port, conn_info.speed); 406/// # } 407/// ``` 408</ span >< span class ="attribute "> #[macro_export(local_inner_macros)] 409</ span >< span class ="macro "> macro_rules!</ span > info { 410< span class ="comment "> // info!(target: "my_target", key1 = 42, key2 = true; "a {} event", "log") 411 // info!(target: "my_target", "a {} event", "log") 412</ span > (target:< span class ="macro-nonterminal "> $target</ span > :expr, $(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (target:< span class ="macro-nonterminal "> $target</ span > ,< span class ="macro-nonterminal "> $crate::Level::Info</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)); 413 414< span class ="comment "> // info!("a {} event", "log") 415</ span > ($(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (< span class ="macro-nonterminal "> $crate::Level::Info</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)) 416} 417 418< span class ="doccomment "> /// Logs a message at the debug level. 419/// 420/// # Examples 421/// 422/// ```edition2018 423/// use log::debug; 424/// 425/// # fn main() { 426/// # struct Position { x: f32, y: f32 } 427/// let pos = Position { x: 3.234, y: -1.223 }; 428/// 429/// debug!("New position: x: {}, y: {}", pos.x, pos.y); 430/// debug!(target: "app_events", "New position: x: {}, y: {}", pos.x, pos.y); 431/// # } 432/// ``` 433</ span >< span class ="attribute "> #[macro_export(local_inner_macros)] 434</ span >< span class ="macro "> macro_rules!</ span > debug { 435< span class ="comment "> // debug!(target: "my_target", key1 = 42, key2 = true; "a {} event", "log") 436 // debug!(target: "my_target", "a {} event", "log") 437</ span > (target:< span class ="macro-nonterminal "> $target</ span > :expr, $(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (target:< span class ="macro-nonterminal "> $target</ span > ,< span class ="macro-nonterminal "> $crate::Level::Debug</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)); 438 439< span class ="comment "> // debug!("a {} event", "log") 440</ span > ($(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (< span class ="macro-nonterminal "> $crate::Level::Debug</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)) 441} 442 443< span class ="doccomment "> /// Logs a message at the trace level. 444/// 445/// # Examples 446/// 447/// ```edition2018 448/// use log::trace; 449/// 450/// # fn main() { 451/// # struct Position { x: f32, y: f32 } 452/// let pos = Position { x: 3.234, y: -1.223 }; 453/// 454/// trace!("Position is: x: {}, y: {}", pos.x, pos.y); 455/// trace!(target: "app_events", "x is {} and y is {}", 456/// if pos.x >= 0.0 { "positive" } else { "negative" }, 457/// if pos.y >= 0.0 { "positive" } else { "negative" }); 458/// # } 459/// ``` 460</ span >< span class ="attribute "> #[macro_export(local_inner_macros)] 461</ span >< span class ="macro "> macro_rules!</ span > trace { 462< span class ="comment "> // trace!(target: "my_target", key1 = 42, key2 = true; "a {} event", "log") 463 // trace!(target: "my_target", "a {} event", "log") 464</ span > (target:< span class ="macro-nonterminal "> $target</ span > :expr, $(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (target:< span class ="macro-nonterminal "> $target</ span > ,< span class ="macro-nonterminal "> $crate::Level::Trace</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)); 465 466< span class ="comment "> // trace!("a {} event", "log") 467</ span > ($(< span class ="macro-nonterminal "> $arg</ span > :tt)+) => (< span class ="macro "> log!</ span > (< span class ="macro-nonterminal "> $crate::Level::Trace</ span > , $(< span class ="macro-nonterminal "> $arg</ span > )+)) 468} 469 470< span class ="doccomment "> /// Determines if a message logged at the specified level in that module will 471/// be logged. 472/// 473/// This can be used to avoid expensive computation of log message arguments if 474/// the message would be ignored anyway. 475/// 476/// # Examples 477/// 478/// ```edition2018 479/// use log::Level::Debug; 480/// use log::{debug, log_enabled}; 481/// 482/// # fn foo() { 483/// if log_enabled!(Debug) { 484/// let data = expensive_call(); 485/// debug!("expensive debug data: {} {}", data.x, data.y); 486/// } 487/// if log_enabled!(target: "Global", Debug) { 488/// let data = expensive_call(); 489/// debug!(target: "Global", "expensive debug data: {} {}", data.x, data.y); 490/// } 491/// # } 492/// # struct Data { x: u32, y: u32 } 493/// # fn expensive_call() -> Data { Data { x: 0, y: 0 } } 494/// # fn main() {} 495/// ``` 496</ span >< span class ="attribute "> #[macro_export(local_inner_macros)] 497</ span >< span class ="macro "> macro_rules!</ span > log_enabled { 498 (target:< span class ="macro-nonterminal "> $target</ span > :expr,< span class ="macro-nonterminal "> $lvl</ span > :expr) => {{ 499< span class ="kw "> let</ span > lvl =< span class ="macro-nonterminal "> $lvl</ span > ; 500 lvl <=< span class ="macro-nonterminal "> $crate::STATIC_MAX_LEVEL 501</ span > && lvl <=< span class ="macro-nonterminal "> $crate::max_level</ span > () 502 &&< span class ="macro-nonterminal "> $crate::__private_api_enabled</ span > (lvl,< span class ="macro-nonterminal "> $target</ span > ) 503 }}; 504 (< span class ="macro-nonterminal "> $lvl</ span > :expr) => { 505< span class ="macro "> log_enabled!</ span > (target:< span class ="macro "> __log_module_path!</ span > (),< span class ="macro-nonterminal "> $lvl</ span > ) 506 }; 507} 508 509< span class ="comment "> // The log macro above cannot invoke format_args directly because it uses 510// local_inner_macros. A format_args invocation there would resolve to 511// $crate::format_args which does not exist. Instead invoke format_args here 512// outside of local_inner_macros so that it resolves (probably) to 513// core::format_args or std::format_args. Same for the several macros that 514// follow. 515// 516// This is a workaround until we drop support for pre-1.30 compilers. At that 517// point we can remove use of local_inner_macros, use $crate:: when invoking 518// local macros, and invoke format_args directly. 519</ span >< span class ="attribute "> #[doc(hidden)] 520#[macro_export] 521</ span >< span class ="macro "> macro_rules!</ span > __log_format_args { 522 ($(< span class ="macro-nonterminal "> $args</ span > :tt)< span class ="kw-2 "> *</ span > ) => { 523< span class ="macro "> format_args!</ span > ($(< span class ="macro-nonterminal "> $args</ span > )< span class ="kw-2 "> *</ span > ) 524 }; 525} 526 527< span class ="attribute "> #[doc(hidden)] 528#[macro_export] 529</ span >< span class ="macro "> macro_rules!</ span > __log_module_path { 530 () => { 531< span class ="macro "> module_path!</ span > () 532 }; 533} 534 535< span class ="attribute "> #[doc(hidden)] 536#[macro_export] 537</ span >< span class ="macro "> macro_rules!</ span > __log_file { 538 () => { 539< span class ="macro "> file!</ span > () 540 }; 541} 542 543< span class ="attribute "> #[doc(hidden)] 544#[macro_export] 545</ span >< span class ="macro "> macro_rules!</ span > __log_line { 546 () => { 547< span class ="macro "> line!</ span > () 548 }; 549} 550 551< span class ="attribute "> #[doc(hidden)] 552#[macro_export] 553</ span >< span class ="macro "> macro_rules!</ span > __log_key { 554< span class ="comment "> // key1 = 42 555</ span > ($(< span class ="macro-nonterminal "> $args</ span > :ident)< span class ="kw-2 "> *</ span > ) => { 556< span class ="macro "> stringify!</ span > ($(< span class ="macro-nonterminal "> $args</ span > )< span class ="kw-2 "> *</ span > ) 557 }; 558< span class ="comment "> // "key1" = 42 559</ span > ($(< span class ="macro-nonterminal "> $args</ span > :expr)< span class ="kw-2 "> *</ span > ) => { 560 $(< span class ="macro-nonterminal "> $args</ span > )* 561 }; 562} 563</ code ></ pre ></ div > 564</ 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 >