rustc_ast_pretty/pprust/state/
item.rs

1use ast::StaticItem;
2use itertools::{Itertools, Position};
3use rustc_ast as ast;
4use rustc_ast::ModKind;
5use rustc_ast::ptr::P;
6use rustc_span::Ident;
7
8use crate::pp::BoxMarker;
9use crate::pp::Breaks::Inconsistent;
10use crate::pprust::state::fixup::FixupContext;
11use crate::pprust::state::{AnnNode, INDENT_UNIT, PrintState, State};
12
13enum DelegationKind<'a> {
14    Single,
15    List(&'a [(Ident, Option<Ident>)]),
16    Glob,
17}
18
19fn visibility_qualified(vis: &ast::Visibility, s: &str) -> String {
20    format!("{}{}", State::to_string(|s| s.print_visibility(vis)), s)
21}
22
23impl<'a> State<'a> {
24    fn print_foreign_mod(&mut self, nmod: &ast::ForeignMod, attrs: &[ast::Attribute]) {
25        self.print_inner_attributes(attrs);
26        for item in &nmod.items {
27            self.print_foreign_item(item);
28        }
29    }
30
31    pub(crate) fn print_foreign_item(&mut self, item: &ast::ForeignItem) {
32        let ast::Item { id, span, ref attrs, ref kind, ref vis, tokens: _ } = *item;
33        self.ann.pre(self, AnnNode::SubItem(id));
34        self.hardbreak_if_not_bol();
35        self.maybe_print_comment(span.lo());
36        self.print_outer_attributes(attrs);
37        match kind {
38            ast::ForeignItemKind::Fn(func) => {
39                self.print_fn_full(vis, attrs, &*func);
40            }
41            ast::ForeignItemKind::Static(box ast::StaticItem {
42                ident,
43                ty,
44                mutability,
45                expr,
46                safety,
47                define_opaque,
48            }) => self.print_item_const(
49                *ident,
50                Some(*mutability),
51                &ast::Generics::default(),
52                ty,
53                expr.as_deref(),
54                vis,
55                *safety,
56                ast::Defaultness::Final,
57                define_opaque.as_deref(),
58            ),
59            ast::ForeignItemKind::TyAlias(box ast::TyAlias {
60                defaultness,
61                ident,
62                generics,
63                where_clauses,
64                bounds,
65                ty,
66            }) => {
67                self.print_associated_type(
68                    *ident,
69                    generics,
70                    *where_clauses,
71                    bounds,
72                    ty.as_deref(),
73                    vis,
74                    *defaultness,
75                );
76            }
77            ast::ForeignItemKind::MacCall(m) => {
78                self.print_mac(m);
79                if m.args.need_semicolon() {
80                    self.word(";");
81                }
82            }
83        }
84        self.ann.post(self, AnnNode::SubItem(id))
85    }
86
87    fn print_item_const(
88        &mut self,
89        ident: Ident,
90        mutbl: Option<ast::Mutability>,
91        generics: &ast::Generics,
92        ty: &ast::Ty,
93        body: Option<&ast::Expr>,
94        vis: &ast::Visibility,
95        safety: ast::Safety,
96        defaultness: ast::Defaultness,
97        define_opaque: Option<&[(ast::NodeId, ast::Path)]>,
98    ) {
99        self.print_define_opaques(define_opaque);
100        let (cb, ib) = self.head("");
101        self.print_visibility(vis);
102        self.print_safety(safety);
103        self.print_defaultness(defaultness);
104        let leading = match mutbl {
105            None => "const",
106            Some(ast::Mutability::Not) => "static",
107            Some(ast::Mutability::Mut) => "static mut",
108        };
109        self.word_space(leading);
110        self.print_ident(ident);
111        self.print_generic_params(&generics.params);
112        self.word_space(":");
113        self.print_type(ty);
114        if body.is_some() {
115            self.space();
116        }
117        self.end(ib);
118        if let Some(body) = body {
119            self.word_space("=");
120            self.print_expr(body, FixupContext::default());
121        }
122        self.print_where_clause(&generics.where_clause);
123        self.word(";");
124        self.end(cb);
125    }
126
127    fn print_associated_type(
128        &mut self,
129        ident: Ident,
130        generics: &ast::Generics,
131        where_clauses: ast::TyAliasWhereClauses,
132        bounds: &ast::GenericBounds,
133        ty: Option<&ast::Ty>,
134        vis: &ast::Visibility,
135        defaultness: ast::Defaultness,
136    ) {
137        let (before_predicates, after_predicates) =
138            generics.where_clause.predicates.split_at(where_clauses.split);
139        let (cb, ib) = self.head("");
140        self.print_visibility(vis);
141        self.print_defaultness(defaultness);
142        self.word_space("type");
143        self.print_ident(ident);
144        self.print_generic_params(&generics.params);
145        if !bounds.is_empty() {
146            self.word_nbsp(":");
147            self.print_type_bounds(bounds);
148        }
149        self.print_where_clause_parts(where_clauses.before.has_where_token, before_predicates);
150        if let Some(ty) = ty {
151            self.space();
152            self.word_space("=");
153            self.print_type(ty);
154        }
155        self.print_where_clause_parts(where_clauses.after.has_where_token, after_predicates);
156        self.word(";");
157        self.end(ib);
158        self.end(cb);
159    }
160
161    /// Pretty-prints an item.
162    pub(crate) fn print_item(&mut self, item: &ast::Item) {
163        if self.is_sdylib_interface && item.span.is_dummy() {
164            // Do not print prelude for interface files.
165            return;
166        }
167        self.hardbreak_if_not_bol();
168        self.maybe_print_comment(item.span.lo());
169        self.print_outer_attributes(&item.attrs);
170        self.ann.pre(self, AnnNode::Item(item));
171        match &item.kind {
172            ast::ItemKind::ExternCrate(orig_name, ident) => {
173                let (cb, ib) = self.head(visibility_qualified(&item.vis, "extern crate"));
174                if let &Some(orig_name) = orig_name {
175                    self.print_name(orig_name);
176                    self.space();
177                    self.word("as");
178                    self.space();
179                }
180                self.print_ident(*ident);
181                self.word(";");
182                self.end(ib);
183                self.end(cb);
184            }
185            ast::ItemKind::Use(tree) => {
186                self.print_visibility(&item.vis);
187                self.word_nbsp("use");
188                self.print_use_tree(tree);
189                self.word(";");
190            }
191            ast::ItemKind::Static(box StaticItem {
192                ident,
193                ty,
194                safety,
195                mutability: mutbl,
196                expr: body,
197                define_opaque,
198            }) => {
199                self.print_safety(*safety);
200                self.print_item_const(
201                    *ident,
202                    Some(*mutbl),
203                    &ast::Generics::default(),
204                    ty,
205                    body.as_deref(),
206                    &item.vis,
207                    ast::Safety::Default,
208                    ast::Defaultness::Final,
209                    define_opaque.as_deref(),
210                );
211            }
212            ast::ItemKind::Const(box ast::ConstItem {
213                defaultness,
214                ident,
215                generics,
216                ty,
217                expr,
218                define_opaque,
219            }) => {
220                self.print_item_const(
221                    *ident,
222                    None,
223                    generics,
224                    ty,
225                    expr.as_deref(),
226                    &item.vis,
227                    ast::Safety::Default,
228                    *defaultness,
229                    define_opaque.as_deref(),
230                );
231            }
232            ast::ItemKind::Fn(func) => {
233                self.print_fn_full(&item.vis, &item.attrs, &*func);
234            }
235            ast::ItemKind::Mod(safety, ident, mod_kind) => {
236                let (cb, ib) = self.head(Self::to_string(|s| {
237                    s.print_visibility(&item.vis);
238                    s.print_safety(*safety);
239                    s.word("mod");
240                }));
241                self.print_ident(*ident);
242
243                match mod_kind {
244                    ModKind::Loaded(items, ..) => {
245                        self.nbsp();
246                        self.bopen(ib);
247                        self.print_inner_attributes(&item.attrs);
248                        for item in items {
249                            self.print_item(item);
250                        }
251                        let empty = item.attrs.is_empty() && items.is_empty();
252                        self.bclose(item.span, empty, cb);
253                    }
254                    ModKind::Unloaded => {
255                        self.word(";");
256                        self.end(ib);
257                        self.end(cb);
258                    }
259                }
260            }
261            ast::ItemKind::ForeignMod(nmod) => {
262                let (cb, ib) = self.head(Self::to_string(|s| {
263                    s.print_safety(nmod.safety);
264                    s.word("extern");
265                }));
266                if let Some(abi) = nmod.abi {
267                    self.print_token_literal(abi.as_token_lit(), abi.span);
268                    self.nbsp();
269                }
270                self.bopen(ib);
271                self.print_foreign_mod(nmod, &item.attrs);
272                let empty = item.attrs.is_empty() && nmod.items.is_empty();
273                self.bclose(item.span, empty, cb);
274            }
275            ast::ItemKind::GlobalAsm(asm) => {
276                // FIXME: Print `builtin # global_asm` once macro `global_asm` uses `builtin_syntax`.
277                let (cb, ib) = self.head(visibility_qualified(&item.vis, "global_asm!"));
278                self.print_inline_asm(asm);
279                self.word(";");
280                self.end(ib);
281                self.end(cb);
282            }
283            ast::ItemKind::TyAlias(box ast::TyAlias {
284                defaultness,
285                ident,
286                generics,
287                where_clauses,
288                bounds,
289                ty,
290            }) => {
291                self.print_associated_type(
292                    *ident,
293                    generics,
294                    *where_clauses,
295                    bounds,
296                    ty.as_deref(),
297                    &item.vis,
298                    *defaultness,
299                );
300            }
301            ast::ItemKind::Enum(ident, generics, enum_definition) => {
302                self.print_enum_def(enum_definition, generics, *ident, item.span, &item.vis);
303            }
304            ast::ItemKind::Struct(ident, generics, struct_def) => {
305                let (cb, ib) = self.head(visibility_qualified(&item.vis, "struct"));
306                self.print_struct(struct_def, generics, *ident, item.span, true, cb, ib);
307            }
308            ast::ItemKind::Union(ident, generics, struct_def) => {
309                let (cb, ib) = self.head(visibility_qualified(&item.vis, "union"));
310                self.print_struct(struct_def, generics, *ident, item.span, true, cb, ib);
311            }
312            ast::ItemKind::Impl(box ast::Impl {
313                safety,
314                polarity,
315                defaultness,
316                constness,
317                generics,
318                of_trait,
319                self_ty,
320                items,
321            }) => {
322                let (cb, ib) = self.head("");
323                self.print_visibility(&item.vis);
324                self.print_defaultness(*defaultness);
325                self.print_safety(*safety);
326                self.word("impl");
327
328                if generics.params.is_empty() {
329                    self.nbsp();
330                } else {
331                    self.print_generic_params(&generics.params);
332                    self.space();
333                }
334
335                self.print_constness(*constness);
336
337                if let ast::ImplPolarity::Negative(_) = polarity {
338                    self.word("!");
339                }
340
341                if let Some(t) = of_trait {
342                    self.print_trait_ref(t);
343                    self.space();
344                    self.word_space("for");
345                }
346
347                self.print_type(self_ty);
348                self.print_where_clause(&generics.where_clause);
349
350                self.space();
351                self.bopen(ib);
352                self.print_inner_attributes(&item.attrs);
353                for impl_item in items {
354                    self.print_assoc_item(impl_item);
355                }
356                let empty = item.attrs.is_empty() && items.is_empty();
357                self.bclose(item.span, empty, cb);
358            }
359            ast::ItemKind::Trait(box ast::Trait {
360                constness,
361                safety,
362                is_auto,
363                ident,
364                generics,
365                bounds,
366                items,
367            }) => {
368                let (cb, ib) = self.head("");
369                self.print_visibility(&item.vis);
370                self.print_constness(*constness);
371                self.print_safety(*safety);
372                self.print_is_auto(*is_auto);
373                self.word_nbsp("trait");
374                self.print_ident(*ident);
375                self.print_generic_params(&generics.params);
376                if !bounds.is_empty() {
377                    self.word_nbsp(":");
378                    self.print_type_bounds(bounds);
379                }
380                self.print_where_clause(&generics.where_clause);
381                self.word(" ");
382                self.bopen(ib);
383                self.print_inner_attributes(&item.attrs);
384                for trait_item in items {
385                    self.print_assoc_item(trait_item);
386                }
387                let empty = item.attrs.is_empty() && items.is_empty();
388                self.bclose(item.span, empty, cb);
389            }
390            ast::ItemKind::TraitAlias(ident, generics, bounds) => {
391                let (cb, ib) = self.head(visibility_qualified(&item.vis, "trait"));
392                self.print_ident(*ident);
393                self.print_generic_params(&generics.params);
394                self.nbsp();
395                if !bounds.is_empty() {
396                    self.word_nbsp("=");
397                    self.print_type_bounds(bounds);
398                }
399                self.print_where_clause(&generics.where_clause);
400                self.word(";");
401                self.end(ib);
402                self.end(cb);
403            }
404            ast::ItemKind::MacCall(mac) => {
405                self.print_mac(mac);
406                if mac.args.need_semicolon() {
407                    self.word(";");
408                }
409            }
410            ast::ItemKind::MacroDef(ident, macro_def) => {
411                self.print_mac_def(macro_def, &ident, item.span, |state| {
412                    state.print_visibility(&item.vis)
413                });
414            }
415            ast::ItemKind::Delegation(deleg) => self.print_delegation(
416                &item.attrs,
417                &item.vis,
418                &deleg.qself,
419                &deleg.path,
420                DelegationKind::Single,
421                &deleg.body,
422            ),
423            ast::ItemKind::DelegationMac(deleg) => self.print_delegation(
424                &item.attrs,
425                &item.vis,
426                &deleg.qself,
427                &deleg.prefix,
428                deleg.suffixes.as_ref().map_or(DelegationKind::Glob, |s| DelegationKind::List(s)),
429                &deleg.body,
430            ),
431        }
432        self.ann.post(self, AnnNode::Item(item))
433    }
434
435    fn print_enum_def(
436        &mut self,
437        enum_definition: &ast::EnumDef,
438        generics: &ast::Generics,
439        ident: Ident,
440        span: rustc_span::Span,
441        visibility: &ast::Visibility,
442    ) {
443        let (cb, ib) = self.head(visibility_qualified(visibility, "enum"));
444        self.print_ident(ident);
445        self.print_generic_params(&generics.params);
446        self.print_where_clause(&generics.where_clause);
447        self.space();
448        self.bopen(ib);
449        for v in enum_definition.variants.iter() {
450            self.space_if_not_bol();
451            self.maybe_print_comment(v.span.lo());
452            self.print_outer_attributes(&v.attrs);
453            let ib = self.ibox(0);
454            self.print_variant(v);
455            self.word(",");
456            self.end(ib);
457            self.maybe_print_trailing_comment(v.span, None);
458        }
459        let empty = enum_definition.variants.is_empty();
460        self.bclose(span, empty, cb)
461    }
462
463    pub(crate) fn print_visibility(&mut self, vis: &ast::Visibility) {
464        match &vis.kind {
465            ast::VisibilityKind::Public => self.word_nbsp("pub"),
466            ast::VisibilityKind::Restricted { path, shorthand, .. } => {
467                let path = Self::to_string(|s| s.print_path(path, false, 0));
468                if *shorthand && (path == "crate" || path == "self" || path == "super") {
469                    self.word_nbsp(format!("pub({path})"))
470                } else {
471                    self.word_nbsp(format!("pub(in {path})"))
472                }
473            }
474            ast::VisibilityKind::Inherited => {}
475        }
476    }
477
478    fn print_defaultness(&mut self, defaultness: ast::Defaultness) {
479        if let ast::Defaultness::Default(_) = defaultness {
480            self.word_nbsp("default");
481        }
482    }
483
484    fn print_struct(
485        &mut self,
486        struct_def: &ast::VariantData,
487        generics: &ast::Generics,
488        ident: Ident,
489        span: rustc_span::Span,
490        print_finalizer: bool,
491        cb: BoxMarker,
492        ib: BoxMarker,
493    ) {
494        self.print_ident(ident);
495        self.print_generic_params(&generics.params);
496        match &struct_def {
497            ast::VariantData::Tuple(..) | ast::VariantData::Unit(..) => {
498                if let ast::VariantData::Tuple(..) = struct_def {
499                    self.popen();
500                    self.commasep(Inconsistent, struct_def.fields(), |s, field| {
501                        s.maybe_print_comment(field.span.lo());
502                        s.print_outer_attributes(&field.attrs);
503                        s.print_visibility(&field.vis);
504                        s.print_type(&field.ty)
505                    });
506                    self.pclose();
507                }
508                self.print_where_clause(&generics.where_clause);
509                if print_finalizer {
510                    self.word(";");
511                }
512                self.end(ib);
513                self.end(cb);
514            }
515            ast::VariantData::Struct { fields, .. } => {
516                self.print_where_clause(&generics.where_clause);
517                self.nbsp();
518                self.bopen(ib);
519
520                let empty = fields.is_empty();
521                if !empty {
522                    self.hardbreak_if_not_bol();
523
524                    for field in fields {
525                        self.hardbreak_if_not_bol();
526                        self.maybe_print_comment(field.span.lo());
527                        self.print_outer_attributes(&field.attrs);
528                        self.print_visibility(&field.vis);
529                        self.print_ident(field.ident.unwrap());
530                        self.word_nbsp(":");
531                        self.print_type(&field.ty);
532                        self.word(",");
533                    }
534                }
535
536                self.bclose(span, empty, cb);
537            }
538        }
539    }
540
541    pub(crate) fn print_variant(&mut self, v: &ast::Variant) {
542        let (cb, ib) = self.head("");
543        self.print_visibility(&v.vis);
544        let generics = ast::Generics::default();
545        self.print_struct(&v.data, &generics, v.ident, v.span, false, cb, ib);
546        if let Some(d) = &v.disr_expr {
547            self.space();
548            self.word_space("=");
549            self.print_expr(&d.value, FixupContext::default())
550        }
551    }
552
553    pub(crate) fn print_assoc_item(&mut self, item: &ast::AssocItem) {
554        let ast::Item { id, span, ref attrs, ref kind, ref vis, tokens: _ } = *item;
555        self.ann.pre(self, AnnNode::SubItem(id));
556        self.hardbreak_if_not_bol();
557        self.maybe_print_comment(span.lo());
558        self.print_outer_attributes(attrs);
559        match kind {
560            ast::AssocItemKind::Fn(func) => {
561                self.print_fn_full(vis, attrs, &*func);
562            }
563            ast::AssocItemKind::Const(box ast::ConstItem {
564                defaultness,
565                ident,
566                generics,
567                ty,
568                expr,
569                define_opaque,
570            }) => {
571                self.print_item_const(
572                    *ident,
573                    None,
574                    generics,
575                    ty,
576                    expr.as_deref(),
577                    vis,
578                    ast::Safety::Default,
579                    *defaultness,
580                    define_opaque.as_deref(),
581                );
582            }
583            ast::AssocItemKind::Type(box ast::TyAlias {
584                defaultness,
585                ident,
586                generics,
587                where_clauses,
588                bounds,
589                ty,
590            }) => {
591                self.print_associated_type(
592                    *ident,
593                    generics,
594                    *where_clauses,
595                    bounds,
596                    ty.as_deref(),
597                    vis,
598                    *defaultness,
599                );
600            }
601            ast::AssocItemKind::MacCall(m) => {
602                self.print_mac(m);
603                if m.args.need_semicolon() {
604                    self.word(";");
605                }
606            }
607            ast::AssocItemKind::Delegation(deleg) => self.print_delegation(
608                &item.attrs,
609                vis,
610                &deleg.qself,
611                &deleg.path,
612                DelegationKind::Single,
613                &deleg.body,
614            ),
615            ast::AssocItemKind::DelegationMac(deleg) => self.print_delegation(
616                &item.attrs,
617                vis,
618                &deleg.qself,
619                &deleg.prefix,
620                deleg.suffixes.as_ref().map_or(DelegationKind::Glob, |s| DelegationKind::List(s)),
621                &deleg.body,
622            ),
623        }
624        self.ann.post(self, AnnNode::SubItem(id))
625    }
626
627    fn print_delegation(
628        &mut self,
629        attrs: &[ast::Attribute],
630        vis: &ast::Visibility,
631        qself: &Option<P<ast::QSelf>>,
632        path: &ast::Path,
633        kind: DelegationKind<'_>,
634        body: &Option<P<ast::Block>>,
635    ) {
636        let body_cb_ib = body.as_ref().map(|body| (body, self.head("")));
637        self.print_visibility(vis);
638        self.word_nbsp("reuse");
639
640        if let Some(qself) = qself {
641            self.print_qpath(path, qself, false);
642        } else {
643            self.print_path(path, false, 0);
644        }
645        match kind {
646            DelegationKind::Single => {}
647            DelegationKind::List(suffixes) => {
648                self.word("::");
649                self.word("{");
650                for (i, (ident, rename)) in suffixes.iter().enumerate() {
651                    self.print_ident(*ident);
652                    if let Some(rename) = rename {
653                        self.nbsp();
654                        self.word_nbsp("as");
655                        self.print_ident(*rename);
656                    }
657                    if i != suffixes.len() - 1 {
658                        self.word_space(",");
659                    }
660                }
661                self.word("}");
662            }
663            DelegationKind::Glob => {
664                self.word("::");
665                self.word("*");
666            }
667        }
668        if let Some((body, (cb, ib))) = body_cb_ib {
669            self.nbsp();
670            self.print_block_with_attrs(body, attrs, cb, ib);
671        } else {
672            self.word(";");
673        }
674    }
675
676    fn print_fn_full(&mut self, vis: &ast::Visibility, attrs: &[ast::Attribute], func: &ast::Fn) {
677        let ast::Fn { defaultness, ident, generics, sig, contract, body, define_opaque } = func;
678
679        self.print_define_opaques(define_opaque.as_deref());
680
681        let body_cb_ib = body.as_ref().map(|body| (body, self.head("")));
682
683        self.print_visibility(vis);
684        self.print_defaultness(*defaultness);
685        self.print_fn(&sig.decl, sig.header, Some(*ident), generics);
686        if let Some(contract) = &contract {
687            self.nbsp();
688            self.print_contract(contract);
689        }
690        if let Some((body, (cb, ib))) = body_cb_ib {
691            if self.is_sdylib_interface {
692                self.word(";");
693                self.end(ib); // end inner head-block
694                self.end(cb); // end outer head-block
695                return;
696            }
697
698            self.nbsp();
699            self.print_block_with_attrs(body, attrs, cb, ib);
700        } else {
701            self.word(";");
702        }
703    }
704
705    fn print_define_opaques(&mut self, define_opaque: Option<&[(ast::NodeId, ast::Path)]>) {
706        if let Some(define_opaque) = define_opaque {
707            self.word("#[define_opaque(");
708            for (i, (_, path)) in define_opaque.iter().enumerate() {
709                if i != 0 {
710                    self.word_space(",");
711                }
712
713                self.print_path(path, false, 0);
714            }
715            self.word(")]");
716        }
717        self.hardbreak_if_not_bol();
718    }
719
720    fn print_contract(&mut self, contract: &ast::FnContract) {
721        if let Some(pred) = &contract.requires {
722            self.word("rustc_requires");
723            self.popen();
724            self.print_expr(pred, FixupContext::default());
725            self.pclose();
726        }
727        if let Some(pred) = &contract.ensures {
728            self.word("rustc_ensures");
729            self.popen();
730            self.print_expr(pred, FixupContext::default());
731            self.pclose();
732        }
733    }
734
735    pub(crate) fn print_fn(
736        &mut self,
737        decl: &ast::FnDecl,
738        header: ast::FnHeader,
739        ident: Option<Ident>,
740        generics: &ast::Generics,
741    ) {
742        self.print_fn_header_info(header);
743        if let Some(ident) = ident {
744            self.nbsp();
745            self.print_ident(ident);
746        }
747        self.print_generic_params(&generics.params);
748        self.print_fn_params_and_ret(decl, false);
749        self.print_where_clause(&generics.where_clause);
750    }
751
752    pub(crate) fn print_fn_params_and_ret(&mut self, decl: &ast::FnDecl, is_closure: bool) {
753        let (open, close) = if is_closure { ("|", "|") } else { ("(", ")") };
754        self.word(open);
755        self.commasep(Inconsistent, &decl.inputs, |s, param| s.print_param(param, is_closure));
756        self.word(close);
757        self.print_fn_ret_ty(&decl.output)
758    }
759
760    fn print_where_clause(&mut self, where_clause: &ast::WhereClause) {
761        self.print_where_clause_parts(where_clause.has_where_token, &where_clause.predicates);
762    }
763
764    fn print_where_clause_parts(
765        &mut self,
766        has_where_token: bool,
767        predicates: &[ast::WherePredicate],
768    ) {
769        if predicates.is_empty() && !has_where_token {
770            return;
771        }
772
773        self.space();
774        self.word_space("where");
775
776        for (i, predicate) in predicates.iter().enumerate() {
777            if i != 0 {
778                self.word_space(",");
779            }
780
781            self.print_where_predicate(predicate);
782        }
783    }
784
785    pub fn print_where_predicate(&mut self, predicate: &ast::WherePredicate) {
786        let ast::WherePredicate { attrs, kind, id: _, span: _, is_placeholder: _ } = predicate;
787        self.print_outer_attributes(attrs);
788        match kind {
789            ast::WherePredicateKind::BoundPredicate(where_bound_predicate) => {
790                self.print_where_bound_predicate(where_bound_predicate);
791            }
792            ast::WherePredicateKind::RegionPredicate(ast::WhereRegionPredicate {
793                lifetime,
794                bounds,
795                ..
796            }) => {
797                self.print_lifetime(*lifetime);
798                self.word(":");
799                if !bounds.is_empty() {
800                    self.nbsp();
801                    self.print_lifetime_bounds(bounds);
802                }
803            }
804            ast::WherePredicateKind::EqPredicate(ast::WhereEqPredicate {
805                lhs_ty, rhs_ty, ..
806            }) => {
807                self.print_type(lhs_ty);
808                self.space();
809                self.word_space("=");
810                self.print_type(rhs_ty);
811            }
812        }
813    }
814
815    pub(crate) fn print_where_bound_predicate(
816        &mut self,
817        where_bound_predicate: &ast::WhereBoundPredicate,
818    ) {
819        self.print_formal_generic_params(&where_bound_predicate.bound_generic_params);
820        self.print_type(&where_bound_predicate.bounded_ty);
821        self.word(":");
822        if !where_bound_predicate.bounds.is_empty() {
823            self.nbsp();
824            self.print_type_bounds(&where_bound_predicate.bounds);
825        }
826    }
827
828    fn print_use_tree(&mut self, tree: &ast::UseTree) {
829        match &tree.kind {
830            ast::UseTreeKind::Simple(rename) => {
831                self.print_path(&tree.prefix, false, 0);
832                if let &Some(rename) = rename {
833                    self.nbsp();
834                    self.word_nbsp("as");
835                    self.print_ident(rename);
836                }
837            }
838            ast::UseTreeKind::Glob => {
839                if !tree.prefix.segments.is_empty() {
840                    self.print_path(&tree.prefix, false, 0);
841                    self.word("::");
842                }
843                self.word("*");
844            }
845            ast::UseTreeKind::Nested { items, .. } => {
846                if !tree.prefix.segments.is_empty() {
847                    self.print_path(&tree.prefix, false, 0);
848                    self.word("::");
849                }
850                if items.is_empty() {
851                    self.word("{}");
852                } else if let [(item, _)] = items.as_slice() {
853                    self.print_use_tree(item);
854                } else {
855                    let cb = self.cbox(INDENT_UNIT);
856                    self.word("{");
857                    self.zerobreak();
858                    let ib = self.ibox(0);
859                    for (pos, use_tree) in items.iter().with_position() {
860                        let is_last = matches!(pos, Position::Last | Position::Only);
861                        self.print_use_tree(&use_tree.0);
862                        if !is_last {
863                            self.word(",");
864                            if let ast::UseTreeKind::Nested { .. } = use_tree.0.kind {
865                                self.hardbreak();
866                            } else {
867                                self.space();
868                            }
869                        }
870                    }
871                    self.end(ib);
872                    self.trailing_comma();
873                    self.offset(-INDENT_UNIT);
874                    self.word("}");
875                    self.end(cb);
876                }
877            }
878        }
879    }
880}