/usr/bin/diffoscope --timeout 7200 --html /srv/reproducible-results/rbuild-debian/r-b-build.GvbwkBCx/rustc_1.85.0+dfsg2-3.diffoscope.html --text /srv/reproducible-results/rbuild-debian/r-b-build.GvbwkBCx/rustc_1.85.0+dfsg2-3.diffoscope.txt --json /srv/reproducible-results/rbuild-debian/r-b-build.GvbwkBCx/rustc_1.85.0+dfsg2-3.diffoscope.json --profile=- /srv/reproducible-results/rbuild-debian/r-b-build.GvbwkBCx/b1/rustc_1.85.0+dfsg2-3_i386.changes /srv/reproducible-results/rbuild-debian/r-b-build.GvbwkBCx/b2/rustc_1.85.0+dfsg2-3

⊟

114 MB

/srv/reproducible-results/rbuild-debian/r-b-build.GvbwkBCx/b1/rustc_1.85.0+dfsg2-3_i386.changes vs.

/srv/reproducible-results/rbuild-debian/r-b-build.GvbwkBCx/b2/rustc_1.85.0+dfsg2-3_i386.changes ¶

⊟

2.15 KB

Files ¶

⊟

18.7 MB

cargo_1.85.0+dfsg2-3_i386.deb ¶

⊟

452 B

file list ¶

⊟

98.0 B

control.tar.xz ¶

⊟

70.0 B

control.tar ¶

⊟

48.0 B

./md5sums ¶

⊟

30.0 B

./md5sums ¶

Files differ

⊟

18.7 MB

data.tar.xz ¶

⊟

18.7 MB

data.tar ¶

⊟

18.7 MB

./usr/bin/cargo ¶

File has been modified after NT_GNU_BUILD_ID has been applied.

⊟

615 B

readelf --wide --notes {} ¶

⊟

22.1 KB

strings --all --bytes=8 {} ¶

Max HTML report size reached

⊟

7.31 MB

objdump --line-numbers --disassemble --demangle --reloc --no-show-raw-insn --section=.text {} ¶

Max HTML report size reached

⊟

8.9 MB

readelf --wide --decompress --hex-dump=.rodata {} ¶

Max HTML report size reached

⊟

2.43 MB

readelf --wide --decompress --hex-dump=.data.rel.ro {} ¶

Max HTML report size reached

⊟

6.71 KB

readelf --wide --decompress --hex-dump=.got {} ¶

Max HTML report size reached

⊟

866 B

readelf --wide --decompress --hex-dump=.gnu_debuglink {} ¶

error from `readelf --wide --decompress --hex-dump=.gnu_debuglink {}`: readelf: Error: Unable to find program interpreter name readelf: Error: no .dynamic section in the dynamic segment

⊟

41.6 MB

rust-doc_1.85.0+dfsg2-3_all.deb ¶

⊟

452 B

file list ¶

⊟

664 B

control.tar.xz ¶

⊟

636 B

control.tar ¶

⊟

566 B

./control ¶

⊟

48.0 B

./md5sums ¶

⊟

30.0 B

./md5sums ¶

Files differ

⊟

41.6 MB

data.tar.xz ¶

⊟

41.6 MB

data.tar ¶

⊟

123 KB

file list ¶

⊟

8.64 KB

⊟

8.84 KB

⊟

8.58 KB

⊟

9.38 KB

⊟

9.1 KB

⊟

74.1 KB

⊟

70.8 KB

⊟

107 KB

⊟

77.8 KB

⊟

46.8 KB

⊟

22.2 KB

⊟

8.03 KB

⊟

310 KB

⊟

32.8 KB

⊟

21.5 KB

⊟

12.6 KB

⊟

5.72 KB

⊟

974 KB

Max HTML report size reached

⊟

84.2 KB

⊟

167 KB

⊟

328 KB

⊟

311 KB

⊟

349 KB

⊟

326 KB

⊟

339 KB

⊟

62.2 KB

⊟

68.6 KB

⊟

302 KB

⊟

60.6 KB

⊟

58.2 KB

⊟

57.8 KB

⊟

302 KB

⊟

342 KB

⊟

334 KB

⊟

337 KB

⊟

340 KB

⊟

325 KB

⊟

338 KB

⊟

63.4 KB

⊟

64.9 KB

⊟

331 KB

⊟

317 KB

⊟

69.0 KB

⊟

56.2 KB

⊟

340 KB

⊟

326 KB

⊟

55.7 KB

⊟

299 KB

⊟

58.7 KB

⊟

57.6 KB

⊟

56.2 KB

⊟

312 KB

⊟

301 KB

⊟

312 KB

⊟

336 KB

⊟

337 KB

⊟

53.5 KB

⊟

328 KB

⊟

303 KB

⊟

302 KB

⊟

69.4 KB

⊟

53.5 KB

⊟

55.8 KB

⊟

67.7 KB

⊟

71.1 KB

⊟

289 KB

⊟

346 KB

⊟

339 KB

⊟

324 KB

⊟

178 KB

⊟

73.1 KB

⊟

328 KB

⊟

341 KB

⊟

342 KB

⊟

336 KB

⊟

325 KB

⊟

226 KB

⊟

70.9 KB

⊟

64.8 KB

⊟

68.2 KB

⊟

7.71 KB

⊟

224 KB

⊟

70.2 KB

⊟

64.1 KB

⊟

67.5 KB

⊟

6.92 KB

⊟

60.9 KB

⊟

60.3 KB

⊟

59.1 KB

⊟

5.29 KB

⊟

9.86 KB

⊟

10.9 KB

⊟

12.7 KB

⊟

68.3 KB

⊟

56.4 KB

⊟

66.6 KB

⊟

56.3 KB

⊟

53.0 KB

⊟

52.9 KB

⊟

102 KB

⊟

116 KB

⊟

101 KB

⊟

51.4 KB

⊟

35.0 KB

⊟

538 KB

Max HTML report size reached

⊟

126 KB

⊟

8.27 KB

Max HTML report size reached

⊟

32.6 KB

⊟

33.3 KB

⊟

32.7 KB

⊟

30.5 KB

⊟

32.6 KB

⊟

33.3 KB

⊟

26.9 KB

⊟

11.4 KB

⊟

2.33 KB

⊟

2.78 KB

⊟

1.7 KB

⊟

11.6 KB

⊟

378 KB

⊟

137 KB

⊟

111 KB

⊟

76.9 KB

⊟

7.44 KB

⊟

12.0 KB

⊟

11.6 KB

⊟

11.5 KB

⊟

10.9 KB

⊟

7.42 KB

⊟

13.9 KB

⊟

12.5 KB

⊟

14.5 KB

⊟

351 KB

⊟

337 KB

⊟

346 KB

⊟

328 KB

⊟

328 KB

⊟

345 KB

⊟

351 KB

⊟

334 KB

⊟

330 KB

⊟

340 KB

⊟

358 KB

Max HTML report size reached

⊟

352 KB

⊟

345 KB

⊟

351 KB

⊟

334 KB

⊟

330 KB

⊟

345 KB

⊟

328 KB

⊟

311 KB

⊟

310 KB

⊟

349 KB

⊟

346 KB

⊟

330 KB

⊟

328 KB

⊟

311 KB

⊟

310 KB

⊟

345 KB

⊟

19.7 KB

⊟

16.8 KB

⊟

90.6 KB

⊟

9.25 KB

⊟

8.64 KB

⊟

8.73 KB

⊟

10.7 KB

⊟

9.17 KB

⊟

8.41 KB

⊟

8.45 KB

⊟

23.6 KB

⊟

64.5 KB

⊟

64.6 KB

⊟

17.6 KB

⊟

77.9 KB

⊟

77.0 KB

⊟

81.6 KB

⊟

73.8 KB

⊟

75.0 KB

⊟

72.6 KB

⊟

18.3 KB

⊟

61.8 KB

⊟

27.6 KB

⊟

29.9 KB

⊟

340 KB

⊟

341 KB

⊟

336 KB

⊟

317 KB

⊟

323 KB

⊟

324 KB

⊟

324 KB

⊟

338 KB

⊟

334 KB

⊟

345 KB

⊟

344 KB

⊟

74.6 KB

⊟

348 KB

⊟

346 KB

⊟

351 KB

⊟

332 KB

⊟

352 KB

⊟

348 KB

⊟

341 KB

⊟

350 KB

⊟

329 KB

⊟

350 KB

⊟

340 KB

⊟

66.6 KB

⊟

319 KB

⊟

83.3 KB

⊟

103 KB

⊟

2.72 KB

Max HTML report size reached

⊟

4.87 KB

⊟

319 KB

⊟

44.5 KB

⊟

80.4 KB

⊟

803 KB

Max HTML report size reached

⊟

3.63 KB

⊟

8.07 KB

⊟

415 KB

Max HTML report size reached

⊟

116 KB

⊟

5.52 KB

⊟

7.7 KB

⊟

3.61 KB

⊟

337 KB

⊟

289 KB

⊟

355 KB

Max HTML report size reached

⊟

337 KB

⊟

1.08 MB

Max HTML report size reached

⊟

2.07 KB

⊟

1.89 KB

Max HTML report size reached

⊟

8.55 KB

⊟

8.42 KB

Max HTML report size reached

⊟

4.2 KB

⊟

4.06 KB

Max HTML report size reached

⊟

42.5 KB

⊟

42.4 KB

Max HTML report size reached

⊟

17.6 KB

⊟

17.5 KB

Max HTML report size reached

⊟

14.2 KB

⊟

14.1 KB

Max HTML report size reached

⊟

53.1 KB

⊟

52.9 KB

Max HTML report size reached

⊟

15.8 KB

⊟

15.6 KB

Max HTML report size reached

⊟

5.21 KB

⊟

5.07 KB

Max HTML report size reached

⊟

14.3 KB

⊟

14.2 KB

Max HTML report size reached

⊟

106 KB

⊟

105 KB

Max HTML report size reached

⊟

8.96 KB

⊟

8.82 KB

Max HTML report size reached

⊟

34.6 KB

⊟

34.5 KB

Max HTML report size reached

⊟

9.0 KB

⊟

8.87 KB

Max HTML report size reached

⊟

59.7 KB

⊟

59.5 KB

Max HTML report size reached

⊟

12.1 KB

⊟

12.0 KB

Max HTML report size reached

⊟

4.43 KB

⊟

4.3 KB

Max HTML report size reached

⊟

2.13 KB

⊟

1.99 KB

Max HTML report size reached

⊟

14.4 KB

⊟

14.3 KB

Max HTML report size reached

⊟

2.06 KB

⊟

1.93 KB

Max HTML report size reached

⊟

23.0 KB

⊟

22.9 KB

Max HTML report size reached

⊟

24.7 KB

⊟

24.6 KB

Max HTML report size reached

⊟

20.7 KB

⊟

20.5 KB

Max HTML report size reached

⊟

28.0 KB

⊟

27.8 KB

Max HTML report size reached

⊟

26.8 KB

⊟

26.7 KB

Max HTML report size reached

⊟

42.3 KB

⊟

42.2 KB

Max HTML report size reached

⊟

35.6 KB

⊟

35.4 KB

Max HTML report size reached

⊟

6.97 KB

⊟

6.81 KB

Max HTML report size reached

⊟

2.01 KB

⊟

1.88 KB

Max HTML report size reached

⊟

71.7 KB

⊟

71.5 KB

Max HTML report size reached

⊟

1.14 KB

⊟

1.0 KB

Max HTML report size reached

⊟

94.9 KB

⊟

94.7 KB

Max HTML report size reached

⊟

6.91 KB

⊟

6.75 KB

Max HTML report size reached

⊟

94.9 KB

⊟

94.7 KB

Max HTML report size reached

⊟

72.3 KB

⊟

72.2 KB

Max HTML report size reached

⊟

3.48 KB

⊟

3.35 KB

Max HTML report size reached

⊟

3.63 KB

⊟

3.49 KB

Max HTML report size reached

⊟

4.31 KB

⊟

4.17 KB

Max HTML report size reached

⊟

2.25 KB

⊟

2.09 KB

Max HTML report size reached

⊟

2.29 KB

⊟

2.13 KB

Max HTML report size reached

⊟

2.31 KB

⊟

2.14 KB

Max HTML report size reached

⊟

3.43 KB

⊟

3.3 KB

Max HTML report size reached

⊟

3.42 KB

⊟

3.29 KB

Max HTML report size reached

⊟

3.43 KB

⊟

3.3 KB

Max HTML report size reached

⊟

3.92 KB

⊟

3.77 KB

Max HTML report size reached

⊟

10.8 KB

⊟

10.7 KB

Max HTML report size reached

⊟

7.0 KB

⊟

6.86 KB

Max HTML report size reached

⊟

7.64 KB

⊟

7.49 KB

Max HTML report size reached

⊟

20.5 KB

⊟

20.4 KB

Max HTML report size reached

⊟

2.12 KB

⊟

1.99 KB

Max HTML report size reached

⊟

2.17 KB

⊟

2.02 KB

Max HTML report size reached

⊟

2.18 KB

⊟

2.03 KB

Max HTML report size reached

⊟

8.38 KB

⊟

8.24 KB

Max HTML report size reached

⊟

4.27 KB

⊟

4.13 KB

Max HTML report size reached

⊟

11.3 KB

⊟

11.2 KB

Max HTML report size reached

⊟

10.2 KB

⊟

10.0 KB

Max HTML report size reached

⊟

116 KB

⊟

116 KB

Max HTML report size reached

⊟

99.5 KB

⊟

99.4 KB

Max HTML report size reached

⊟

6.86 KB

⊟

6.71 KB

Max HTML report size reached

⊟

28.3 KB

⊟

28.1 KB

Max HTML report size reached

⊟

56.2 KB

⊟

56.1 KB

Max HTML report size reached

⊟

314 KB

⊟

314 KB

Max HTML report size reached

⊟

54.1 MB

cargo-dbgsym_1.85.0+dfsg2-3_i386.deb ¶

⊟

367 B

file list ¶

⊟

652 B

control.tar.xz ¶

⊟

624 B

control.tar ¶

⊟

376 B

./control ¶

⊟

226 B

./md5sums ¶

⊟

30.0 B

./md5sums ¶

Files differ

⊟

178 B

line order ¶

⊟

54.1 MB

data.tar.xz ¶

⊟

54.1 MB

data.tar ¶

⊟

1.38 KB

file list ¶

⊟

54.1 MB

./usr/lib/debug/.build-id/61/3898fb46c99101473b69f049793ef5c300e362.debug vs.

./usr/lib/debug/.build-id/15/7fc4852173f3e1d55096ebf43703a726a9f211.debug ¶

File has been modified after NT_GNU_BUILD_ID has been applied. Files 99% similar despite different names

⊟

976 B

readelf --wide --file-header {} ¶

error from `readelf --wide --file-header {}`: readelf: Error: Unable to find program interpreter name

⊟

1.86 KB

readelf --wide --sections {} ¶

Max HTML report size reached

⊟

13.2 MB

readelf --wide --symbols {} ¶

Max HTML report size reached

⊟

709 B

readelf --wide --notes {} ¶

error from `readelf --wide --notes {}`: readelf: Error: Unable to find program interpreter name

⊟

292 KB

strings --all --bytes=8 {} ¶

Max HTML report size reached

⊟

40.6 MB

readelf --wide --decompress --hex-dump=.strtab {} ¶

Max HTML report size reached


Offset 1, 3 lines modified		Offset 1, 3 lines modified
1	-rw-r--r--···0········0········0········4·2025-04-11·11:40:09.000000·debian-binary	1	-rw-r--r--···0········0········0········4·2025-04-11·11:40:09.000000·debian-binary
2	-rw-r--r--···0········0········0·····2184·2025-04-11·11:40:09.000000·control.tar.xz	2	-rw-r--r--···0········0········0·····2188·2025-04-11·11:40:09.000000·control.tar.xz
3	-rw-r--r--···0········0········0··7110~~696~~·2025-04-11·11:40:09.000000·data.tar.xz	3	-rw-r--r--···0········0········0··7110244·2025-04-11·11:40:09.000000·data.tar.xz


Offset 1, 8 lines modified		Offset 1, 8 lines modified

1	Displaying·notes·found·in:·.note.gnu.build-id	1	Displaying·notes·found·in:·.note.gnu.build-id
2	··Owner················Data·size·» Description	2	··Owner················Data·size·» Description
3	··GNU··················0x00000014» NT_GNU_BUILD_ID·(unique·build·ID·bitstring)» ····Build·ID:·613898f~~b46~~c~~9910~~1473~~b69f0497~~93ef~~5c3~~0~~0e3~~62	3	··GNU··················0x00000014» NT_GNU_BUILD_ID·(unique·build·ID·bitstring)» ····Build·ID:·157fc4852173f3e1d55096ebf43703a726a9f211

4	Displaying·notes·found·in:·.note.ABI-tag	4	Displaying·notes·found·in:·.note.ABI-tag
5	··Owner················Data·size·» Description	5	··Owner················Data·size·» Description
6	··GNU··················0x00000010» NT_GNU_ABI_TAG·(ABI·version·tag)» ····OS:·Linux,·ABI:·3.2.0	6	··GNU··················0x00000010» NT_GNU_ABI_TAG·(ABI·version·tag)» ····OS:·Linux,·ABI:·3.2.0


Offset 1, 7 lines modified		Offset 1, 7 lines modified

1	Hex·dump·of·section·'.gnu_debuglink':	1	Hex·dump·of·section·'.gnu_debuglink':
2	··0x00000000·33383938·66623436·63393931·30313437·3898fb46c9910147
3	··0x00000010·336~~236~~39·66303439·37393365·66356333·~~3b69f049~~793ef~~5c3~~	2	··0x00000000·37666334·38353231·37336633·65316435·7fc4852173f3e1d5
		3	··0x00000010·35303936·65626634·33373033·61373236·5096ebf43703a726
4	··0x00000020·30306533·36322e64·65627567·00000000·~~00e362~~.debug....	4	··0x00000020·61396632·31312e64·65627567·00000000·a9f211.debug....
5	··0x00000030·c~~9fbe~~fb7····························....	5	··0x00000030·cbb24fff····························..O.


Offset 1, 3 lines modified		Offset 1, 3 lines modified
1	-rw-r--r--···0········0········0········4·2025-04-11·11:40:09.000000·debian-binary	1	-rw-r--r--···0········0········0········4·2025-04-11·11:40:09.000000·debian-binary
2	-rw-r--r--···0········0········0···948~~296~~·2025-04-11·11:40:09.000000·control.tar.xz	2	-rw-r--r--···0········0········0···948548·2025-04-11·11:40:09.000000·control.tar.xz
3	-rw-r--r--···0········0········0·21~~949020~~·2025-04-11·11:40:09.000000·data.tar.xz	3	-rw-r--r--···0········0········0·21803688·2025-04-11·11:40:09.000000·data.tar.xz


Offset 1, 21 lines modified		Offset 1, 21 lines modified

1	·d27~~2211e80baf9e8~~b6eef5c~~41d~~7~~c3ffd~~·3174~~632~~·debug·optional·cargo-dbgsym_1.85.0+dfsg2-3_i386.deb	1	·01a748453e6a0e7d5b26e0530a70ac16·3174756·debug·optional·cargo-dbgsym_1.85.0+dfsg2-3_i386.deb
2	·c4bfe690d9f4f62734d8fae32760fdb9·4376744·doc·optional·cargo-doc_1.85.0+dfsg2-3_all.deb	2	·c4bfe690d9f4f62734d8fae32760fdb9·4376744·doc·optional·cargo-doc_1.85.0+dfsg2-3_all.deb
3	·b8f5~~ad7cb2~~fc~~0633c3c~~a~~9c7~~f~~c23046d2~~·711~~3072~~·devel·optional·cargo_1.85.0+dfsg2-3_i386.deb	3	·95763ffefec107ce51a1b5f87b6a840a·7112624·devel·optional·cargo_1.85.0+dfsg2-3_i386.deb
4	·8f3f1db308faa17a419a9633d101abb1·7209808·debug·optional·libstd-rust-1.85-dbgsym_1.85.0+dfsg2-3_i386.deb	4	·8f3f1db308faa17a419a9633d101abb1·7209808·debug·optional·libstd-rust-1.85-dbgsym_1.85.0+dfsg2-3_i386.deb
5	·eda02b6d85c9ece9a6e02d6efa02b931·21960668·libs·optional·libstd-rust-1.85_1.85.0+dfsg2-3_i386.deb	5	·eda02b6d85c9ece9a6e02d6efa02b931·21960668·libs·optional·libstd-rust-1.85_1.85.0+dfsg2-3_i386.deb
6	·cd096c61ef4544f4e14416b730723e64·91360448·libdevel·optional·libstd-rust-dev-wasm32_1.85.0+dfsg2-3_all.deb	6	·cd096c61ef4544f4e14416b730723e64·91360448·libdevel·optional·libstd-rust-dev-wasm32_1.85.0+dfsg2-3_all.deb
7	·d6323887e6db3f180a5ae83956579f71·37900784·libdevel·optional·libstd-rust-dev_1.85.0+dfsg2-3_i386.deb	7	·d6323887e6db3f180a5ae83956579f71·37900784·libdevel·optional·libstd-rust-dev_1.85.0+dfsg2-3_i386.deb
8	·b2b52339110f27c5a3db2db0e9dfee90·243256·devel·optional·rust-all_1.85.0+dfsg2-3_all.deb	8	·b2b52339110f27c5a3db2db0e9dfee90·243256·devel·optional·rust-all_1.85.0+dfsg2-3_all.deb
9	·82c28acb923b95915e37e5dc7e6385ae·1219372·debug·optional·rust-analyzer-dbgsym_1.85.0+dfsg2-3_i386.deb	9	·82c28acb923b95915e37e5dc7e6385ae·1219372·debug·optional·rust-analyzer-dbgsym_1.85.0+dfsg2-3_i386.deb
10	·07a1267908ee4b96a2ab27ead48b1136·8756840·devel·optional·rust-analyzer_1.85.0+dfsg2-3_i386.deb	10	·07a1267908ee4b96a2ab27ead48b1136·8756840·devel·optional·rust-analyzer_1.85.0+dfsg2-3_i386.deb
11	·4728defc0542c3b2e8bd3d669e012bbb·522152·debug·optional·rust-clippy-dbgsym_1.85.0+dfsg2-3_i386.deb	11	·4728defc0542c3b2e8bd3d669e012bbb·522152·debug·optional·rust-clippy-dbgsym_1.85.0+dfsg2-3_i386.deb
12	·d0f67757cfab1b680ca344d75c842732·3605172·devel·optional·rust-clippy_1.85.0+dfsg2-3_i386.deb	12	·d0f67757cfab1b680ca344d75c842732·3605172·devel·optional·rust-clippy_1.85.0+dfsg2-3_i386.deb
13	·~~e6e94003cbc3b660582f781c~~b6608f69·22~~89750~~8·doc·optional·rust-doc_1.85.0+dfsg2-3_all.deb	13	·4ffa3351ae52952b4ce46c36b280326a·22752428·doc·optional·rust-doc_1.85.0+dfsg2-3_all.deb
14	·579336993bac61847ced24b478c272ee·249020·devel·optional·rust-gdb_1.85.0+dfsg2-3_all.deb	14	·579336993bac61847ced24b478c272ee·249020·devel·optional·rust-gdb_1.85.0+dfsg2-3_all.deb
15	·0bca1cd1f72fbf39278d73f9360ee3b7·249928·devel·optional·rust-lldb_1.85.0+dfsg2-3_all.deb	15	·0bca1cd1f72fbf39278d73f9360ee3b7·249928·devel·optional·rust-lldb_1.85.0+dfsg2-3_all.deb
16	·34a9800b776514af1fffe1e27193c5ad·1897524·devel·optional·rust-llvm_1.85.0+dfsg2-3_i386.deb	16	·34a9800b776514af1fffe1e27193c5ad·1897524·devel·optional·rust-llvm_1.85.0+dfsg2-3_i386.deb
17	·079993f4bc5957e1601ffa05ac8de8d3·46858120·devel·optional·rust-src_1.85.0+dfsg2-3_all.deb	17	·079993f4bc5957e1601ffa05ac8de8d3·46858120·devel·optional·rust-src_1.85.0+dfsg2-3_all.deb
18	·e1e56a48821e9854a000f0c4b674e776·1715976·debug·optional·rustc-dbgsym_1.85.0+dfsg2-3_i386.deb	18	·e1e56a48821e9854a000f0c4b674e776·1715976·debug·optional·rustc-dbgsym_1.85.0+dfsg2-3_i386.deb
19	·62c5f7b486ec3118fe4108649fdf2431·4047112·devel·optional·rustc_1.85.0+dfsg2-3_i386.deb	19	·62c5f7b486ec3118fe4108649fdf2431·4047112·devel·optional·rustc_1.85.0+dfsg2-3_i386.deb
20	·b6f0ec9041b6b1efadb63417369b0ddd·2564780·debug·optional·rustfmt-dbgsym_1.85.0+dfsg2-3_i386.deb	20	·b6f0ec9041b6b1efadb63417369b0ddd·2564780·debug·optional·rustfmt-dbgsym_1.85.0+dfsg2-3_i386.deb


Offset 1, 13 lines modified		Offset 1, 13 lines modified
1	Package:·rust-doc	1	Package:·rust-doc
2	Source:·rustc	2	Source:·rustc
3	Version:·1.85.0+dfsg2-3	3	Version:·1.85.0+dfsg2-3
4	Architecture:·all	4	Architecture:·all
5	Maintainer:·Debian·Rust·Maintainers·<pkg-rust-maintainers@alioth-lists.debian.net>	5	Maintainer:·Debian·Rust·Maintainers·<pkg-rust-maintainers@alioth-lists.debian.net>
6	Installed-Size:·52~~2354~~	6	Installed-Size:·524606
7	Depends:·libjs-jquery,·libjs-highlight.js,·libjs-mathjax,·fonts-open-sans,·fonts-font-awesome	7	Depends:·libjs-jquery,·libjs-highlight.js,·libjs-mathjax,·fonts-open-sans,·fonts-font-awesome
8	Recommends:·cargo-doc	8	Recommends:·cargo-doc
9	Section:·doc	9	Section:·doc
10	Priority:·optional	10	Priority:·optional
11	Homepage:·http://www.rust-lang.org/	11	Homepage:·http://www.rust-lang.org/
12	Description:·Rust·systems·programming·language·-·Documentation	12	Description:·Rust·systems·programming·language·-·Documentation
13	·Rust·is·a·curly-brace,·block-structured·expression·language.··It	13	·Rust·is·a·curly-brace,·block-structured·expression·language.··It


Offset 1, 8 lines modified		Offset 1, 8 lines modified
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="Allocates·memory·with·the·global·allocator."><title>alloc·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4»2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">alloc</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#safety"·title="Safety">Safety</a></li><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Function·<span·class="fn">alloc</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0">1.36.0</span>···<a·class="src"·href="../../src/alloc/alloc.rs.html#90-98">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·unsafe·fn·alloc(layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>)·->·<a·class="primitive"·href="../../core/primitive.pointer.html">*mut·</a><a·class="primitive"·href="../../core/primitive.u8.html">u8</a></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Allocates·memory·with·the·global·allocator.</p>	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="Allocates·memory·with·the·global·allocator."><title>alloc·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4»2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">alloc</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#safety"·title="Safety">Safety</a></li><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Function·<span·class="fn">alloc</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0">1.36.0</span>···<a·class="src"·href="../../src/alloc/alloc.rs.html#90-98">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·unsafe·fn·alloc(layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>)·->·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.pointer.html">*mut·</a><a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.u8.html">u8</a></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Allocates·memory·with·the·global·allocator.</p>
2	<p>This·function·forwards·calls·to·the·<a·href="trait.GlobalAlloc.html#tymethod.alloc"·title="method·alloc::alloc::GlobalAlloc::alloc"><code>GlobalAlloc::alloc</code></a>·method	2	<p>This·function·forwards·calls·to·the·<a·href="trait.GlobalAlloc.html#tymethod.alloc"·title="method·alloc::alloc::GlobalAlloc::alloc"><code>GlobalAlloc::alloc</code></a>·method
3	of·the·allocator·registered·with·the·<code>#[global_allocator]</code>·attribute	3	of·the·allocator·registered·with·the·<code>#[global_allocator]</code>·attribute
4	if·there·is·one,·or·the·<code>std</code>·crate’s·default.</p>	4	if·there·is·one,·or·the·<code>std</code>·crate’s·default.</p>
5	<p>This·function·is·expected·to·be·deprecated·in·favor·of·the·<code>allocate</code>·method	5	<p>This·function·is·expected·to·be·deprecated·in·favor·of·the·<code>allocate</code>·method
6	of·the·<a·href="struct.Global.html"·title="struct·alloc::alloc::Global"><code>Global</code></a>·type·when·it·and·the·<a·href="trait.Allocator.html"·title="trait·alloc::alloc::Allocator"><code>Allocator</code></a>·trait·become·stable.</p>	6	of·the·<a·href="struct.Global.html"·title="struct·alloc::alloc::Global"><code>Global</code></a>·type·when·it·and·the·<a·href="trait.Allocator.html"·title="trait·alloc::alloc::Allocator"><code>Allocator</code></a>·trait·become·stable.</p>
7	<h2·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h2>	7	<h2·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h2>
8	<p>See·<a·href="trait.GlobalAlloc.html#tymethod.alloc"·title="method·alloc::alloc::GlobalAlloc::alloc"><code>GlobalAlloc::alloc</code></a>.</p>	8	<p>See·<a·href="trait.GlobalAlloc.html#tymethod.alloc"·title="method·alloc::alloc::GlobalAlloc::alloc"><code>GlobalAlloc::alloc</code></a>.</p>


Offset 1, 22 lines modified		Offset 1, 22 lines modified
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="Signals·a·memory·allocation·error."><title>handle_alloc_error·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)»(built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Function·<span·class="fn">handle_alloc_error</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0,·const·unstable">1.36.0·(const:·<a·href="https://github.com/rust-lang/rust/issues/92523"·title="Tracking·issue·for·const_alloc_error">unstable</a>)</span>···<a·class="src"·href="../../src/alloc/alloc.rs.html#395-414">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·handle_alloc_error(layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>)·->·<a·class="primitive"·href="../../core/primitive.never.html">!</a></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Signals·a·memory·allocation·error.</p>	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="Signals·a·memory·allocation·error."><title>handle_alloc_error·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)»(built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Function·<span·class="fn">handle_alloc_error</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0,·const·unstable">1.36.0·(const:·<a·href="https://github.com/rust-lang/rust/issues/92523"·title="Tracking·issue·for·const_alloc_error">unstable</a>)</span>···<a·class="src"·href="../../src/alloc/alloc.rs.html#395-414">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·handle_alloc_error(layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>)·->·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.never.html">!</a></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Signals·a·memory·allocation·error.</p>
2	<p>Callers·of·memory·allocation·APIs·wishing·to·cease·execution	2	<p>Callers·of·memory·allocation·APIs·wishing·to·cease·execution
3	in·response·to·an·allocation·error·are·encouraged·to·call·this·function,	3	in·response·to·an·allocation·error·are·encouraged·to·call·this·function,
4	rather·than·directly·invoking·<a·href="../../core/macro.panic.html"·title="macro·core::panic"><code>panic!</code></a>·or·similar.</p>	4	rather·than·directly·invoking·<a·href="https://doc.rust-lang.org/1.85.0/core/macro.panic.html"·title="macro·core::panic"><code>panic!</code></a>·or·similar.</p>
5	<p>This·function·is·guaranteed·to·diverge·(not·return·normally·with·a·value),·but·depending·on	5	<p>This·function·is·guaranteed·to·diverge·(not·return·normally·with·a·value),·but·depending·on
6	global·configuration,·it·may·either·panic·(resulting·in·unwinding·or·aborting·as·per	6	global·configuration,·it·may·either·panic·(resulting·in·unwinding·or·aborting·as·per
7	configuration·for·all·panics),·or·abort·the·process·(with·no·unwinding).</p>	7	configuration·for·all·panics),·or·abort·the·process·(with·no·unwinding).</p>
8	<p>The·default·behavior·is:</p>	8	<p>The·default·behavior·is:</p>
9	<ul>	9	<ul>
10	<li>	10	<li>
11	<p>If·the·binary·links·against·<code>std</code>·(typically·the·case),·then	11	<p>If·the·binary·links·against·<code>std</code>·(typically·the·case),·then
12	print·a·message·to·standard·error·and·abort·the·process.	12	print·a·message·to·standard·error·and·abort·the·process.
13	This·behavior·can·be·replaced·with·<a·href="../../std/alloc/fn.set_alloc_error_hook.html"><code>set_alloc_error_hook</code></a>·and·<a·href="../../std/alloc/fn.take_alloc_error_hook.html"><code>take_alloc_error_hook</code></a>.	13	This·behavior·can·be·replaced·with·<a·href="../../std/alloc/fn.set_alloc_error_hook.html"><code>set_alloc_error_hook</code></a>·and·<a·href="../../std/alloc/fn.take_alloc_error_hook.html"><code>take_alloc_error_hook</code></a>.
14	Future·versions·of·Rust·may·panic·by·default·instead.</p>	14	Future·versions·of·Rust·may·panic·by·default·instead.</p>
15	</li>	15	</li>
16	<li>	16	<li>
17	<p>If·the·binary·does·not·link·against·<code>std</code>·(all·of·its·crates·are·marked	17	<p>If·the·binary·does·not·link·against·<code>std</code>·(all·of·its·crates·are·marked
18	<a·href="https://doc.rust-lang.org/reference/names/preludes.html#the-no_std-attribute"><code>#![no_std]</code></a>),·then·call·<a·href="../../core/macro.panic.html"·title="macro·core::panic"><code>panic!</code></a>·with·a·message.	18	<a·href="https://doc.rust-lang.org/reference/names/preludes.html#the-no_std-attribute"><code>#![no_std]</code></a>),·then·call·<a·href="https://doc.rust-lang.org/1.85.0/core/macro.panic.html"·title="macro·core::panic"><code>panic!</code></a>·with·a·message.
19	<a·href="https://doc.rust-lang.org/reference/runtime.html#the-panic_handler-attribute">The·panic·handler</a>·applies·as·to·any·panic.</p>	19	<a·href="https://doc.rust-lang.org/reference/runtime.html#the-panic_handler-attribute">The·panic·handler</a>·applies·as·to·any·panic.</p>
20	</li>	20	</li>
21	</ul>	21	</ul>
22	</div></details></section></div></main></body></html>	22	</div></details></section></div></main></body></html>


Offset 1, 1 lines modified		Offset 1, 1 lines modified
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="API·documentation·for·the·Rust·`LayoutErr`·type·in·crate·`alloc`."><title>LayoutErr·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·type"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4»2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Layout<wbr>Err</a></h2><h3><a·href="#aliased-type">Aliased·type</a></h3></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Type·Alias·<span·class="type">LayoutErr</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0">1.36.0</span>···<a·class="src"·href="../../src/core/alloc/layout.rs.html#532">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·type·LayoutErr·=·<a·class="struct"·href="struct.LayoutError.html"·title="struct·alloc::alloc::LayoutError">LayoutError</a>;</code></pre><span·class="item-info"><div·class="stab·deprecated"><span·class="emoji">👎</span><span>Deprecated·since·1.52.0:·Name·does·not·follow·std·convention,·use·LayoutError</span></div></span><h2·id="aliased-type"·class="section-header">Aliased·Type<a·href="#aliased-type"·class="anchor">§</a></h2><pre·class="rust·item-decl"><code>struct·LayoutErr;</code></pre><script·src="../../type.impl/alloc/alloc/struct.LayoutError.js"·data-self-path="alloc::alloc::LayoutErr"·async></script></section></div></main></body></html>	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="API·documentation·for·the·Rust·`LayoutErr`·type·in·crate·`alloc`."><title>LayoutErr·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·type"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4»2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Layout<wbr>Err</a></h2><h3><a·href="#aliased-type">Aliased·type</a></h3></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Type·Alias·<span·class="type">LayoutErr</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0">1.36.0</span>···<a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/alloc/layout.rs.html#532">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·type·LayoutErr·=·<a·class="struct"·href="struct.LayoutError.html"·title="struct·alloc::alloc::LayoutError">LayoutError</a>;</code></pre><span·class="item-info"><div·class="stab·deprecated"><span·class="emoji">👎</span><span>Deprecated·since·1.52.0:·Name·does·not·follow·std·convention,·use·LayoutError</span></div></span><h2·id="aliased-type"·class="section-header">Aliased·Type<a·href="#aliased-type"·class="anchor">§</a></h2><pre·class="rust·item-decl"><code>struct·LayoutErr;</code></pre><script·src="../../type.impl/alloc/alloc/struct.LayoutError.js"·data-self-path="alloc::alloc::LayoutErr"·async></script></section></div></main></body></html>


Offset 18, 18 lines modified		Offset 18, 18 lines modified

18	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>s:·<span·class="kw-2">&</span>str·=·<span·class="string">"a"</span>;	18	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>s:·<span·class="kw-2">&</span>str·=·<span·class="string">"a"</span>;
19	<span·class="kw">let·</span>ss:·String·=·s.to_owned();	19	<span·class="kw">let·</span>ss:·String·=·s.to_owned();

20	<span·class="kw">let·</span>v:·<span·class="kw-2">&</span>[i32]·=·<span·class="kw-2">&</span>[<span·class="number">1</span>,·<span·class="number">2</span>];	20	<span·class="kw">let·</span>v:·<span·class="kw-2">&</span>[i32]·=·<span·class="kw-2">&</span>[<span·class="number">1</span>,·<span·class="number">2</span>];
21	<span·class="kw">let·</span>vv:·Vec<i32>·=·v.to_owned();</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+s:+%26str+=+%22a%22;%0A++++let+ss:+String+=+s.to_owned();%0A++++%0A++++let+v:+%26%5Bi32%5D+=+%26%5B1,+2%5D;%0A++++let+vv:+Vec%3Ci32%3E+=+v.to_owned();%0A%7D&edition=2021"></a></div>	21	<span·class="kw">let·</span>vv:·Vec<i32>·=·v.to_owned();</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+s:+%26str+=+%22a%22;%0A++++let+ss:+String+=+s.to_owned();%0A++++%0A++++let+v:+%26%5Bi32%5D+=+%26%5B1,+2%5D;%0A++++let+vv:+Vec%3Ci32%3E+=+v.to_owned();%0A%7D&edition=2021"></a></div>
22	</div></details></div><h2·id="provided-methods"·class="section-header">Provided·Methods<a·href="#provided-methods"·class="anchor">§</a></h2><div·class="methods"><details·class="toggle·method-toggle"·open><summary><section·id="method.clone_into"·class="method"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.63.0">1.63.0</span>···<a·class="src"·href="../../src/alloc/borrow.rs.html#76-78">Source</a></span><h4·class="code-header">fn·<a·href="#method.clone_into"·class="fn">clone_into</a>(&self,·target:·&mut·Self::<a·class="associatedtype"·href="trait.ToOwned.html#associatedtype.Owned"·title="type·alloc::borrow::ToOwned::Owned">Owned</a>)</h4></section></summary><div·class="docblock"><p>Uses·borrowed·data·to·replace·owned·data,·usually·by·cloning.</p>	22	</div></details></div><h2·id="provided-methods"·class="section-header">Provided·Methods<a·href="#provided-methods"·class="anchor">§</a></h2><div·class="methods"><details·class="toggle·method-toggle"·open><summary><section·id="method.clone_into"·class="method"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.63.0">1.63.0</span>···<a·class="src"·href="../../src/alloc/borrow.rs.html#76-78">Source</a></span><h4·class="code-header">fn·<a·href="#method.clone_into"·class="fn">clone_into</a>(&self,·target:·&mut·Self::<a·class="associatedtype"·href="trait.ToOwned.html#associatedtype.Owned"·title="type·alloc::borrow::ToOwned::Owned">Owned</a>)</h4></section></summary><div·class="docblock"><p>Uses·borrowed·data·to·replace·owned·data,·usually·by·cloning.</p>
23	<p>This·is·borrow-generalized·version·of·<a·href="../../core/clone/trait.Clone.html#method.clone_from"·title="method·core::clone::Clone::clone_from"><code>Clone::clone_from</code></a>.</p>	23	<p>This·is·borrow-generalized·version·of·<a·href="https://doc.rust-lang.org/1.85.0/core/clone/trait.Clone.html#method.clone_from"·title="method·core::clone::Clone::clone_from"><code>Clone::clone_from</code></a>.</p>
24	<h5·id="examples-1"><a·class="doc-anchor"·href="#examples-1">§</a>Examples</h5>	24	<h5·id="examples-1"><a·class="doc-anchor"·href="#examples-1">§</a>Examples</h5>
25	<p>Basic·usage:</p>	25	<p>Basic·usage:</p>

26	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span><span·class="kw-2">mut·</span>s:·String·=·String::new();	26	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span><span·class="kw-2">mut·</span>s:·String·=·String::new();
27	<span·class="string">"hello"</span>.clone_into(<span·class="kw-2">&mut·</span>s);	27	<span·class="string">"hello"</span>.clone_into(<span·class="kw-2">&mut·</span>s);

28	<span·class="kw">let·</span><span·class="kw-2">mut·</span>v:·Vec<i32>·=·Vec::new();	28	<span·class="kw">let·</span><span·class="kw-2">mut·</span>v:·Vec<i32>·=·Vec::new();
29	[<span·class="number">1</span>,·<span·class="number">2</span>][..].clone_into(<span·class="kw-2">&mut·</span>v);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+mut+s:+String+=+String::new();%0A++++%22hello%22.clone_into(%26mut+s);%0A++++%0A++++let+mut+v:+Vec%3Ci32%3E+=+Vec::new();%0A++++%5B1,+2%5D%5B..%5D.clone_into(%26mut+v);%0A%7D&edition=2021"></a></div>	29	[<span·class="number">1</span>,·<span·class="number">2</span>][..].clone_into(<span·class="kw-2">&mut·</span>v);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+mut+s:+String+=+String::new();%0A++++%22hello%22.clone_into(%26mut+s);%0A++++%0A++++let+mut+v:+Vec%3Ci32%3E+=+Vec::new();%0A++++%5B1,+2%5D%5B..%5D.clone_into(%26mut+v);%0A%7D&edition=2021"></a></div>
30	</div></details></div><h2·id="dyn-compatibility"·class="section-header">Dyn·Compatibility<a·href="#dyn-compatibility"·class="anchor">§</a></h2><div·class="dyn-compatibility-info"><p>This·trait·is·<b>not</b>·<a·href="https://doc.rust-lang.org/1.85.0/reference/items/traits.html#object-safety">dyn·compatible</a>.</p><p><i>In·older·versions·of·Rust,·dyn·compatibility·was·called·"object·safety",·so·this·trait·is·not·object·safe.</i></p></div><h2·id="implementors"·class="section-header">Implementors<a·href="#implementors"·class="anchor">§</a></h2><div·id="implementors-list"><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToOwned-for-str"·class="impl"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.0.0">1.0.0</span>···<a·class="src"·href="../../src/alloc/str.rs.html#206-219">Source</a></span><a·href="#impl-ToOwned-for-str"·class="anchor">§</a><h3·class="code-header">impl·<a·class="trait"·href="trait.ToOwned.html"·title="trait·alloc::borrow::ToOwned">ToOwned</a>·for·<a·class="primitive"·href="../../core/primitive.str.html">str</a></h3></section></summary><div·class="impl-items"><section·id="associatedtype.Owned-1"·class="associatedtype·trait-impl"><a·class="src·rightside"·href="../../src/alloc/str.rs.html#207">Source~~</a>~~<~~a·href="#associatedtype~~[·...·truncated·by·diffoscope;·len:·~~749~~,·SHA:·c~~3c6~~a9~~27e51~~c830~~01be~~54e6a303aa~~148~~0~~610d~~21~~e82193d2~~8~~9c3f9b85e~~7~~c606d~~d·...·]/core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr">CStr</a></h3></section></summary><div·class="impl-items"><section·id="associatedtype.Owned-2"·class="associatedtype·trait-impl"><a·class="src·rightside"·href="../../src/alloc/ffi/c_str.rs.html#1075">Source</a><a·href="#associatedtype.Owned-2"·class="anchor">§</a><h4·class="code-header">type·<a·href="#associatedtype.Owned"·class="associatedtype">Owned</a>·=·<a·class="struct"·href="../ffi/struct.CString.html"·title="struct·alloc::ffi::CString">CString</a></h4></section></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToOwned-for-T"·class="impl"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.0.0">1.0.0</span>···<a·class="src"·href="../../src/alloc/borrow.rs.html#82-94">Source</a></span><a·href="#impl-ToOwned-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="trait.ToOwned.html"·title="trait·alloc::borrow::ToOwned">ToOwned</a>·for·T<div·class="where">where	30	</div></details></div><h2·id="dyn-compatibility"·class="section-header">Dyn·Compatibility<a·href="#dyn-compatibility"·class="anchor">§</a></h2><div·class="dyn-compatibility-info"><p>This·trait·is·<b>not</b>·<a·href="https://doc.rust-lang.org/1.85.0/reference/items/traits.html#object-safety">dyn·compatible</a>.</p><p><i>In·older·versions·of·Rust,·dyn·compatibility·was·called·"object·safety",·so·this·trait·is·not·object·safe.</i></p></div><h2·id="implementors"·class="section-header">Implementors<a·href="#implementors"·class="anchor">§</a></h2><div·id="implementors-list"><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToOwned-for-str"·class="impl"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.0.0">1.0.0</span>···<a·class="src"·href="../../src/alloc/str.rs.html#206-219">Source</a></span><a·href="#impl-ToOwned-for-str"·class="anchor">§</a><h3·class="code-header">impl·<a·class="trait"·href="trait.ToOwned.html"·title="trait·alloc::borrow::ToOwned">ToOwned</a>·for·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.str.html">str</a></h3></section></summary><div·class="impl-items"><section·id="associatedtype.Owned-1"·class="associatedtype·trait-impl"><a·class="src·rightside"·href="../../src/alloc/str.rs.html#207">Source<[·...·truncated·by·diffoscope;·len:·803,·SHA:·8fea995bcac961705859754b8a009ba0793a213b1cbae0a8ab6e4063671ec48d·...·]/core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr">CStr</a></h3></section></summary><div·class="impl-items"><section·id="associatedtype.Owned-2"·class="associatedtype·trait-impl"><a·class="src·rightside"·href="../../src/alloc/ffi/c_str.rs.html#1075">Source</a><a·href="#associatedtype.Owned-2"·class="anchor">§</a><h4·class="code-header">type·<a·href="#associatedtype.Owned"·class="associatedtype">Owned</a>·=·<a·class="struct"·href="../ffi/struct.CString.html"·title="struct·alloc::ffi::CString">CString</a></h4></section></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToOwned-for-T"·class="impl"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.0.0">1.0.0</span>···<a·class="src"·href="../../src/alloc/borrow.rs.html#82-94">Source</a></span><a·href="#impl-ToOwned-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="trait.ToOwned.html"·title="trait·alloc::borrow::ToOwned">ToOwned</a>·for·T<div·class="where">where
31	····T:·<a·class="trait"·href="../../core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><section·id="associatedtype.Owned-3"·class="associatedtype·trait-impl"><a·class="src·rightside"·~~href="../../src/alloc/borro~~[·...·truncated·by·diffoscope;·len:·811,·SHA:·~~faf~~0~~70d7~~c~~5ce~~c9~~0348f3bc~~5~~be0ed367~~46dd~~fe4bb5e64~~f10~~6e1c32~~3f4~~ea5c9806~~·...·]/core/primitive.slice.html">[T]</a></h3></section></summary><div·class="impl-items"><section·id="associatedtype.Owned-4"·class="associatedtype·trait-impl"><a·class="src·rightside"·href="../../src/alloc/slice.rs.html#884">Source</a><a·href="#associatedtype.Owned-4"·class="anchor">§</a><h4·class="code-header">type·<a·href="#associatedtype.Owned"·class="associatedtype">Owned</a>·=·<a·class="struct"·href="../vec/struct.Vec.html"·title="struct·alloc::vec::Vec">Vec</a><T></h4></section></div></details></div><script·src="../../trait.impl/alloc/borrow/trait.ToOwned.js"·data-ignore-extern-crates="core"·async></script></section></div></main></body></html>	31	····T:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><section·id="associatedtype.Owned-3"·class="associatedtype·trait-impl"><a·class="src·rightside"·[·...·truncated·by·diffoscope;·len:·892,·SHA:·0eab2c31fc9892f686958d1cfcd84c92d56139218cf4a04daf4933a47c207f3d·...·]/core/primitive.slice.html">[T]</a></h3></section></summary><div·class="impl-items"><section·id="associatedtype.Owned-4"·class="associatedtype·trait-impl"><a·class="src·rightside"·href="../../src/alloc/slice.rs.html#884">Source</a><a·href="#associatedtype.Owned-4"·class="anchor">§</a><h4·class="code-header">type·<a·href="#associatedtype.Owned"·class="associatedtype">Owned</a>·=·<a·class="struct"·href="../vec/struct.Vec.html"·title="struct·alloc::vec::Vec">Vec</a><T></h4></section></div></details></div><script·src="../../trait.impl/alloc/borrow/trait.ToOwned.js"·data-ignore-extern-crates="core"·async></script></section></div></main></body></html>


Offset 4, 15 lines modified		Offset 4, 15 lines modified
4	drop·their·contents·when·they·go·out·of·scope.·Boxes·also·ensure·that·they	4	drop·their·contents·when·they·go·out·of·scope.·Boxes·also·ensure·that·they
5	never·allocate·more·than·<code>isize::MAX</code>·bytes.</p>	5	never·allocate·more·than·<code>isize::MAX</code>·bytes.</p>
6	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>	6	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>
7	<p>Move·a·value·from·the·stack·to·the·heap·by·creating·a·<a·href="struct.Box.html"·title="struct·alloc::boxed::Box"><code>Box</code></a>:</p>	7	<p>Move·a·value·from·the·stack·to·the·heap·by·creating·a·<a·href="struct.Box.html"·title="struct·alloc::boxed::Box"><code>Box</code></a>:</p>

8	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>val:·u8·=·<span·class="number">5</span>;	8	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>val:·u8·=·<span·class="number">5</span>;
9	<span·class="kw">let·</span>boxed:·Box<u8>·=·Box::new(val);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+val:+u8+=+5;%0A++++let+boxed:+Box%3Cu8%3E+=+Box::new(val);%0A%7D&edition=2021"></a></div>	9	<span·class="kw">let·</span>boxed:·Box<u8>·=·Box::new(val);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+val:+u8+=+5;%0A++++let+boxed:+Box%3Cu8%3E+=+Box::new(val);%0A%7D&edition=2021"></a></div>
10	<p>Move·a·value·from·a·<a·href="struct.Box.html"·title="struct·alloc::boxed::Box"><code>Box</code></a>·back·to·the·stack·by·<a·href="../../core/ops/deref/trait.Deref.html"·title="trait·core::ops::deref::Deref">dereferencing</a>:</p>	10	<p>Move·a·value·from·a·<a·href="struct.Box.html"·title="struct·alloc::boxed::Box"><code>Box</code></a>·back·to·the·stack·by·<a·href="https://doc.rust-lang.org/1.85.0/core/ops/deref/trait.Deref.html"·title="trait·core::ops::deref::Deref">dereferencing</a>:</p>

11	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>boxed:·Box<u8>·=·Box::new(<span·class="number">5</span>);	11	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>boxed:·Box<u8>·=·Box::new(<span·class="number">5</span>);
12	<span·class="kw">let·</span>val:·u8·=·<span·class="kw-2"></span>boxed;</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+boxed:+Box%3Cu8%3E+=+Box::new(5);%0A++++let+val:+u8+=+boxed;%0A%7D&edition=2021"></a></div>	12	<span·class="kw">let·</span>val:·u8·=·<span·class="kw-2"></span>boxed;</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+boxed:+Box%3Cu8%3E+=+Box::new(5);%0A++++let+val:+u8+=+boxed;%0A%7D&edition=2021"></a></div>
13	<p>Creating·a·recursive·data·structure:</p>	13	<p>Creating·a·recursive·data·structure:</p>

14	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="attr">#[allow(dead_code)]	14	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="attr">#[allow(dead_code)]
15	#[derive(Debug)]	15	#[derive(Debug)]
Offset 39, 15 lines modified		Offset 39, 15 lines modified
39	pointer·points·to·a·valid·value·of·the·right·type.·More·precisely,·a·<code>value:·*mut·T</code>·that·has	39	pointer·points·to·a·valid·value·of·the·right·type.·More·precisely,·a·<code>value:·*mut·T</code>·that·has
40	been·allocated·with·the·<a·href="../alloc/struct.Global.html"·title="struct·alloc::alloc::Global"><code>Global</code></a>·allocator·with·<code>Layout::for_value(&*value)</code>·may·be·converted	40	been·allocated·with·the·<a·href="../alloc/struct.Global.html"·title="struct·alloc::alloc::Global"><code>Global</code></a>·allocator·with·<code>Layout::for_value(&*value)</code>·may·be·converted
41	into·a·box·using·<a·href="struct.Box.html#method.from_raw"·title="associated·function·alloc::boxed::Box::from_raw"><code>Box::<T>::from_raw(value)</code></a>.·Conversely,·the·memory·backing·a·<code>value:·*mut·T</code>	41	into·a·box·using·<a·href="struct.Box.html#method.from_raw"·title="associated·function·alloc::boxed::Box::from_raw"><code>Box::<T>::from_raw(value)</code></a>.·Conversely,·the·memory·backing·a·<code>value:·*mut·T</code>
42	obtained·from·<a·href="struct.Box.html#method.into_raw"·title="associated·function·alloc::boxed::Box::into_raw"><code>Box::<T>::into_raw</code></a>·may·be·deallocated·using·the·<a·href="../alloc/struct.Global.html"·title="struct·alloc::alloc::Global"><code>Global</code></a>·allocator·with	42	obtained·from·<a·href="struct.Box.html#method.into_raw"·title="associated·function·alloc::boxed::Box::into_raw"><code>Box::<T>::into_raw</code></a>·may·be·deallocated·using·the·<a·href="../alloc/struct.Global.html"·title="struct·alloc::alloc::Global"><code>Global</code></a>·allocator·with
43	<a·href="../alloc/struct.Layout.html#method.for_value"·title="associated·function·alloc::alloc::Layout::for_value"><code>Layout::for_value(&*value)</code></a>.</p>	43	<a·href="../alloc/struct.Layout.html#method.for_value"·title="associated·function·alloc::alloc::Layout::for_value"><code>Layout::for_value(&*value)</code></a>.</p>
44	<p>For·zero-sized·values,·the·<code>Box</code>·pointer·has·to·be·non-null·and·sufficiently·aligned.·The	44	<p>For·zero-sized·values,·the·<code>Box</code>·pointer·has·to·be·non-null·and·sufficiently·aligned.·The
45	recommended·way·to·build·a·Box·to·a·ZST·if·<code>Box::new</code>·cannot·be·used·is·to·use	45	recommended·way·to·build·a·Box·to·a·ZST·if·<code>Box::new</code>·cannot·be·used·is·to·use
46	<a·href="../../core/ptr/non_null/struct.NonNull.html#method.dangling"·title="associated·function·core::ptr::non_null::NonNull::dangling"><code>ptr::NonNull::dangling</code></a>.</p>	46	<a·href="https://doc.rust-lang.org/1.85.0/core/ptr/non_null/struct.NonNull.html#method.dangling"·title="associated·function·core::ptr::non_null::NonNull::dangling"><code>ptr::NonNull::dangling</code></a>.</p>
47	<p>On·top·of·these·basic·layout·requirements,·a·<code>Box<T></code>·must·point·to·a·valid·value·of·<code>T</code>.</p>	47	<p>On·top·of·these·basic·layout·requirements,·a·<code>Box<T></code>·must·point·to·a·valid·value·of·<code>T</code>.</p>
48	<p>So·long·as·<code>T:·Sized</code>,·a·<code>Box<T></code>·is·guaranteed·to·be·represented	48	<p>So·long·as·<code>T:·Sized</code>,·a·<code>Box<T></code>·is·guaranteed·to·be·represented
49	as·a·single·pointer·and·is·also·ABI-compatible·with·C·pointers	49	as·a·single·pointer·and·is·also·ABI-compatible·with·C·pointers
50	(i.e.·the·C·type·<code>T*</code>).·This·means·that·if·you·have·extern·“C”	50	(i.e.·the·C·type·<code>T*</code>).·This·means·that·if·you·have·extern·“C”
51	Rust·functions·that·will·be·called·from·C,·you·can·define·those	51	Rust·functions·that·will·be·called·from·C,·you·can·define·those
52	Rust·functions·using·<code>Box<T></code>·types,·and·use·<code>T*</code>·as·corresponding	52	Rust·functions·using·<code>Box<T></code>·types,·and·use·<code>T*</code>·as·corresponding
53	type·on·the·C·side.·As·an·example,·consider·this·C·header·which	53	type·on·the·C·side.·As·an·example,·consider·this·C·header·which
Offset 96, 15 lines modified		Offset 96, 15 lines modified
96	<p>The·aliasing·rules·for·<code>Box<T></code>·are·the·same·as·for·<code>&mut·T</code>.·<code>Box<T></code>	96	<p>The·aliasing·rules·for·<code>Box<T></code>·are·the·same·as·for·<code>&mut·T</code>.·<code>Box<T></code>
97	asserts·uniqueness·over·its·content.·Using·raw·pointers·derived·from·a·box	97	asserts·uniqueness·over·its·content.·Using·raw·pointers·derived·from·a·box
98	after·that·box·has·been·mutated·through,·moved·or·borrowed·as·<code>&mut·T</code>	98	after·that·box·has·been·mutated·through,·moved·or·borrowed·as·<code>&mut·T</code>
99	is·not·allowed.·For·more·guidance·on·working·with·box·from·unsafe·code,·see	99	is·not·allowed.·For·more·guidance·on·working·with·box·from·unsafe·code,·see
100	<a·href="https://github.com/rust-lang/unsafe-code-guidelines/issues/326">rust-lang/unsafe-code-guidelines#326</a>.</p>	100	<a·href="https://github.com/rust-lang/unsafe-code-guidelines/issues/326">rust-lang/unsafe-code-guidelines#326</a>.</p>
101	<h2·id="editions"><a·class="doc-anchor"·href="#editions">§</a>Editions</h2>	101	<h2·id="editions"><a·class="doc-anchor"·href="#editions">§</a>Editions</h2>
102	<p>A·special·case·exists·for·the·implementation·of·<code>IntoIterator</code>·for·arrays·on·the·Rust·2021	102	<p>A·special·case·exists·for·the·implementation·of·<code>IntoIterator</code>·for·arrays·on·the·Rust·2021
103	edition,·as·documented·<a·href="../../core/primitive.array.html"·title="primitive·array">here</a>.·Unfortunately,·it·was·later·found·that·a·similar	103	edition,·as·documented·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.array.html"·title="primitive·array">here</a>.·Unfortunately,·it·was·later·found·that·a·similar
104	workaround·should·be·added·for·boxed·slices,·and·this·was·applied·in·the·2024·edition.</p>	104	workaround·should·be·added·for·boxed·slices,·and·this·was·applied·in·the·2024·edition.</p>
105	<p>Specifically,·<code>IntoIterator</code>·is·implemented·for·<code>Box<[T]></code>·on·all·editions,·but·specific·calls	105	<p>Specifically,·<code>IntoIterator</code>·is·implemented·for·<code>Box<[T]></code>·on·all·editions,·but·specific·calls
106	to·<code>into_iter()</code>·for·boxed·slices·will·defer·to·the·slice·implementation·on·editions·before	106	to·<code>into_iter()</code>·for·boxed·slices·will·defer·to·the·slice·implementation·on·editions·before
107	2024:</p>	107	2024:</p>

108	<div·class="example-wrap·edition"><a·href="#"·class="tooltip"·title="This·example·runs·with·edition·2021">ⓘ</a><pre·class="rust·rust-example-rendered"><code><span·class="comment">//·Rust·2015,·2018,·and·2021:	108	<div·class="example-wrap·edition"><a·href="#"·class="tooltip"·title="This·example·runs·with·edition·2021">ⓘ</a><pre·class="rust·rust-example-rendered"><code><span·class="comment">//·Rust·2015,·2018,·and·2021:


Offset 2, 15 lines modified		Offset 2, 15 lines modified
2	<p>This·module·provides·utilities·to·handle·data·across·non-Rust	2	<p>This·module·provides·utilities·to·handle·data·across·non-Rust
3	interfaces,·like·other·programming·languages·and·the·underlying	3	interfaces,·like·other·programming·languages·and·the·underlying
4	operating·system.·It·is·mainly·of·use·for·FFI·(Foreign·Function	4	operating·system.·It·is·mainly·of·use·for·FFI·(Foreign·Function
5	Interface)·bindings·and·code·that·needs·to·exchange·C-like·strings	5	Interface)·bindings·and·code·that·needs·to·exchange·C-like·strings
6	with·other·languages.</p>	6	with·other·languages.</p>
7	<h2·id="overview"><a·class="doc-anchor"·href="#overview">§</a>Overview</h2>	7	<h2·id="overview"><a·class="doc-anchor"·href="#overview">§</a>Overview</h2>
8	<p>Rust·represents·owned·strings·with·the·<a·href="../string/struct.String.html"·title="struct·alloc::string::String"><code>String</code></a>·type,·and	8	<p>Rust·represents·owned·strings·with·the·<a·href="../string/struct.String.html"·title="struct·alloc::string::String"><code>String</code></a>·type,·and
9	borrowed·slices·of·strings·with·the·<a·href="../../core/primitive.str.html"·title="primitive·str"><code>str</code></a>·primitive.·Both·are	9	borrowed·slices·of·strings·with·the·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.str.html"·title="primitive·str"><code>str</code></a>·primitive.·Both·are
10	always·in·UTF-8·encoding,·and·may·contain·nul·bytes·in·the·middle,	10	always·in·UTF-8·encoding,·and·may·contain·nul·bytes·in·the·middle,
11	i.e.,·if·you·look·at·the·bytes·that·make·up·the·string,·there·may	11	i.e.,·if·you·look·at·the·bytes·that·make·up·the·string,·there·may
12	be·a·<code>\0</code>·among·them.·Both·<code>String</code>·and·<code>str</code>·store·their·length	12	be·a·<code>\0</code>·among·them.·Both·<code>String</code>·and·<code>str</code>·store·their·length
13	explicitly;·there·are·no·nul·terminators·at·the·end·of·strings	13	explicitly;·there·are·no·nul·terminators·at·the·end·of·strings
14	like·in·C.</p>	14	like·in·C.</p>
15	<p>C·strings·are·different·from·Rust·strings:</p>	15	<p>C·strings·are·different·from·Rust·strings:</p>
16	<ul>	16	<ul>
Offset 23, 15 lines modified		Offset 23, 15 lines modified
23	<li>	23	<li>
24	<p><strong>Character·size</strong>·-·C·strings·may·use·<code>char</code>·or·<code>wchar_t</code>-sized	24	<p><strong>Character·size</strong>·-·C·strings·may·use·<code>char</code>·or·<code>wchar_t</code>-sized
25	characters;·please·<strong>note</strong>·that·C’s·<code>char</code>·is·different·from·Rust’s.	25	characters;·please·<strong>note</strong>·that·C’s·<code>char</code>·is·different·from·Rust’s.
26	The·C·standard·leaves·the·actual·sizes·of·those·types·open·to	26	The·C·standard·leaves·the·actual·sizes·of·those·types·open·to
27	interpretation,·but·defines·different·APIs·for·strings·made·up·of	27	interpretation,·but·defines·different·APIs·for·strings·made·up·of
28	each·character·type.·Rust·strings·are·always·UTF-8,·so·different	28	each·character·type.·Rust·strings·are·always·UTF-8,·so·different
29	Unicode·characters·will·be·encoded·in·a·variable·number·of·bytes	29	Unicode·characters·will·be·encoded·in·a·variable·number·of·bytes
30	each.·The·Rust·type·<a·href="../../core/primitive.char.html"·title="primitive·char"><code>char</code></a>·represents·a·‘[Unicode·scalar	30	each.·The·Rust·type·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.char.html"·title="primitive·char"><code>char</code></a>·represents·a·‘[Unicode·scalar
31	value]’,·which·is·similar·to,·but·not·the·same·as,·a·‘[Unicode	31	value]’,·which·is·similar·to,·but·not·the·same·as,·a·‘[Unicode
32	code·point]’.</p>	32	code·point]’.</p>
33	</li>	33	</li>
34	<li>	34	<li>
35	<p><strong>Nul·terminators·and·implicit·string·lengths</strong>·-·Often,·C	35	<p><strong>Nul·terminators·and·implicit·string·lengths</strong>·-·Often,·C
36	strings·are·nul-terminated,·i.e.,·they·have·a·<code>\0</code>·character·at·the	36	strings·are·nul-terminated,·i.e.,·they·have·a·<code>\0</code>·character·at·the
37	end.·The·length·of·a·string·buffer·is·not·stored,·but·has·to·be	37	end.·The·length·of·a·string·buffer·is·not·stored,·but·has·to·be
Offset 53, 30 lines modified		Offset 53, 30 lines modified
53	characters·in·the·middle·—·a·nul·character·would·essentially	53	characters·in·the·middle·—·a·nul·character·would·essentially
54	truncate·the·string.·Rust·strings·<em>can</em>·have·nul·characters·in	54	truncate·the·string.·Rust·strings·<em>can</em>·have·nul·characters·in
55	the·middle,·because·nul·does·not·have·to·mark·the·end·of·the	55	the·middle,·because·nul·does·not·have·to·mark·the·end·of·the
56	string·in·Rust.</p>	56	string·in·Rust.</p>
57	</li>	57	</li>
58	</ul>	58	</ul>
59	<h2·id="representations-of-non-rust-strings"><a·class="doc-anchor"·href="#representations-of-non-rust-strings">§</a>Representations·of·non-Rust·strings</h2>	59	<h2·id="representations-of-non-rust-strings"><a·class="doc-anchor"·href="#representations-of-non-rust-strings">§</a>Representations·of·non-Rust·strings</h2>
60	<p><a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·and·<a·href="../../core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr"><code>CStr</code></a>·are·useful·when·you·need·to·transfer	60	<p><a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·and·<a·href="https://doc.rust-lang.org/1.85.0/core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr"><code>CStr</code></a>·are·useful·when·you·need·to·transfer
61	UTF-8·strings·to·and·from·languages·with·a·C·ABI,·like·Python.</p>	61	UTF-8·strings·to·and·from·languages·with·a·C·ABI,·like·Python.</p>
62	<ul>	62	<ul>
63	<li>	63	<li>
64	<p><strong>From·Rust·to·C:</strong>·<a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·represents·an·owned,·C-friendly	64	<p><strong>From·Rust·to·C:</strong>·<a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·represents·an·owned,·C-friendly
65	string:·it·is·nul-terminated,·and·has·no·internal·nul·characters.	65	string:·it·is·nul-terminated,·and·has·no·internal·nul·characters.
66	Rust·code·can·create·a·<a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·out·of·a·normal·string·(provided	66	Rust·code·can·create·a·<a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·out·of·a·normal·string·(provided
67	that·the·string·doesn’t·have·nul·characters·in·the·middle),·and	67	that·the·string·doesn’t·have·nul·characters·in·the·middle),·and
68	then·use·a·variety·of·methods·to·obtain·a·raw·<code>*mut·<a·href="../../core/primitive.u8.html"·title="primitive·u8">u8</a></code>·that·can	68	then·use·a·variety·of·methods·to·obtain·a·raw·<code>*mut·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.u8.html"·title="primitive·u8">u8</a></code>·that·can
69	then·be·passed·as·an·argument·to·functions·which·use·the·C	69	then·be·passed·as·an·argument·to·functions·which·use·the·C
70	conventions·for·strings.</p>	70	conventions·for·strings.</p>
71	</li>	71	</li>
72	<li>	72	<li>
73	<p><strong>From·C·to·Rust:</strong>·<a·href="../../core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr"><code>CStr</code></a>·represents·a·borrowed·C·string;·it	73	<p><strong>From·C·to·Rust:</strong>·<a·href="https://doc.rust-lang.org/1.85.0/core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr"><code>CStr</code></a>·represents·a·borrowed·C·string;·it
74	is·what·you·would·use·to·wrap·a·raw·<code>*const·<a·href="../../core/primitive.u8.html"·title="primitive·u8">u8</a></code>·that·you·got·from	74	is·what·you·would·use·to·wrap·a·raw·<code>*const·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.u8.html"·title="primitive·u8">u8</a></code>·that·you·got·from
75	a·C·function.·A·<a·href="../../core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr"><code>CStr</code></a>·is·guaranteed·to·be·a·nul-terminated·array	75	a·C·function.·A·<a·href="https://doc.rust-lang.org/1.85.0/core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr"><code>CStr</code></a>·is·guaranteed·to·be·a·nul-terminated·array
76	of·bytes.·Once·you·have·a·<a·href="../../core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr"><code>CStr</code></a>,·you·can·convert·it·to·a·Rust	76	of·bytes.·Once·you·have·a·<a·href="https://doc.rust-lang.org/1.85.0/core/ffi/c_str/struct.CStr.html"·title="struct·core::ffi::c_str::CStr"><code>CStr</code></a>,·you·can·convert·it·to·a·Rust
77	<code>&<a·href="../../core/primitive.str.html"·title="primitive·str">str</a></code>·if·it’s·valid·UTF-8,·or·lossily·convert·it·by·adding	77	<code>&<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.str.html"·title="primitive·str">str</a></code>·if·it’s·valid·UTF-8,·or·lossily·convert·it·by·adding
78	replacement·characters.</p>	78	replacement·characters.</p>
79	</li>	79	</li>
80	</ul>	80	</ul>
81	</div></details><h2·id="modules"·class="section-header">Modules<a·href="#modules"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="mod"·href="c_str/index.html"·title="mod·alloc::ffi::c_str">c_str</a><wbr><span·class="stab·unstable"·title="">Experimental</span></div><div·class="desc·docblock-short"><a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·and·its·related·types.</div></li></ul><h2·id="structs"·class="section-header">Structs<a·href="#structs"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="struct"·href="struct.CString.html"·title="struct·alloc::ffi::CString">CString</a></div><div·class="desc·docblock-short">A·type·representing·an·owned,·C-compatible,·nul-terminated·string·with·no·nul·bytes·in·the	81	</div></details><h2·id="modules"·class="section-header">Modules<a·href="#modules"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="mod"·href="c_str/index.html"·title="mod·alloc::ffi::c_str">c_str</a><wbr><span·class="stab·unstable"·title="">Experimental</span></div><div·class="desc·docblock-short"><a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·and·its·related·types.</div></li></ul><h2·id="structs"·class="section-header">Structs<a·href="#structs"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="struct"·href="struct.CString.html"·title="struct·alloc::ffi::CString">CString</a></div><div·class="desc·docblock-short">A·type·representing·an·owned,·C-compatible,·nul-terminated·string·with·no·nul·bytes·in·the
82	middle.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.FromVecWithNulError.html"·title="struct·alloc::ffi::FromVecWithNulError">From<wbr>VecWith<wbr>NulError</a></div><div·class="desc·docblock-short">An·error·indicating·that·a·nul·byte·was·not·in·the·expected·position.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.IntoStringError.html"·title="struct·alloc::ffi::IntoStringError">Into<wbr>String<wbr>Error</a></div><div·class="desc·docblock-short">An·error·indicating·invalid·UTF-8·when·converting·a·<a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·into·a·<a·href="../string/struct.String.html"·title="struct·alloc::string::String"><code>String</code></a>.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.NulError.html"·title="struct·alloc::ffi::NulError">NulError</a></div><div·class="desc·docblock-short">An·error·indicating·that·an·interior·nul·byte·was·found.</div></li></ul></section></div></main></body></html>	82	middle.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.FromVecWithNulError.html"·title="struct·alloc::ffi::FromVecWithNulError">From<wbr>VecWith<wbr>NulError</a></div><div·class="desc·docblock-short">An·error·indicating·that·a·nul·byte·was·not·in·the·expected·position.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.IntoStringError.html"·title="struct·alloc::ffi::IntoStringError">Into<wbr>String<wbr>Error</a></div><div·class="desc·docblock-short">An·error·indicating·invalid·UTF-8·when·converting·a·<a·href="struct.CString.html"·title="struct·alloc::ffi::CString"><code>CString</code></a>·into·a·<a·href="../string/struct.String.html"·title="struct·alloc::string::String"><code>String</code></a>.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.NulError.html"·title="struct·alloc::ffi::NulError">NulError</a></div><div·class="desc·docblock-short">An·error·indicating·that·an·interior·nul·byte·was·found.</div></li></ul></section></div></main></body></html>


Offset 1, 2 lines modified		Offset 1, 2 lines modified
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="Derive·macro·generating·an·impl·of·the·trait·`Debug`."><title>Debug·in·alloc::fmt·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·derive"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>fmt</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">fmt</a></span><h1>Derive·Macro·<span·class="derive">Debug</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.38.0">1.38.0</span>···<a·class="src"·href="../../src/core/fmt/mod.rs.html#901">Source</a>·</span></div><pre·class="rust·item-decl"><code>#[derive(Debug)]</code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Derive·macro·generating·an·impl·of·the·trait·<code>Debug</code>.</p>	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="Derive·macro·generating·an·impl·of·the·trait·`Debug`."><title>Debug·in·alloc::fmt·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·derive"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>fmt</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">fmt</a></span><h1>Derive·Macro·<span·class="derive">Debug</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.38.0">1.38.0</span>···<a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/fmt/mod.rs.html#901">Source</a>·</span></div><pre·class="rust·item-decl"><code>#[derive(Debug)]</code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Derive·macro·generating·an·impl·of·the·trait·<code>Debug</code>.</p>
2	</div></details></section></div></main></body></html>	2	</div></details></section></div></main></body></html>


Offset 1, 9 lines modified		Offset 1, 9 lines modified
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="Takes·an·`Arguments`·struct·and·returns·the·resulting·formatted·string."><title>format·in·alloc::fmt·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built»from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">format</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>fmt</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">fmt</a></span><h1>Function·<span·class="fn">format</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0">1.36.0</span>···<a·class="src"·href="../../src/alloc/fmt.rs.html#644-655">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·format(args:·<a·class="struct"·href="struct.Arguments.html"·title="struct·alloc::fmt::Arguments">Arguments</a><'_>)·->·<a·class="struct"·href="../string/struct.String.html"·title="struct·alloc::string::String">String</a></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Takes·an·<a·href="struct.Arguments.html"·title="struct·alloc::fmt::Arguments"><code>Arguments</code></a>·struct·and·returns·the·resulting·formatted·string.</p>	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="Takes·an·`Arguments`·struct·and·returns·the·resulting·formatted·string."><title>format·in·alloc::fmt·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built»from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">format</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>fmt</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">fmt</a></span><h1>Function·<span·class="fn">format</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0">1.36.0</span>···<a·class="src"·href="../../src/alloc/fmt.rs.html#644-655">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·format(args:·<a·class="struct"·href="struct.Arguments.html"·title="struct·alloc::fmt::Arguments">Arguments</a><'_>)·->·<a·class="struct"·href="../string/struct.String.html"·title="struct·alloc::string::String">String</a></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Takes·an·<a·href="struct.Arguments.html"·title="struct·alloc::fmt::Arguments"><code>Arguments</code></a>·struct·and·returns·the·resulting·formatted·string.</p>
2	<p>The·<a·href="struct.Arguments.html"·title="struct·alloc::fmt::Arguments"><code>Arguments</code></a>·instance·can·be·created·with·the·<a·href="../../core/macro.format_args.html"·title="macro·core::format_args"><code>format_args!</code></a>·macro.</p>	2	<p>The·<a·href="struct.Arguments.html"·title="struct·alloc::fmt::Arguments"><code>Arguments</code></a>·instance·can·be·created·with·the·<a·href="https://doc.rust-lang.org/1.85.0/core/macro.format_args.html"·title="macro·core::format_args"><code>format_args!</code></a>·macro.</p>
3	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>	3	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>
4	<p>Basic·usage:</p>	4	<p>Basic·usage:</p>

5	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">use·</span>std::fmt;	5	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">use·</span>std::fmt;

6	<span·class="kw">let·</span>s·=·fmt::format(<span·class="macro">format_args!</span>(<span·class="string">"Hello,·{}!"</span>,·<span·class="string">"world"</span>));	6	<span·class="kw">let·</span>s·=·fmt::format(<span·class="macro">format_args!</span>(<span·class="string">"Hello,·{}!"</span>,·<span·class="string">"world"</span>));
7	<span·class="macro">assert_eq!</span>(s,·<span·class="string">"Hello,·world!"</span>);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++use+std::fmt;%0A++++%0A++++let+s+=+fmt::format(format_args!(%22Hello,+%7B%7D!%22,+%22world%22));%0A++++assert_eq!(s,+%22Hello,+world!%22);%0A%7D&edition=2021"></a></div>	7	<span·class="macro">assert_eq!</span>(s,·<span·class="string">"Hello,·world!"</span>);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++use+std::fmt;%0A++++%0A++++let+s+=+fmt::format(format_args!(%22Hello,+%7B%7D!%22,+%22world%22));%0A++++assert_eq!(s,+%22Hello,+world!%22);%0A%7D&edition=2021"></a></div>


Offset 6, 53 lines modified		Offset 6, 53 lines modified
6	-rw-r--r--···0·root·········(0)·root·········(0)·····9646·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/changelog.Debian.gz	6	-rw-r--r--···0·root·········(0)·root·········(0)·····9646·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/changelog.Debian.gz
7	-rw-r--r--···0·root·········(0)·root·········(0)···200493·2025-02-17·18:17:27.000000·./usr/share/doc/rust-doc/changelog.gz	7	-rw-r--r--···0·root·········(0)·root·········(0)···200493·2025-02-17·18:17:27.000000·./usr/share/doc/rust-doc/changelog.gz
8	-rw-r--r--···0·root·········(0)·root·········(0)···147750·2025-04-11·11:13:51.000000·./usr/share/doc/rust-doc/copyright	8	-rw-r--r--···0·root·········(0)·root·········(0)···147750·2025-04-11·11:13:51.000000·./usr/share/doc/rust-doc/copyright
9	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/	9	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/
10	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/	10	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/
11	-rw-r--r--···0·root·········(0)·root·········(0)····19767·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/all.html	11	-rw-r--r--···0·root·········(0)·root·········(0)····19767·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/all.html
12	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/	12	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/
13	-rw-r--r--···0·root·········(0)·root·········(0)·····6~~284~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.alloc.html	13	-rw-r--r--···0·root·········(0)·root·········(0)·····6338·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.alloc.html
14	-rw-r--r--···0·root·········(0)·root·········(0)·····6~~256~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.alloc_zeroed.html	14	-rw-r--r--···0·root·········(0)·root·········(0)·····6310·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.alloc_zeroed.html
15	-rw-r--r--···0·root·········(0)·root·········(0)·····4~~790~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.dealloc.html	15	-rw-r--r--···0·root·········(0)·root·········(0)·····4844·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.dealloc.html
16	-rw-r--r--···0·root·········(0)·root·········(0)·····5~~250~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.handle_alloc_error.html	16	-rw-r--r--···0·root·········(0)·root·········(0)·····5331·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.handle_alloc_error.html
17	-rw-r--r--···0·root·········(0)·root·········(0)·····5~~027~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.realloc.html	17	-rw-r--r--···0·root·········(0)·root·········(0)·····5162·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.realloc.html
18	-rw-r--r--···0·root·········(0)·root·········(0)·····7634·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/index.html	18	-rw-r--r--···0·root·········(0)·root·········(0)·····7634·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/index.html
19	-rw-r--r--···0·root·········(0)·root·········(0)······209·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/sidebar-items1.85.0.js	19	-rw-r--r--···0·root·········(0)·root·········(0)······209·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/sidebar-items1.85.0.js
20	-rw-r--r--···0·root·········(0)·root·········(0)····3~~6687~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.AllocError.html	20	-rw-r--r--···0·root·········(0)·root·········(0)····39819·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.AllocError.html
21	-rw-r--r--···0·root·········(0)·root·········(0)····~~38726~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.Global.html	21	-rw-r--r--···0·root·········(0)·root·········(0)····41507·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.Global.html
22	-rw-r--r--···0·root·········(0)·root·········(0)····6~~0068~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.Layout.html	22	-rw-r--r--···0·root·········(0)·root·········(0)····64172·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.Layout.html
23	-rw-r--r--···0·root·········(0)·root·········(0)····~~38552~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.LayoutError.html	23	-rw-r--r--···0·root·········(0)·root·········(0)····41684·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.LayoutError.html
24	-rw-r--r--···0·root·········(0)·root·········(0)····3~~3769~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/trait.Allocator.html	24	-rw-r--r--···0·root·········(0)·root·········(0)····35443·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/trait.Allocator.html
25	-rw-r--r--···0·root·········(0)·root·········(0)····2~~3991~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/trait.GlobalAlloc.html	25	-rw-r--r--···0·root·········(0)·root·········(0)····24720·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/trait.GlobalAlloc.html
26	-rw-r--r--···0·root·········(0)·root·········(0)·····4032·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/type.LayoutErr.html	26	-rw-r--r--···0·root·········(0)·root·········(0)·····4059·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/alloc/type.LayoutErr.html
27	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/	27	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/
28	-rw-r--r--···0·root·········(0)·root·········(0)···1~~76542~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/enum.Cow.html	28	-rw-r--r--···0·root·········(0)·root·········(0)···189313·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/enum.Cow.html
29	-rw-r--r--···0·root·········(0)·root·········(0)·····4648·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/index.html	29	-rw-r--r--···0·root·········(0)·root·········(0)·····4648·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/index.html
30	-rw-r--r--···0·root·········(0)·root·········(0)·······81·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/sidebar-items1.85.0.js	30	-rw-r--r--···0·root·········(0)·root·········(0)·······81·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/sidebar-items1.85.0.js
31	-rw-r--r--···0·root·········(0)·root·········(0)····2~~4771~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.Borrow.html	31	-rw-r--r--···0·root·········(0)·root·········(0)····25527·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.Borrow.html
32	-rw-r--r--···0·root·········(0)·root·········(0)····1~~1523~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.BorrowMut.html	32	-rw-r--r--···0·root·········(0)·root·········(0)····12009·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.BorrowMut.html
33	-rw-r--r--···0·root·········(0)·root·········(0)····14~~259~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.ToOwned.html	33	-rw-r--r--···0·root·········(0)·root·········(0)····14421·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.ToOwned.html
34	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/	34	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/
35	-rw-r--r--···0·root·········(0)·root·········(0)····18~~338~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/index.html	35	-rw-r--r--···0·root·········(0)·root·········(0)····18419·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/index.html
36	-rw-r--r--···0·root·········(0)·root·········(0)·······52·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/sidebar-items1.85.0.js	36	-rw-r--r--···0·root·········(0)·root·········(0)·······52·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/sidebar-items1.85.0.js
37	-rw-r--r--···0·root·········(0)·root·········(0)···5~~50960~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/struct.Box.html	37	-rw-r--r--···0·root·········(0)·root·········(0)···594187·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/struct.Box.html
38	-rw-r--r--···0·root·········(0)·root·········(0)····4~~3590~~·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/struct.ThinBox.html	38	-rw-r--r--···0·root·········(0)·root·········(0)····46668·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/struct.ThinBox.html
39	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/thin/	39	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/thin/
40	-rw-r--r--···0·root·········(0)·root·········(0)······432·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/thin/struct.ThinBox.html	40	-rw-r--r--···0·root·········(0)·root·········(0)······432·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/boxed/thin/struct.ThinBox.html
41	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/collections/	41	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/collections/
42	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/collections/binary_heap/	42	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/collections/binary_heap/
43	-rw-r--r--···0·root·········(0)·root·········(0)····19432·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/collections/binary_heap/index.html	43	-rw-r--r--···0·root·········(0)·root·········(0)····19432·2025-04-11·11:40:09.000000·./usr/share/doc/rust-doc/html/alloc/collections/binary_heap/index.html


Offset 1, 19 lines modified		Offset 1, 19 lines modified
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="The·`AllocError`·error·indicates·an·allocation·failure·that·may·be·due·to·resource·exhaustion·or·to·something·wrong·when·combining·the·given·input·arguments·with·this·allocator."><title>AllocError·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·struct"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a»source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Alloc<wbr>Error</a></h2><h3><a·href="#trait-implementations">Trait·Implementations</a></h3><ul·class="block·trait-implementation"><li><a·href="#impl-Clone-for-AllocError"·title="Clone">Clone</a></li><li><a·href="#impl-Copy-for-AllocError"·title="Copy">Copy</a></li><li><a·href="#impl-Debug-for-AllocError"·title="Debug">Debug</a></li><li><a·href="#impl-Display-for-AllocError"·title="Display">Display</a></li><li><a·href="#impl-Eq-for-AllocError"·title="Eq">Eq</a></li><li><a·href="#impl-Error-for-AllocError"·title="Error">Error</a></li><li><a·href="#impl-PartialEq-for-AllocError"·title="PartialEq">PartialEq</a></li><li><a·href="#impl-StructuralPartialEq-for-AllocError"·title="StructuralPartialEq">StructuralPartialEq</a></li></ul><h3><a·href="#synthetic-implementations">Auto·Trait·Implementations</a></h3><ul·class="block·synthetic-implementation"><li><a·href="#impl-Freeze-for-AllocError"·title="Freeze">Freeze</a></li><li><a·href="#impl-RefUnwindSafe-for-AllocError"·title="RefUnwindSafe">RefUnwindSafe</a></li><li><a·href="#impl-Send-for-AllocError"·title="Send">Send</a></li><li><a·href="#impl-Sync-for-AllocError"·title="Sync">Sync</a></li><li><a·href="#impl-Unpin-for-AllocError"·title="Unpin">Unpin</a></li><li><a·href="#impl-UnwindSafe-for-AllocError"·title="UnwindSafe">UnwindSafe</a></li></ul><h3><a·href="#blanket-implementations">Blanket·Implementations</a></h3><ul·class="block·blanket-implementation"><li><a·href="#impl-Any-for-T"·title="Any">Any</a></li><li><a·href="#impl-Borrow%3CT%3E-for-T"·title="Borrow<T>">Borrow<T></a></li><li><a·href="#impl-BorrowMut%3CT%3E-for-T"·title="BorrowMut<T>">BorrowMut<T></a></li><li><a·href="#impl-CloneToUninit-for-T"·title="CloneToUninit">CloneToUninit</a></li><li><a·href="#impl-From%3CT%3E-for-T"·title="From<T>">From<T></a></li><li><a·href="#impl-Into%3CU%3E-for-T"·title="Into<U>">Into<U></a></li><li><a·href="#impl-ToOwned-for-T"·title="ToOwned">ToOwned</a></li><li><a·href="#impl-ToString-for-T"·title="ToString">ToString</a></li><li><a·href="#impl-TryFrom%3CU%3E-for-T"·title="TryFrom<U>">TryFrom<U></a></li><li><a·href="#impl-TryInto%3CU%3E-for-T"·title="TryInto<U>">TryInto<U></a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Struct·<span·class="struct">AllocError</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="../../src/core/alloc/mod.rs.html#32">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·struct·AllocError;</code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>The·<code>AllocError</code>·error·indicates·an·allocation·failure	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="The·`AllocError`·error·indicates·an·allocation·failure·that·may·be·due·to·resource·exhaustion·or·to·something·wrong·when·combining·the·given·input·arguments·with·this·allocator."><title>AllocError·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·struct"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a»source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Alloc<wbr>Error</a></h2><h3><a·href="#trait-implementations">Trait·Implementations</a></h3><ul·class="block·trait-implementation"><li><a·href="#impl-Clone-for-AllocError"·title="Clone">Clone</a></li><li><a·href="#impl-Copy-for-AllocError"·title="Copy">Copy</a></li><li><a·href="#impl-Debug-for-AllocError"·title="Debug">Debug</a></li><li><a·href="#impl-Display-for-AllocError"·title="Display">Display</a></li><li><a·href="#impl-Eq-for-AllocError"·title="Eq">Eq</a></li><li><a·href="#impl-Error-for-AllocError"·title="Error">Error</a></li><li><a·href="#impl-PartialEq-for-AllocError"·title="PartialEq">PartialEq</a></li><li><a·href="#impl-StructuralPartialEq-for-AllocError"·title="StructuralPartialEq">StructuralPartialEq</a></li></ul><h3><a·href="#synthetic-implementations">Auto·Trait·Implementations</a></h3><ul·class="block·synthetic-implementation"><li><a·href="#impl-Freeze-for-AllocError"·title="Freeze">Freeze</a></li><li><a·href="#impl-RefUnwindSafe-for-AllocError"·title="RefUnwindSafe">RefUnwindSafe</a></li><li><a·href="#impl-Send-for-AllocError"·title="Send">Send</a></li><li><a·href="#impl-Sync-for-AllocError"·title="Sync">Sync</a></li><li><a·href="#impl-Unpin-for-AllocError"·title="Unpin">Unpin</a></li><li><a·href="#impl-UnwindSafe-for-AllocError"·title="UnwindSafe">UnwindSafe</a></li></ul><h3><a·href="#blanket-implementations">Blanket·Implementations</a></h3><ul·class="block·blanket-implementation"><li><a·href="#impl-Any-for-T"·title="Any">Any</a></li><li><a·href="#impl-Borrow%3CT%3E-for-T"·title="Borrow<T>">Borrow<T></a></li><li><a·href="#impl-BorrowMut%3CT%3E-for-T"·title="BorrowMut<T>">BorrowMut<T></a></li><li><a·href="#impl-CloneToUninit-for-T"·title="CloneToUninit">CloneToUninit</a></li><li><a·href="#impl-From%3CT%3E-for-T"·title="From<T>">From<T></a></li><li><a·href="#impl-Into%3CU%3E-for-T"·title="Into<U>">Into<U></a></li><li><a·href="#impl-ToOwned-for-T"·title="ToOwned">ToOwned</a></li><li><a·href="#impl-ToString-for-T"·title="ToString">ToString</a></li><li><a·href="#impl-TryFrom%3CU%3E-for-T"·title="TryFrom<U>">TryFrom<U></a></li><li><a·href="#impl-TryInto%3CU%3E-for-T"·title="TryInto<U>">TryInto<U></a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Struct·<span·class="struct">AllocError</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/alloc/mod.rs.html#32">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·struct·AllocError;</code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>The·<code>AllocError</code>·error·indicates·an·allocation·failure
2	that·may·be·due·to·resource·exhaustion·or·to	2	that·may·be·due·to·resource·exhaustion·or·to
3	something·wrong·when·combining·the·given·input·arguments·with·this	3	something·wrong·when·combining·the·given·input·arguments·with·this
4	allocator.</p>	4	allocator.</p>
5	</div></details><h2·id="trait-implementations"·class="section-header">Trait·Implementations<a·href="#trait-implementations"·class="anchor">§</a></h2><div·id="trait-implementations-list"><details·class="toggle·implementors-toggle"·open><summary><section·id="impl-Clone-for-AllocError"·class="impl"><a·class="src·rightside"·href="../../src/core/alloc/mod.rs.html#31">Source</a><a·href="#impl-Clone-for-AllocError"·class="anchor">§</a><h3·class="code-header">impl·<a·class="trait"·href="~~../../core~~/clone/trait.Clone.~~html"·title="trait·~~core::clone::~~Clone">~~Clone</~~a>·for~~·<~~a·c~~lass="str~~uct~~"·[·...·truncated·by·diffoscope;·len:·1~~0203~~,·SHA:·92~~3343a~~2f~~6d7~~05~~1d2~~b~~32d~~a~~388~~3~~1fc20~~4e3a~~670a~~f~~4c9ccac~~a~~1d5a5f06ad6d8122~~·...·]/core/primitive.bool.html">bool</a></h4></section></summary><div·class='docblock'>Tests·for·<code>!=</code>.·The·default·implementation·is·almost·always·sufficient,	5	</div></details><h2·id="trait-implementations"·class="section-header">Trait·Implementations<a·href="#trait-implementations"·class="anchor">§</a></h2><div·id="trait-implementations-list"><details·class="toggle·implementors-toggle"·open><summary><section·id="impl-Clone-for-AllocError"·class="impl"><a·class="src·rightside"·href="https://doc.rust-lang.org/1.85.0/src/core/alloc/mod.rs.html#31">Source</a><a·href="#impl-Clone-for-AllocError"·class="anchor">§</a><h3·class="code-header">impl·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/clone/trait.Clone.html"·title="trai[·...·truncated·by·diffoscope;·len:·11391,·SHA:·860c92f3190970b769a4f1b736ce3f554eadb53f87a233aa32c7e3cdc4feeea1·...·]/core/primitive.bool.html">bool</a></h4></section></summary><div·class='docblock'>Tests·for·<code>!=</code>.·The·default·implementation·is·almost·always·sufficient,
6	and·should·not·be·overridden·without·very·good·reason.</div></details></div></details><section·id="impl-Copy-for-AllocError"·class="impl"><a·class="src·rightside"·href="../../src/core/alloc/mod.rs.html#31">Source</a><a·href="#impl-Copy-for-AllocError"·class="anchor">§</a><h3·class="code-header">impl·<a·class="trait"·href="~~../../core~~/~~marker~~/tr~~ait~~.~~Copy.h~~tml~~"·title="trait·~~core::marker:~~:Copy">~~Copy</~~a>·for~~·<~~a·c~~lass="struct~~"·hr~~[·...·truncated·by·diffoscope;·len:·~~3969~~,·SHA:·~~b17~~2~~bbc10~~f8b5dedce3~~6de~~3e413a~~1f8~~a4d9de9~~61161~~6a4214bf3~~6fd1~~8~~f0a756b~~·...·]/core/any/trait.Any.html"·title="trait·core::any::Any">Any</a>·for·T<div·class="where">where	6	and·should·not·be·overridden·without·very·good·reason.</div></details></div></details><section·id="impl-Copy-for-AllocError"·class="impl"><a·class="src·rightside"·href="https://doc.rust-lang.org/1.85.0/src/core/alloc/mod.rs.html#31">Source</a><a·href="#impl-Copy-for-AllocError"·class="anchor">§</a><h3·class="code-header">impl·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Copy.html"·title="trait[·...·truncated·by·diffoscope;·len:·4347,·SHA:·e04012df9e8f38b0f8d88db5359b38421a65faeb9c605e935d3d8674a4386fcc·...·]/core/any/trait.Any.html"·title="trait·core::any::Any">Any</a>·for·T<div·class="where">where
7	····T:·'static·+·?<a·class="trait"·href="../../core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.type_id"·class="method~~·trait-impl"><a·class="src·~~[·...·truncated·by·diffoscope;·len:·~~672~~,·SHA:·ac~~e7a0599717~~4~~5d739c5a~~bd98~~21e~~5d1d485cc2~~33f~~d4~~215~~0~~ceb~~251~~bdea1c~~e6bf7·...·]/src/core/borrow.rs.html#209">Source</a><a·href="#impl-Borrow%3CT%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.Borrow.html"·title="trait·alloc::borrow::Borrow">Borrow</a><T>·for·T<div·class="where">where	7	····T:·'static·+·?<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.type_id"·class="method[·...·truncated·by·diffoscope;·len:·834,·SHA:·88c662bd34d0f4e861f64cb8fb1d4f857b52c68d17802862f81ca7539e73b64a·...·]/src/core/borrow.rs.html#209">Source</a><a·href="#impl-Borrow%3CT%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.Borrow.html"·title="trait·alloc::borrow::Borrow">Borrow</a><T>·for·T<div·class="where">where
8	····T:·?<a·class="trait"·href="../../core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.borrow"·class="method~~·trait-impl"><a·class="src~~·r[·...·truncated·by·diffoscope;·len:·~~629~~,·SHA:·8e~~6f5d~~2e~~4a2830729~~c5d4~~9545911~~3ca~~6f54993696d~~7dc71c1~~f46e~~5691~~f5108ed~~·...·]/src/core/borrow.rs.html#217">Source</a><a·href="#impl-BorrowMut%3CT%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.BorrowMut.html"·title="trait·alloc::borrow::BorrowMut">BorrowMut</a><T>·for·T<div·class="where">where	8	····T:·?<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.borrow"·class="method·[·...·truncated·by·diffoscope;·len:·737,·SHA:·e938e2977e0c43ec3e427def9c33adb01edb85207cc1315a205186e91c1f232b·...·]/src/core/borrow.rs.html#217">Source</a><a·href="#impl-BorrowMut%3CT%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.BorrowMut.html"·title="trait·alloc::borrow::BorrowMut">BorrowMut</a><T>·for·T<div·class="where">where
9	····T:·?<a·class="trait"·href="../../core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.borrow_mut"·class="me~~thod·trai~~t~~-impl"><a·class="s~~[·...·truncated·by·diffoscope;·len:·~~819~~,·SHA:·3ca215d8~~7d373~~b~~e2977~~4f~~ff31d75c216~~0~~34e4a~~a910e~~49de0e3fc~~5~~b88~~c46bc387·...·]/core/clone/trait.CloneToUninit.html"·title="trait·core::clone::CloneToUninit">CloneToUninit</a>·for·T<div·class="where">where	9	····T:·?<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.borrow_mut"·class="met[·...·truncated·by·diffoscope;·len:·954,·SHA:·312353ef26ba481a4b52a70beb9d0c9fefa1ef6cb98abb54a2c56eb333d9f133·...·]/core/clone/trait.CloneToUninit.html"·title="trait·core::clone::CloneToUninit">CloneToUninit</a>·for·T<div·class="where">where
10	····T:·<a·class="trait"·href="../../core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.clone_to_uninit"·class=~~"method·trait-impl~~"~~><a·class~~[·...·truncated·by·diffoscope;·len:·1613,·SHA:·593~~89e90f0a0~~d91f~~421d279eda~~717d~~9ad82cd97e00~~f~~1c482c8e2e8~~1a51360238·...·]/core/convert/trait.From.html#tymethod.from"·class="fn">from</a>(t:·T)·->·T</h4></section></summary><div·class="docblock"><p>Returns·the·argument·unchanged.</p>	10	····T:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.clone_to_uninit"·class="[·...·truncated·by·diffoscope;·len:·1883,·SHA:·84530d34a853fd08f907338c37f7cdc67abee3ba64f4b257f343c41b501b3606·...·]/core/convert/trait.From.html#tymethod.from"·class="fn">from</a>(t:·T)·->·T</h4></section></summary><div·class="docblock"><p>Returns·the·argument·unchanged.</p>
11	</div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-Into%3CU%3E-for-T"·class="impl"><a·class="src·rightside"·href="../../src/core/convert/mod.rs.html#750-752">Source</a><a·href="#impl-Into%3CU%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T,·U>·<a·class="trait"·href="../../core/convert/trait.Into.html"·title="trait·core::convert::Into">Into</a><U>·for·T<div·class="where">where	11	</div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-Into%3CU%3E-for-T"·class="impl"><a·class="src·rightside"·href="https://doc.rust-lang.org/1.85.0/src/core/convert/mod.rs.html#750-752">Source</a><a·href="#impl-Into%3CU%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T,·U>·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.Into.html"·title="trait·core::convert::Into">Into</a><U>·for·T<div·class="where">where
12	····U:·<a·class="trait"·href="../../core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.into"·class="~~method·trait-i~~m~~pl"><a·class=~~[·...·truncated·by·diffoscope;·len:·~~156~~,·SHA:·~~f5090~~3~~482545~~5174cf2162343c6~~bdde8e~~e~~f56~~98c1b~~10053~~1~~d75d18324~~cfe~~7fd1~~·...·]/core/convert/trait.Into.html#tymethod.into"·class="fn">into</a>(self)·->·U</h4></section></summary><div·class="docblock"><p>Calls·<code>U::from(self)</code>.</p>	12	····U:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.into"·class="m[·...·truncated·by·diffoscope;·len:·237,·SHA:·8bb1e3b1393e5d341bc2152ab6439fd0edcc9481bf3dd414f444b6a8cde3b77c·...·]/core/convert/trait.Into.html#tymethod.into"·class="fn">into</a>(self)·->·U</h4></section></summary><div·class="docblock"><p>Calls·<code>U::from(self)</code>.</p>
13	<p>That·is,·this·conversion·is·whatever·the·implementation·of	13	<p>That·is,·this·conversion·is·whatever·the·implementation·of
14	<code><a·href="../../core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>·for·U</code>·chooses·to·do.</p>	14	<code><a·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>·for·U</code>·chooses·to·do.</p>
15	</div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToOwned-for-T"·class="impl"><a·class="src·rightside"·href="../../src/alloc/borrow.rs.html#82-94">Source</a><a·href="#impl-ToOwned-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.ToOwned.html"·title="trait·alloc::borrow::ToOwned">ToOwned</a>·for·T<div·class="where">where	15	</div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToOwned-for-T"·class="impl"><a·class="src·rightside"·href="../../src/alloc/borrow.rs.html#82-94">Source</a><a·href="#impl-ToOwned-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.ToOwned.html"·title="trait·alloc::borrow::ToOwned">ToOwned</a>·for·T<div·class="where">where
16	····T:·<a·class="trait"·href="../../core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Owned"·class="associatedtype·~~trai~~t~~-impl"><a·class="src·ri~~[·...·truncated·by·diffoscope;·len:·1~~296~~,·SHA:·88285b~~d52e5f5ad~~6~~b3e1b6d~~101~~339~~a~~b4047bdbd~~5~~b9d~~568c1e216~~b159c~~f172~~96e~~·...·]/core/primitive.reference.html">&mut·T</a>)</h4></section></summary><div·class='docblock'>Uses·borrowed·data·to·replace·owned·data,·usually·by·cloning.·<a·href="../borrow/trait.ToOwned.html#method.clone_into">Read·more</a></div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToString-for-T"·class="impl"><a·class="src·rightside"·href="../../src/alloc/string.rs.html#2677-2682">Source</a><a·href="#impl-ToString-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../string/trait.ToString.html"·title="trait·alloc::string::ToString">ToString</a>·for·T<div·class="where">where	16	····T:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Owned"·class="associatedtype·t[·...·truncated·by·diffoscope;·len:·1350,·SHA:·6292f017b63383ee7761872e921519af0a69e7cacc46522756c1426ad3e4fff2·...·]/core/primitive.reference.html">&mut·T</a>)</h4></section></summary><div·class='docblock'>Uses·borrowed·data·to·replace·owned·data,·usually·by·cloning.·<a·href="../borrow/trait.ToOwned.html#method.clone_into">Read·more</a></div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToString-for-T"·class="impl"><a·class="src·rightside"·href="../../src/alloc/string.rs.html#2677-2682">Source</a><a·href="#impl-ToString-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../string/trait.ToString.html"·title="trait·alloc::string::ToString">ToString</a>·for·T<div·class="where">where
17	····T:·<a·class="trait"·href="../fmt/trait.Display.html"·title="trait·alloc::fmt::Display">Display</a>·+·?<a·class="trait"·href="../../core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.to_string"·class="meth~~od·trait-impl"><a·class="sr~~[·...·truncated·by·diffoscope;·len:·~~867~~,·SHA:·~~70ede3da~~0126aa79~~c1e0f~~573~~662~~d~~9e9749~~7ba5~~165d6f~~7~~f0b3~~0~~9165552502b702~~·...·]/core/convert/trait.TryFrom.html"·title="trait·core::convert::TryFrom">TryFrom</a><U>·for·T<div·class="where">where	17	····T:·<a·class="trait"·href="../fmt/trait.Display.html"·title="trait·alloc::fmt::Display">Display</a>·+·?<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.to_string"·class="meth[·...·truncated·by·diffoscope;·len:·948,·SHA:·e5659d69042eae24d3539fbd444a36c786d5392f897d4d55c05e77819de0d4ee·...·]/core/convert/trait.TryFrom.html"·title="trait·core::convert::TryFrom">TryFrom</a><U>·for·T<div·class="where">where
18	····U:·<a·class="trait"·href="../../core/convert/trait.Into.html"·title="trait·core::convert::Into">Into</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Error-1"·class="asso~~ciatedtype·trait-impl"><a·c~~[·...·truncated·by·diffoscope;·len:·1676,·SHA:·a~~f8e86ce~~a~~46b~~e74e76~~8c31~~f24e~~4797~~0~~91af~~37956e3369bd739e3ea029~~7db774d~~·...·]/core/convert/trait.TryInto.html"·title="trait·core::convert::TryInto">TryInto</a><U>·for·T<div·class="where">where	18	····U:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.Into.html"·title="trait·core::convert::Into">Into</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Error-1"·class="asso[·...·truncated·by·diffoscope;·len:·1973,·SHA:·7ab179d200af2e2eb047369195f0dee05405e7736255d5d68ea309b71a353089·...·]/core/convert/trait.TryInto.html"·title="trait·core::convert::TryInto">TryInto</a><U>·for·T<div·class="where">where
19	····U:·<a·class="trait"·href="../../core/convert/trait.TryFrom.html"·title="trait·core::convert::TryFrom">TryFrom</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Error"·cl~~ass="~~ass~~ociatedtype·trait-imp~~[·...·truncated·by·diffoscope;·len:·1308,·SHA:·a3e64823~~adb~~41893b~~d55~~ef~~22ffa~~3a~~7f3~~7~~ba6a7e~~dfa~~9239~~c~~bb0a1d8abd~~8~~e7a200~~·...·]/core/convert/trait.TryFrom.html#associatedtype.Error"·title="type·core::convert::TryFrom::Error">Error</a>></h4></section></summary><div·class='docblock'>Performs·the·conversion.</div></details></div></details></div></section></div></main></body></html>	19	····U:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.TryFrom.html"·title="trait·core::convert::TryFrom">TryFrom</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Error"·clas[·...·truncated·by·diffoscope;·len:·1578,·SHA:·f0c8a59634f23f274c0b0f802e636ba728e5f2dfa00f5c4489547ff486a17653·...·]/core/convert/trait.TryFrom.html#associatedtype.Error"·title="type·core::convert::TryFrom::Error">Error</a>></h4></section></summary><div·class='docblock'>Performs·the·conversion.</div></details></div></details></div></section></div></main></body></html>


Offset 1, 36 lines modified		Offset 1, 36 lines modified
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="The·global·memory·allocator."><title>Global·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·struct"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4»2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Global</a></h2><h3><a·href="#trait-implementations">Trait·Implementations</a></h3><ul·class="block·trait-implementation"><li><a·href="#impl-Allocator-for-Global"·title="Allocator">Allocator</a></li><li><a·href="#impl-Clone-for-Global"·title="Clone">Clone</a></li><li><a·href="#impl-Copy-for-Global"·title="Copy">Copy</a></li><li><a·href="#impl-Debug-for-Global"·title="Debug">Debug</a></li><li><a·href="#impl-Default-for-Global"·title="Default">Default</a></li><li><a·href="#impl-DispatchFromDyn%3CBox%3CU%3E%3E-for-Box%3CT%3E"·title="DispatchFromDyn<Box<U>>">DispatchFromDyn<Box<U>></a></li></ul><h3><a·href="#synthetic-implementations">Auto·Trait·Implementations</a></h3><ul·class="block·synthetic-implementation"><li><a·href="#impl-Freeze-for-Global"·title="Freeze">Freeze</a></li><li><a·href="#impl-RefUnwindSafe-for-Global"·title="RefUnwindSafe">RefUnwindSafe</a></li><li><a·href="#impl-Send-for-Global"·title="Send">Send</a></li><li><a·href="#impl-Sync-for-Global"·title="Sync">Sync</a></li><li><a·href="#impl-Unpin-for-Global"·title="Unpin">Unpin</a></li><li><a·href="#impl-UnwindSafe-for-Global"·title="UnwindSafe">UnwindSafe</a></li></ul><h3><a·href="#blanket-implementations">Blanket·Implementations</a></h3><ul·class="block·blanket-implementation"><li><a·href="#impl-Any-for-T"·title="Any">Any</a></li><li><a·href="#impl-Borrow%3CT%3E-for-T"·title="Borrow<T>">Borrow<T></a></li><li><a·href="#impl-BorrowMut%3CT%3E-for-T"·title="BorrowMut<T>">BorrowMut<T></a></li><li><a·href="#impl-CloneToUninit-for-T"·title="CloneToUninit">CloneToUninit</a></li><li><a·href="#impl-From%3CT%3E-for-T"·title="From<T>">From<T></a></li><li><a·href="#impl-Into%3CU%3E-for-T"·title="Into<U>">Into<U></a></li><li><a·href="#impl-ToOwned-for-T"·title="ToOwned">ToOwned</a></li><li><a·href="#impl-TryFrom%3CU%3E-for-T"·title="TryFrom<U>">TryFrom<U></a></li><li><a·href="#impl-TryInto%3CU%3E-for-T"·title="TryInto<U>">TryInto<U></a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Struct·<span·class="struct">Global</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="../../src/alloc/alloc.rs.html#50">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·struct·Global;</code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>The·global·memory·allocator.</p>	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="The·global·memory·allocator."><title>Global·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·struct"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4»2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Global</a></h2><h3><a·href="#trait-implementations">Trait·Implementations</a></h3><ul·class="block·trait-implementation"><li><a·href="#impl-Allocator-for-Global"·title="Allocator">Allocator</a></li><li><a·href="#impl-Clone-for-Global"·title="Clone">Clone</a></li><li><a·href="#impl-Copy-for-Global"·title="Copy">Copy</a></li><li><a·href="#impl-Debug-for-Global"·title="Debug">Debug</a></li><li><a·href="#impl-Default-for-Global"·title="Default">Default</a></li><li><a·href="#impl-DispatchFromDyn%3CBox%3CU%3E%3E-for-Box%3CT%3E"·title="DispatchFromDyn<Box<U>>">DispatchFromDyn<Box<U>></a></li></ul><h3><a·href="#synthetic-implementations">Auto·Trait·Implementations</a></h3><ul·class="block·synthetic-implementation"><li><a·href="#impl-Freeze-for-Global"·title="Freeze">Freeze</a></li><li><a·href="#impl-RefUnwindSafe-for-Global"·title="RefUnwindSafe">RefUnwindSafe</a></li><li><a·href="#impl-Send-for-Global"·title="Send">Send</a></li><li><a·href="#impl-Sync-for-Global"·title="Sync">Sync</a></li><li><a·href="#impl-Unpin-for-Global"·title="Unpin">Unpin</a></li><li><a·href="#impl-UnwindSafe-for-Global"·title="UnwindSafe">UnwindSafe</a></li></ul><h3><a·href="#blanket-implementations">Blanket·Implementations</a></h3><ul·class="block·blanket-implementation"><li><a·href="#impl-Any-for-T"·title="Any">Any</a></li><li><a·href="#impl-Borrow%3CT%3E-for-T"·title="Borrow<T>">Borrow<T></a></li><li><a·href="#impl-BorrowMut%3CT%3E-for-T"·title="BorrowMut<T>">BorrowMut<T></a></li><li><a·href="#impl-CloneToUninit-for-T"·title="CloneToUninit">CloneToUninit</a></li><li><a·href="#impl-From%3CT%3E-for-T"·title="From<T>">From<T></a></li><li><a·href="#impl-Into%3CU%3E-for-T"·title="Into<U>">Into<U></a></li><li><a·href="#impl-ToOwned-for-T"·title="ToOwned">ToOwned</a></li><li><a·href="#impl-TryFrom%3CU%3E-for-T"·title="TryFrom<U>">TryFrom<U></a></li><li><a·href="#impl-TryInto%3CU%3E-for-T"·title="TryInto<U>">TryInto<U></a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Struct·<span·class="struct">Global</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="../../src/alloc/alloc.rs.html#50">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·struct·Global;</code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>The·global·memory·allocator.</p>
2	<p>This·type·implements·the·<a·href="trait.Allocator.html"·title="trait·alloc::alloc::Allocator"><code>Allocator</code></a>·trait·by·forwarding·calls	2	<p>This·type·implements·the·<a·href="trait.Allocator.html"·title="trait·alloc::alloc::Allocator"><code>Allocator</code></a>·trait·by·forwarding·calls
3	to·the·allocator·registered·with·the·<code>#[global_allocator]</code>·attribute	3	to·the·allocator·registered·with·the·<code>#[global_allocator]</code>·attribute
4	if·there·is·one,·or·the·<code>std</code>·crate’s·default.</p>	4	if·there·is·one,·or·the·<code>std</code>·crate’s·default.</p>
5	<p>Note:·while·this·type·is·unstable,·the·functionality·it·provides·can·be	5	<p>Note:·while·this·type·is·unstable,·the·functionality·it·provides·can·be
6	accessed·through·the·<a·href="index.html#functions"·title="mod·alloc::alloc">free·functions·in·<code>alloc</code></a>.</p>	6	accessed·through·the·<a·href="index.html#functions"·title="mod·alloc::alloc">free·functions·in·<code>alloc</code></a>.</p>
7	</div></details><h2·id="trait-implementations"·class="section-header">Trait·Implementations<a·href="#trait-implementations"·class="anchor">§</a></h2><div·id="trait-implementations-list"><details·class="toggle·implementors-toggle"·open><summary><section·id="impl-Allocator-for-Global"·class="impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#250-340">Source</a><a·href="#impl-Allocator-for-Global"·class="anchor">§</a><h3·class="code-header">impl·<a·class="trait"·href="trait.Allocator.html"·title="trait·alloc::alloc::Allocator">Allocator</a>·for·<a·class="struct"·href="struct.Global.html"·title="struct·alloc::alloc::Global">Global</a></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.allocate"·class="method·trait-impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#253-255">Source</a><a·href="#method.allocate"·class="anchor">§</a><h4·class="code-header">fn·<a·href="trait.Allocator.html#tymethod.allocate"·class="fn">allocate</a>(&self,·layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>)·->·<a·class="enum"·href="../../core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="../../core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu~~ll</a><[<a·class="primitive"·href="../../core/primi~~[·...·truncated·by·diffoscope;·len:·2~~436~~,·SHA:·e6a58~~acea26~~4b~~ec52cc0~~52b~~f8bb4~~4~~7ddb5~~8554756~~a2afb7~~4~~8a57e3743d47~~e0c4·...·]/core/primitive.u8.html">u8</a>>,·layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>)</h4></section></summary><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><div·class='docblock'>Deallocates·the·memory·referenced·by·<code>ptr</code>.·<a·href="trait.Allocator.html#tymethod.deallocate">Read·more</a></div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.grow"·class="method·trait-impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#275-283">Source</a><a·href="#method.grow"·class="anchor">§</a><h4·class="code-header">unsafe·fn·<a·href="trait.Allocator.html#method.grow"·class="fn">grow</a>(	7	</div></details><h2·id="trait-implementations"·class="section-header">Trait·Implementations<a·href="#trait-implementations"·class="anchor">§</a></h2><div·id="trait-implementations-list"><details·class="toggle·implementors-toggle"·open><summary><section·id="impl-Allocator-for-Global"·class="impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#250-340">Source</a><a·href="#impl-Allocator-for-Global"·class="anchor">§</a><h3·class="code-header">impl·<a·class="trait"·href="trait.Allocator.html"·title="trait·alloc::alloc::Allocator">Allocator</a>·for·<a·class="struct"·href="struct.Global.html"·title="struct·alloc::alloc::Global">Global</a></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.allocate"·class="method·trait-impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#253-255">Source</a><a·href="#method.allocate"·class="anchor">§</a><h4·class="code-header">fn·<a·href="trait.Allocator.html#tymethod.allocate"·class="fn">allocate</a>(&self,·layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>)·->·<a·class="enum"·href="https://doc.rust-lang.org/1.85.0/core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu[·...·truncated·by·diffoscope;·len:·2652,·SHA:·c5625189e663849b91ae4a25124b5b18f4c8e378424e169d544092d8a1296ce1·...·]/core/primitive.u8.html">u8</a>>,·layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>)</h4></section></summary><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><div·class='docblock'>Deallocates·the·memory·referenced·by·<code>ptr</code>.·<a·href="trait.Allocator.html#tymethod.deallocate">Read·more</a></div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.grow"·class="method·trait-impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#275-283">Source</a><a·href="#method.grow"·class="anchor">§</a><h4·class="code-header">unsafe·fn·<a·href="trait.Allocator.html#method.grow"·class="fn">grow</a>(
8	····&self,	8	····&self,
9	····ptr:·<a·class="struct"·href="../../core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNull</a><<a·class="primitive"·href="../../core/primitive.u8.html">u8</a>>,	9	····ptr:·<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNull</a><<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.u8.html">u8</a>>,
10	····old_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,	10	····old_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,
11	····new_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,	11	····new_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,
12	)·->·<a·class="enum"·href="../../core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="../../core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu~~ll</a>&l~~t~~;[<a~~·cla~~ss="primitiv~~e~~"·hr~~e~~f="~~..~~/..~~/core/primitive.u8.html">u8</a>]>,·<a·class="struct"·href="struct.AllocError.html"·title="struct·alloc::alloc::AllocError">AllocError</a>></h4></section></summary><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><div·class='docblock'>Attempts·to·extend·the·memory·block.·<a·href="trait.Allocator.html#method.grow">Read·more</a></div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.grow_zeroed"·class="method·trait-impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#287-295">Source</a><a·href="#method.grow_zeroed"·class="anchor">§</a><h4·class="code-header">unsafe·fn·<a·href="trait.Allocator.html#method.grow_zeroed"·class="fn">grow_zeroed</a>(	12	)·->·<a·class="enum"·href="https://doc.rust-lang.org/1.85.0/core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu[·...·truncated·by·diffoscope;·len:·70,·SHA:·b59d686d84d7b0b29d9d9baa499f050c97869a74e85d8a6bc3ad3a537e79049a·...·]/core/primitive.u8.html">u8</a>]>,·<a·class="struct"·href="struct.AllocError.html"·title="struct·alloc::alloc::AllocError">AllocError</a>></h4></section></summary><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><div·class='docblock'>Attempts·to·extend·the·memory·block.·<a·href="trait.Allocator.html#method.grow">Read·more</a></div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.grow_zeroed"·class="method·trait-impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#287-295">Source</a><a·href="#method.grow_zeroed"·class="anchor">§</a><h4·class="code-header">unsafe·fn·<a·href="trait.Allocator.html#method.grow_zeroed"·class="fn">grow_zeroed</a>(
13	····&self,	13	····&self,
14	····ptr:·<a·class="struct"·href="../../core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNull</a><<a·class="primitive"·href="../../core/primitive.u8.html">u8</a>>,	14	····ptr:·<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNull</a><<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.u8.html">u8</a>>,
15	····old_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,	15	····old_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,
16	····new_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,	16	····new_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,
17	)·->·<a·class="enum"·href="../../core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="../../core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu~~ll</a>&l~~t~~;[<a~~·cla~~ss="primitiv~~e~~"·hr~~e~~f="~~..~~/..~~/core/primitive.u8.html">u8</a>]>,·<a·class="struct"·href="struct.AllocError.html"·title="struct·alloc::alloc::AllocError">AllocError</a>></h4></section></summary><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><div·class='docblock'>Behaves·like·<code>grow</code>,·but·also·ensures·that·the·new·contents·are·set·to·zero·before·being	17	)·->·<a·class="enum"·href="https://doc.rust-lang.org/1.85.0/core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu[·...·truncated·by·diffoscope;·len:·70,·SHA:·b59d686d84d7b0b29d9d9baa499f050c97869a74e85d8a6bc3ad3a537e79049a·...·]/core/primitive.u8.html">u8</a>]>,·<a·class="struct"·href="struct.AllocError.html"·title="struct·alloc::alloc::AllocError">AllocError</a>></h4></section></summary><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>allocator_api</code> <a·href="https://github.com/rust-lang/rust/issues/32838">#32838</a>)</span></div></span><div·class='docblock'>Behaves·like·<code>grow</code>,·but·also·ensures·that·the·new·contents·are·set·to·zero·before·being
18	returned.·<a·href="trait.Allocator.html#method.grow_zeroed">Read·more</a></div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.shrink"·class="method·trait-impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#299-339">Source</a><a·href="#method.shrink"·class="anchor">§</a><h4·class="code-header">unsafe·fn·<a·href="trait.Allocator.html#method.shrink"·class="fn">shrink</a>(	18	returned.·<a·href="trait.Allocator.html#method.grow_zeroed">Read·more</a></div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.shrink"·class="method·trait-impl"><a·class="src·rightside"·href="../../src/alloc/alloc.rs.html#299-339">Source</a><a·href="#method.shrink"·class="anchor">§</a><h4·class="code-header">unsafe·fn·<a·href="trait.Allocator.html#method.shrink"·class="fn">shrink</a>(
19	····&self,	19	····&self,
20	····ptr:·<a·class="struct"·href="../../core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNull</a><<a·class="primitive"·href="../../core/primitive.u8.html">u8</a>>,	20	····ptr:·<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNull</a><<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.u8.html">u8</a>>,
21	····old_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,	21	····old_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,
22	····new_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,	22	····new_layout:·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,
23	)·->·<a·class="enum"·href="../../core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="../../core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu~~ll</a><[<a·class="primitive"·href="../../core/primi~~[·...·truncated·by·diffoscope;·len:·680,·SHA:·f420c~~e52f3~~9~~0533b~~8~~8d002cb9~~2~~d22a~~7~~e5495~~6~~c16d~~2~~ebf~~58~~a9123~~475~~a4a76a4de~~·...·]/src/core/alloc/mod.rs.html#364-366">Source</a><a·href="#method.by_ref"·class="anchor">§</a><h4·class="code-header">fn·<a·href="trait.Allocator.html#method.by_ref"·class="fn">by_ref</a>(&self)·->·&Self<div·class="where">where	23	)·->·<a·class="enum"·href="https://doc.rust-lang.org/1.85.0/core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu[·...·truncated·by·diffoscope;·len:·788,·SHA:·eaf56202d7389f769d8eb164482219c27cd23d6b41823dc5508b04745bf8ce16·...·]/src/core/alloc/mod.rs.html#364-366">Source</a><a·href="#method.by_ref"·class="anchor">§</a><h4·class="code-header">fn·<a·href="trait.Allocator.html#method.by_ref"·class="fn">by_ref</a>(&self)·->·&Self<div·class="where">where
24	····Self:·<a·class="trait"·href="../../core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h4></section></summary><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimen~~tal·API.·(<code>alloca~~t~~or_ap~~[·...·truncated·by·diffoscope;·len:·~~8773~~,·SHA:·545d73c~~9fd3~~1~~2491~~4~~5de6~~f~~d6d~~c6d~~3e55~~5~~af74f~~7~~a4ebd~~1ba52e5~~993~~1dc~~a303b19~~·...·]/core/any/trait.Any.html"·title="trait·core::any::Any">Any</a>·for·T<div·class="where">where	24	····Self:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h4></section></summary><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experiment[·...·truncated·by·diffoscope;·len:·9394,·SHA:·bbd6ce0821d6054c95cf770cadaff049a9e559cbd757078105ef8115cd2edc50·...·]/core/any/trait.Any.html"·title="trait·core::any::Any">Any</a>·for·T<div·class="where">where
25	····T:·'static·+·?<a·class="trait"·href="../../core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.type_id"·class="method~~·trait-impl"><a·class="src·~~[·...·truncated·by·diffoscope;·len:·~~672~~,·SHA:·ac~~e7a0599717~~4~~5d739c5a~~bd98~~21e~~5d1d485cc2~~33f~~d4~~215~~0~~ceb~~251~~bdea1c~~e6bf7·...·]/src/core/borrow.rs.html#209">Source</a><a·href="#impl-Borrow%3CT%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.Borrow.html"·title="trait·alloc::borrow::Borrow">Borrow</a><T>·for·T<div·class="where">where	25	····T:·'static·+·?<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.type_id"·class="method[·...·truncated·by·diffoscope;·len:·834,·SHA:·88c662bd34d0f4e861f64cb8fb1d4f857b52c68d17802862f81ca7539e73b64a·...·]/src/core/borrow.rs.html#209">Source</a><a·href="#impl-Borrow%3CT%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.Borrow.html"·title="trait·alloc::borrow::Borrow">Borrow</a><T>·for·T<div·class="where">where
26	····T:·?<a·class="trait"·href="../../core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.borrow"·class="method~~·trait-impl"><a·class="src~~·r[·...·truncated·by·diffoscope;·len:·~~629~~,·SHA:·8e~~6f5d~~2e~~4a2830729~~c5d4~~9545911~~3ca~~6f54993696d~~7dc71c1~~f46e~~5691~~f5108ed~~·...·]/src/core/borrow.rs.html#217">Source</a><a·href="#impl-BorrowMut%3CT%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.BorrowMut.html"·title="trait·alloc::borrow::BorrowMut">BorrowMut</a><T>·for·T<div·class="where">where	26	····T:·?<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.borrow"·class="method·[·...·truncated·by·diffoscope;·len:·737,·SHA:·e938e2977e0c43ec3e427def9c33adb01edb85207cc1315a205186e91c1f232b·...·]/src/core/borrow.rs.html#217">Source</a><a·href="#impl-BorrowMut%3CT%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.BorrowMut.html"·title="trait·alloc::borrow::BorrowMut">BorrowMut</a><T>·for·T<div·class="where">where
27	····T:·?<a·class="trait"·href="../../core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.borrow_mut"·class="me~~thod·trai~~t~~-impl"><a·class="s~~[·...·truncated·by·diffoscope;·len:·~~819~~,·SHA:·3ca215d8~~7d373~~b~~e2977~~4f~~ff31d75c216~~0~~34e4a~~a910e~~49de0e3fc~~5~~b88~~c46bc387·...·]/core/clone/trait.CloneToUninit.html"·title="trait·core::clone::CloneToUninit">CloneToUninit</a>·for·T<div·class="where">where	27	····T:·?<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.borrow_mut"·class="met[·...·truncated·by·diffoscope;·len:·954,·SHA:·312353ef26ba481a4b52a70beb9d0c9fefa1ef6cb98abb54a2c56eb333d9f133·...·]/core/clone/trait.CloneToUninit.html"·title="trait·core::clone::CloneToUninit">CloneToUninit</a>·for·T<div·class="where">where
28	····T:·<a·class="trait"·href="../../core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.clone_to_uninit"·class=~~"method·trait-impl~~"~~><a·class~~[·...·truncated·by·diffoscope;·len:·1613,·SHA:·593~~89e90f0a0~~d91f~~421d279eda~~717d~~9ad82cd97e00~~f~~1c482c8e2e8~~1a51360238·...·]/core/convert/trait.From.html#tymethod.from"·class="fn">from</a>(t:·T)·->·T</h4></section></summary><div·class="docblock"><p>Returns·the·argument·unchanged.</p>	28	····T:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.clone_to_uninit"·class="[·...·truncated·by·diffoscope;·len:·1883,·SHA:·84530d34a853fd08f907338c37f7cdc67abee3ba64f4b257f343c41b501b3606·...·]/core/convert/trait.From.html#tymethod.from"·class="fn">from</a>(t:·T)·->·T</h4></section></summary><div·class="docblock"><p>Returns·the·argument·unchanged.</p>
29	</div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-Into%3CU%3E-for-T"·class="impl"><a·class="src·rightside"·href="../../src/core/convert/mod.rs.html#750-752">Source</a><a·href="#impl-Into%3CU%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T,·U>·<a·class="trait"·href="../../core/convert/trait.Into.html"·title="trait·core::convert::Into">Into</a><U>·for·T<div·class="where">where	29	</div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-Into%3CU%3E-for-T"·class="impl"><a·class="src·rightside"·href="https://doc.rust-lang.org/1.85.0/src/core/convert/mod.rs.html#750-752">Source</a><a·href="#impl-Into%3CU%3E-for-T"·class="anchor">§</a><h3·class="code-header">impl<T,·U>·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.Into.html"·title="trait·core::convert::Into">Into</a><U>·for·T<div·class="where">where
30	····U:·<a·class="trait"·href="../../core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.into"·class="~~method·trait-i~~m~~pl"><a·class=~~[·...·truncated·by·diffoscope;·len:·~~156~~,·SHA:·~~f5090~~3~~482545~~5174cf2162343c6~~bdde8e~~e~~f56~~98c1b~~10053~~1~~d75d18324~~cfe~~7fd1~~·...·]/core/convert/trait.Into.html#tymethod.into"·class="fn">into</a>(self)·->·U</h4></section></summary><div·class="docblock"><p>Calls·<code>U::from(self)</code>.</p>	30	····U:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle·method-toggle"·open><summary><section·id="method.into"·class="m[·...·truncated·by·diffoscope;·len:·237,·SHA:·8bb1e3b1393e5d341bc2152ab6439fd0edcc9481bf3dd414f444b6a8cde3b77c·...·]/core/convert/trait.Into.html#tymethod.into"·class="fn">into</a>(self)·->·U</h4></section></summary><div·class="docblock"><p>Calls·<code>U::from(self)</code>.</p>
31	<p>That·is,·this·conversion·is·whatever·the·implementation·of	31	<p>That·is,·this·conversion·is·whatever·the·implementation·of
32	<code><a·href="../../core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>·for·U</code>·chooses·to·do.</p>	32	<code><a·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>·for·U</code>·chooses·to·do.</p>
33	</div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToOwned-for-T"·class="impl"><a·class="src·rightside"·href="../../src/alloc/borrow.rs.html#82-94">Source</a><a·href="#impl-ToOwned-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.ToOwned.html"·title="trait·alloc::borrow::ToOwned">ToOwned</a>·for·T<div·class="where">where	33	</div></details></div></details><details·class="toggle·implementors-toggle"><summary><section·id="impl-ToOwned-for-T"·class="impl"><a·class="src·rightside"·href="../../src/alloc/borrow.rs.html#82-94">Source</a><a·href="#impl-ToOwned-for-T"·class="anchor">§</a><h3·class="code-header">impl<T>·<a·class="trait"·href="../borrow/trait.ToOwned.html"·title="trait·alloc::borrow::ToOwned">ToOwned</a>·for·T<div·class="where">where
34	····T:·<a·class="trait"·href="../../core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Owned"·class="associatedtype·~~trai~~t~~-impl"><a·class="src·ri~~[·...·truncated·by·diffoscope;·len:·1871,·SHA:·4712c~~845~~8~~87becac1~~6~~0f72a4f2f5~~d13~~0f331~~96c07a9ea1~~eee3f5~~61b~~8283467cf~~·...·]/core/convert/trait.TryFrom.html"·title="trait·core::convert::TryFrom">TryFrom</a><U>·for·T<div·class="where">where	34	····T:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/clone/trait.Clone.html"·title="trait·core::clone::Clone">Clone</a>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Owned"·class="associatedtype·t[·...·truncated·by·diffoscope;·len:·1979,·SHA:·c013ecf3c836c3b76846a0b0ef74bdd632527e9940019331fbc7d36fc07180d9·...·]/core/convert/trait.TryFrom.html"·title="trait·core::convert::TryFrom">TryFrom</a><U>·for·T<div·class="where">where
35	····U:·<a·class="trait"·href="../../core/convert/trait.Into.html"·title="trait·core::convert::Into">Into</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Error-1"·class="asso~~ciatedtype·trait-impl"><a·c~~[·...·truncated·by·diffoscope;·len:·1676,·SHA:·a~~f8e86ce~~a~~46b~~e74e76~~8c31~~f24e~~4797~~0~~91af~~37956e3369bd739e3ea029~~7db774d~~·...·]/core/convert/trait.TryInto.html"·title="trait·core::convert::TryInto">TryInto</a><U>·for·T<div·class="where">where	35	····U:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.Into.html"·title="trait·core::convert::Into">Into</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Error-1"·class="asso[·...·truncated·by·diffoscope;·len:·1973,·SHA:·7ab179d200af2e2eb047369195f0dee05405e7736255d5d68ea309b71a353089·...·]/core/convert/trait.TryInto.html"·title="trait·core::convert::TryInto">TryInto</a><U>·for·T<div·class="where">where
36	····U:·<a·class="trait"·href="../../core/convert/trait.TryFrom.html"·title="trait·core::convert::TryFrom">TryFrom</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Error"·cl~~ass="~~ass~~ociatedtype·trait-imp~~[·...·truncated·by·diffoscope;·len:·1308,·SHA:·a3e64823~~adb~~41893b~~d55~~ef~~22ffa~~3a~~7f3~~7~~ba6a7e~~dfa~~9239~~c~~bb0a1d8abd~~8~~e7a200~~·...·]/core/convert/trait.TryFrom.html#associatedtype.Error"·title="type·core::convert::TryFrom::Error">Error</a>></h4></section></summary><div·class='docblock'>Performs·the·conversion.</div></details></div></details></div></section></div></main></body></html>	36	····U:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/convert/trait.TryFrom.html"·title="trait·core::convert::TryFrom">TryFrom</a><T>,</div></h3></section></summary><div·class="impl-items"><details·class="toggle"·open><summary><section·id="associatedtype.Error"·clas[·...·truncated·by·diffoscope;·len:·1578,·SHA:·f0c8a59634f23f274c0b0f802e636ba728e5f2dfa00f5c4489547ff486a17653·...·]/core/convert/trait.TryFrom.html#associatedtype.Error"·title="type·core::convert::TryFrom::Error">Error</a>></h4></section></summary><div·class='docblock'>Performs·the·conversion.</div></details></div></details></div></section></div></main></body></html>


Offset 1, 22 lines modified		Offset 1, 22 lines modified
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="Layout·of·a·block·of·memory."><title>Layout·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·struct"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Layout</a></h2><h3><a·href="#implementations">Methods</a></h3><ul·class="block·method"><li><a·href="#method.align"·title="align">align</a></li><li><a·href="#method.align_to"·title="align_to">align_to</a></li><li><a·href="#method.array"·title="array">array</a></li><li><a·href="#method.dangling"·title="dangling">dangling</a></li><li><a·href="#method.extend"·title="extend">extend</a></li><li><a·href="#method.extend_packed"·title="extend_packed">extend_packed</a></li><li><a·href="#method.for_value"·title="for_value">for_value</a></li><li><a·href="#method.for_value_raw"·title="for_value_raw">for_value_raw</a></li><li><a·href="#method.from_size_align"·title="from_size_align">from_size_align</a></li><li><a·href="#method.from_size_align_unchecked"·title="from_size_align_unchecked">from_size_align_unchecked</a></li><li><a·href="#method.new"·title="new">new</a></li><li><a·href="#method.pad_to_align"·title="pad_to_align">pad_to_align</a></li><li><a·href="#method.padding_needed_for"·title="padding_needed_for">padding_needed_for</a></li><li><a·href="#method.repeat"·title="repeat">repeat</a></li><li><a·href="#method.repeat_packed"·title="repeat_packed">repeat_packed</a></li><li><a·href="#method.size"·title="size">size</a></li></ul><h3><a·href="#trait-implementations">Trait·Implementations</a></h3><ul·class="block·trait-implementation"><li><a·href="#impl-Clone-for-Layout"·title="Clone">Clone</a></li><li><a·href="#impl-Copy-for-Layout"·title="Copy">Copy</a></li><li><a·href="#impl-Debug-for-Layout"·title="Debug">Debug</a></li><li><a·href="#impl-Eq-for-Layout"·title="Eq">Eq</a></li><li><a·href="#impl-Hash-for-Layout"·title="Hash">Hash</a></li><li><a·href="#impl-PartialEq-for-Layout"·title="PartialEq">PartialEq</a></li><li><a·href="#impl-StructuralPartialEq-for-Layout"·title="StructuralPartialEq">StructuralPartialEq</a></li></ul><h3><a·href="#synthetic-implementations">Auto·Trait·Implementations</a></h3><ul·class="block·synthetic-implementation"><li><a·href="#impl-Freeze-for-Layout"·title="Freeze">Freeze</a></li><li><a·href="#impl-RefUnwindSafe-for-Layout"·title="RefUnwindSafe">RefUnwindSafe</a></li><li><a·href="#impl-Send-for-Layout"·title="Send">Send</a></li><li><a·href="#impl-Sync-for-Layout"·title="Sync">Sync</a></li><li><a·href="#impl-Unpin-for-Layout"·title="Unpin">Unpin</a></li><li><a·href="#impl-UnwindSafe-for-Layout"·title="UnwindSafe">UnwindSafe</a></li></ul><h3><a·href="#blanket-implementations">Blanket·Implementations</a></h3><ul·class="block·blanket-implementation"><li><a·href="#impl-Any-for-T"·title="Any">Any</a></li><li><a·href="#impl-Borrow%3CT%3E-for-T"·title="Borrow<T>">Borrow<T></a></li><li><a·href="#impl-BorrowMut%3CT%3E-for-T"·title="BorrowMut<T>">BorrowMut<T></a></li><li><a·href="#impl-CloneToUninit-for-T"·title="CloneToUninit">CloneToUninit</a></li><li><a·href="#impl-From%3CT%3E-for-T"·title="From<T>">From<T></a></li><li><a·href="#impl-Into%3CU%3E-for-T"·title="Into<U>">Into<U></a></li><li><a·href="#impl-ToOwned-for-T"·title="ToOwned">ToOwned</a></li><li><a·href="#impl-TryFrom%3CU%3E-for-T"·title="TryFrom<U>">TryFrom<U></a></li><li><a·href="#impl-TryInto%3CU%3E-for-T"·title="TryInto<U>">TryInto<U></a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Struct·<span·class="struct">Layout</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0">1.36.0</span>···<a·class="src"·href="../../src/core/alloc/layout.rs.html#40">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·struct·Layout·{·<span·class="comment">/·private·fields·/</span>·}</code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Layout·of·a·block·of·memory.</p>	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="Layout·of·a·block·of·memory."><title>Layout·in·alloc::alloc·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·struct"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Layout</a></h2><h3><a·href="#implementations">Methods</a></h3><ul·class="block·method"><li><a·href="#method.align"·title="align">align</a></li><li><a·href="#method.align_to"·title="align_to">align_to</a></li><li><a·href="#method.array"·title="array">array</a></li><li><a·href="#method.dangling"·title="dangling">dangling</a></li><li><a·href="#method.extend"·title="extend">extend</a></li><li><a·href="#method.extend_packed"·title="extend_packed">extend_packed</a></li><li><a·href="#method.for_value"·title="for_value">for_value</a></li><li><a·href="#method.for_value_raw"·title="for_value_raw">for_value_raw</a></li><li><a·href="#method.from_size_align"·title="from_size_align">from_size_align</a></li><li><a·href="#method.from_size_align_unchecked"·title="from_size_align_unchecked">from_size_align_unchecked</a></li><li><a·href="#method.new"·title="new">new</a></li><li><a·href="#method.pad_to_align"·title="pad_to_align">pad_to_align</a></li><li><a·href="#method.padding_needed_for"·title="padding_needed_for">padding_needed_for</a></li><li><a·href="#method.repeat"·title="repeat">repeat</a></li><li><a·href="#method.repeat_packed"·title="repeat_packed">repeat_packed</a></li><li><a·href="#method.size"·title="size">size</a></li></ul><h3><a·href="#trait-implementations">Trait·Implementations</a></h3><ul·class="block·trait-implementation"><li><a·href="#impl-Clone-for-Layout"·title="Clone">Clone</a></li><li><a·href="#impl-Copy-for-Layout"·title="Copy">Copy</a></li><li><a·href="#impl-Debug-for-Layout"·title="Debug">Debug</a></li><li><a·href="#impl-Eq-for-Layout"·title="Eq">Eq</a></li><li><a·href="#impl-Hash-for-Layout"·title="Hash">Hash</a></li><li><a·href="#impl-PartialEq-for-Layout"·title="PartialEq">PartialEq</a></li><li><a·href="#impl-StructuralPartialEq-for-Layout"·title="StructuralPartialEq">StructuralPartialEq</a></li></ul><h3><a·href="#synthetic-implementations">Auto·Trait·Implementations</a></h3><ul·class="block·synthetic-implementation"><li><a·href="#impl-Freeze-for-Layout"·title="Freeze">Freeze</a></li><li><a·href="#impl-RefUnwindSafe-for-Layout"·title="RefUnwindSafe">RefUnwindSafe</a></li><li><a·href="#impl-Send-for-Layout"·title="Send">Send</a></li><li><a·href="#impl-Sync-for-Layout"·title="Sync">Sync</a></li><li><a·href="#impl-Unpin-for-Layout"·title="Unpin">Unpin</a></li><li><a·href="#impl-UnwindSafe-for-Layout"·title="UnwindSafe">UnwindSafe</a></li></ul><h3><a·href="#blanket-implementations">Blanket·Implementations</a></h3><ul·class="block·blanket-implementation"><li><a·href="#impl-Any-for-T"·title="Any">Any</a></li><li><a·href="#impl-Borrow%3CT%3E-for-T"·title="Borrow<T>">Borrow<T></a></li><li><a·href="#impl-BorrowMut%3CT%3E-for-T"·title="BorrowMut<T>">BorrowMut<T></a></li><li><a·href="#impl-CloneToUninit-for-T"·title="CloneToUninit">CloneToUninit</a></li><li><a·href="#impl-From%3CT%3E-for-T"·title="From<T>">From<T></a></li><li><a·href="#impl-Into%3CU%3E-for-T"·title="Into<U>">Into<U></a></li><li><a·href="#impl-ToOwned-for-T"·title="ToOwned">ToOwned</a></li><li><a·href="#impl-TryFrom%3CU%3E-for-T"·title="TryFrom<U>">TryFrom<U></a></li><li><a·href="#impl-TryInto%3CU%3E-for-T"·title="TryInto<U>">TryInto<U></a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>alloc</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">alloc</a></span><h1>Struct·<span·class="struct">Layout</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0">1.36.0</span>···<a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/alloc/layout.rs.html#40">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·struct·Layout·{·<span·class="comment">/·private·fields·/</span>·}</code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Layout·of·a·block·of·memory.</p>
2	<p>An·instance·of·<code>Layout</code>·describes·a·particular·layout·of·memory.	2	<p>An·instance·of·<code>Layout</code>·describes·a·particular·layout·of·memory.
3	You·build·a·<code>Layout</code>·up·as·an·input·to·give·to·an·allocator.</p>	3	You·build·a·<code>Layout</code>·up·as·an·input·to·give·to·an·allocator.</p>
4	<p>All·layouts·have·an·associated·size·and·a·power-of-two·alignment.·The·size,·when·rounded·up·to	4	<p>All·layouts·have·an·associated·size·and·a·power-of-two·alignment.·The·size,·when·rounded·up·to
5	the·nearest·multiple·of·<code>align</code>,·does·not·overflow·<code>isize</code>·(i.e.,·the·rounded·value·will·always·be	5	the·nearest·multiple·of·<code>align</code>,·does·not·overflow·<code>isize</code>·(i.e.,·the·rounded·value·will·always·be
6	less·than·or·equal·to·<code>isize::MAX</code>).</p>	6	less·than·or·equal·to·<code>isize::MAX</code>).</p>
7	<p>(Note·that·layouts·are·<em>not</em>·required·to·have·non-zero·size,	7	<p>(Note·that·layouts·are·<em>not</em>·required·to·have·non-zero·size,
8	even·though·<code>GlobalAlloc</code>·requires·that·all·memory·requests	8	even·though·<code>GlobalAlloc</code>·requires·that·all·memory·requests
9	be·non-zero·in·size.·A·caller·must·either·ensure·that·conditions	9	be·non-zero·in·size.·A·caller·must·either·ensure·that·conditions
10	like·this·are·met,·use·specific·allocators·with·looser	10	like·this·are·met,·use·specific·allocators·with·looser
11	requirements,·or·use·the·more·lenient·<code>Allocator</code>·interface.)</p>	11	requirements,·or·use·the·more·lenient·<code>Allocator</code>·interface.)</p>
12	</div></details><h2·id="implementations"·class="section-header">Implementations<a·href="#implementations"·class="anchor">§</a></h2><div·id="implementations-list"><details·class="toggle·implementors-toggle"·open><summary><section·id="impl-Layout"·class="impl"><a·class="src·rightside"·href="../../src/core/alloc/layout.rs.html#54">Source</a><a·href="#impl-Layout"·class="anchor">§</a><h3·class="code-header">impl·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a></h3></section></~~summary><div·class="impl-it~~[·...·truncated·by·diffoscope;·len:·~~272~~,·SHA:·2fd~~5932925~~2~~a1ef640c713032~~3~~9eb1dd1316cc4cafb~~a45018~~adcaa~~7337~~16cc98~~·...·]/src/core/alloc/layout.rs.html#69">Source</a></span><h4·class="code-header">pub·const·fn·<a·href="#method.from_size_align"·class="fn">from_size_align</a>(	12	</div></details><h2·id="implementations"·class="section-header">Implementations<a·href="#implementations"·class="anchor">§</a></h2><div·id="implementations-list"><details·class="toggle·implementors-toggle"·open><summary><section·id="impl-Layout"·class="impl"><a·class="src·rightside"·href="https://doc.rust-lang.org/1.85.0/src/core/alloc/layout.rs.html#54">Source</a><a·href="#impl-Layout"·class="anchor">§</a><h3·class="code-header">impl·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a></h3></section></[·...·truncated·by·diffoscope;·len:·326,·SHA:·a83d737a74c2f940b52969e15753305825b0895758b78a4580be6b705738a91e·...·]/src/core/alloc/layout.rs.html#69">Source</a></span><h4·class="code-header">pub·const·fn·<a·href="#method.from_size_align"·class="fn">from_size_align</a>(
13	····size:·<a·class="primitive"·href="../../core/primitive.usize.html">usize</a>,	13	····size:·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.usize.html">usize</a>,
14	····align:·<a·class="primitive"·href="../../core/primitive.usize.html">usize</a>,	14	····align:·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.usize.html">usize</a>,
15	)·->·<a·class="enum"·href="../../core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,·<a·class="struct"·href="struct.LayoutError.html"·title="struct·alloc::alloc::LayoutError">LayoutError</a>></h4></section></summary><div·class="docblock"><p>Constructs·a·<code>Layout</code>·from·a·given·<code>size</code>·and·<code>align</code>,	15	)·->·<a·class="enum"·href="https://doc.rust-lang.org/1.85.0/core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a>,·<a·class="struct"·href="struct.LayoutError.html"·title="struct·alloc::alloc::LayoutError">LayoutError</a>></h4></section></summary><div·class="docblock"><p>Constructs·a·<code>Layout</code>·from·a·given·<code>size</code>·and·<code>align</code>,
16	or·returns·<code>LayoutError</code>·if·any·of·the·following·conditions	16	or·returns·<code>LayoutError</code>·if·any·of·the·following·conditions
17	are·not·met:</p>	17	are·not·met:</p>
18	<ul>	18	<ul>
19	<li>	19	<li>
20	<p><code>align</code>·must·not·be·zero,</p>	20	<p><code>align</code>·must·not·be·zero,</p>
21	</li>	21	</li>
22	<li>	22	<li>
Offset 24, 40 lines modified		Offset 24, 40 lines modified
24	</li>	24	</li>
25	<li>	25	<li>
26	<p><code>size</code>,·when·rounded·up·to·the·nearest·multiple·of·<code>align</code>,	26	<p><code>size</code>,·when·rounded·up·to·the·nearest·multiple·of·<code>align</code>,
27	must·not·overflow·<code>isize</code>·(i.e.,·the·rounded·value·must·be	27	must·not·overflow·<code>isize</code>·(i.e.,·the·rounded·value·must·be
28	less·than·or·equal·to·<code>isize::MAX</code>).</p>	28	less·than·or·equal·to·<code>isize::MAX</code>).</p>
29	</li>	29	</li>
30	</ul>	30	</ul>
31	</div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.from_size_align_unchecked"·class="method"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.28.0,·const·since·1.36.0">1.28.0·(const:·1.36.0)</span>···<a·class="src"·href="../../src/core/alloc/layout.rs.html#129">Source</a></span><h4·class="code-header">pub·const·unsafe·fn·<a·href="#method.from_size_align_unchecked"·class="fn">from_size_align_unchecked</a>(	31	</div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.from_size_align_unchecked"·class="method"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.28.0,·const·since·1.36.0">1.28.0·(const:·1.36.0)</span>···<a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/alloc/layout.rs.html#129">Source</a></span><h4·class="code-header">pub·const·unsafe·fn·<a·href="#method.from_size_align_unchecked"·class="fn">from_size_align_unchecked</a>(
32	····size:·<a·class="primitive"·href="../../core/primitive.usize.html">usize</a>,	32	····size:·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.usize.html">usize</a>,
33	····align:·<a·class="primitive"·href="../../core/primitive.usize.html">usize</a>,	33	····align:·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.usize.html">usize</a>,
34	)·->·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a></h4></section></summary><div·class="docblock"><p>Creates·a·layout,·bypassing·all·checks.</p>	34	)·->·<a·class="struct"·href="struct.Layout.html"·title="struct·alloc::alloc::Layout">Layout</a></h4></section></summary><div·class="docblock"><p>Creates·a·layout,·bypassing·all·checks.</p>
35	<h5·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h5>	35	<h5·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h5>
36	<p>This·function·is·unsafe·as·it·does·not·verify·the·preconditions·from	36	<p>This·function·is·unsafe·as·it·does·not·verify·the·preconditions·from
37	<a·href="struct.Layout.html#method.from_size_align"·title="associated·function·alloc::alloc::Layout::from_size_align"><code>Layout::from_size_align</code></a>.</p>	37	<a·href="struct.Layout.html#method.from_size_align"·title="associated·function·alloc::alloc::Layout::from_size_align"><code>Layout::from_size_align</code></a>.</p>
38	</div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.size"·class="method"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.28.0,·const·since·1.50.0">1.28.0·(const:·1.50.0)</span>···<a·class="src"·href="../../src/core/alloc/layout.rs.html#148">Source</a></span><h4·class="code-header">pub·const·fn·<a·href="#method.size"·class="fn">size</a>(&self)·->·<a·class="primitive"·href="../../core/primitive.usize.html">usize</a></h4></section></summary><div·class="docblock"><p>The·minimum·size·in·bytes·for·a·memory·block·of·this·layout.</p>	38	</div></details><details·class="toggle·method-toggle"·open><summary><section·id="method.size"·class="method"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.28.0,·const·since·1.50.0">1.28.0·(const:·1.50.0)</span>···<a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/alloc/layout.rs.html#148">Source</a></span><h4·class="code-header">pub·const·fn·<a·href="#method.size"·class="fn">size</a>(&self)·->·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.usize.html">usize</a></h4></section></summary><div·class="docblock"><p>The·minimum·size·in·bytes·for·a·memory·block·of·this·layout.</p>


Offset 13, 16 lines modified		Offset 13, 16 lines modified
13	is·the·same·as·that·of·a·pointer.·Tree-like·data·structures·are·often·built	13	is·the·same·as·that·of·a·pointer.·Tree-like·data·structures·are·often·built
14	with·boxes·because·each·node·often·has·only·one·owner,·the·parent.</p>	14	with·boxes·because·each·node·often·has·only·one·owner,·the·parent.</p>
15	<h3·id="reference-counted-pointers"><a·class="doc-anchor"·href="#reference-counted-pointers">§</a>Reference·counted·pointers</h3>	15	<h3·id="reference-counted-pointers"><a·class="doc-anchor"·href="#reference-counted-pointers">§</a>Reference·counted·pointers</h3>
16	<p>The·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc</code></a>·type·is·a·non-threadsafe·reference-counted·pointer·type·intended	16	<p>The·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc</code></a>·type·is·a·non-threadsafe·reference-counted·pointer·type·intended
17	for·sharing·memory·within·a·thread.·An·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc</code></a>·pointer·wraps·a·type,·<code>T</code>,·and	17	for·sharing·memory·within·a·thread.·An·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc</code></a>·pointer·wraps·a·type,·<code>T</code>,·and
18	only·allows·access·to·<code>&T</code>,·a·shared·reference.</p>	18	only·allows·access·to·<code>&T</code>,·a·shared·reference.</p>
19	<p>This·type·is·useful·when·inherited·mutability·(such·as·using·<a·href="boxed/index.html"·title="mod·alloc::boxed"><code>Box</code></a>)·is·too	19	<p>This·type·is·useful·when·inherited·mutability·(such·as·using·<a·href="boxed/index.html"·title="mod·alloc::boxed"><code>Box</code></a>)·is·too
20	constraining·for·an·application,·and·is·often·paired·with·the·<a·href="../core/cell/index.html"·title="mod·core::cell"><code>Cell</code></a>·or	20	constraining·for·an·application,·and·is·often·paired·with·the·<a·href="https://doc.rust-lang.org/1.85.0/core/cell/index.html"·title="mod·core::cell"><code>Cell</code></a>·or
21	<a·href="../core/cell/index.html"·title="mod·core::cell"><code>RefCell</code></a>·types·in·order·to·allow·mutation.</p>	21	<a·href="https://doc.rust-lang.org/1.85.0/core/cell/index.html"·title="mod·core::cell"><code>RefCell</code></a>·types·in·order·to·allow·mutation.</p>
22	<h3·id="atomically-reference-counted-pointers"><a·class="doc-anchor"·href="#atomically-reference-counted-pointers">§</a>Atomically·reference·counted·pointers</h3>	22	<h3·id="atomically-reference-counted-pointers"><a·class="doc-anchor"·href="#atomically-reference-counted-pointers">§</a>Atomically·reference·counted·pointers</h3>
23	<p>The·<a·href="sync/index.html"·title="mod·alloc::sync"><code>Arc</code></a>·type·is·the·threadsafe·equivalent·of·the·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc</code></a>·type.·It	23	<p>The·<a·href="sync/index.html"·title="mod·alloc::sync"><code>Arc</code></a>·type·is·the·threadsafe·equivalent·of·the·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc</code></a>·type.·It
24	provides·all·the·same·functionality·of·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc</code></a>,·except·it·requires·that·the	24	provides·all·the·same·functionality·of·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc</code></a>,·except·it·requires·that·the
25	contained·type·<code>T</code>·is·shareable.·Additionally,·<a·href="sync/index.html"·title="mod·alloc::sync"><code>Arc<T></code></a>·is·itself	25	contained·type·<code>T</code>·is·shareable.·Additionally,·<a·href="sync/index.html"·title="mod·alloc::sync"><code>Arc<T></code></a>·is·itself
26	sendable·while·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc<T></code></a>·is·not.</p>	26	sendable·while·<a·href="rc/index.html"·title="mod·alloc::rc"><code>Rc<T></code></a>·is·not.</p>
27	<p>This·type·allows·for·shared·access·to·the·contained·data,·and·is·often	27	<p>This·type·allows·for·shared·access·to·the·contained·data,·and·is·often
28	paired·with·synchronization·primitives·such·as·mutexes·to·allow·mutation·of	28	paired·with·synchronization·primitives·such·as·mutexes·to·allow·mutation·of


Offset 5, 19 lines modified		Offset 5, 19 lines modified
5	literal.·The·power·of·the·formatting·string·is·in·the·<code>{}</code>s·contained.	5	literal.·The·power·of·the·formatting·string·is·in·the·<code>{}</code>s·contained.
6	Additional·parameters·passed·to·<code>format!</code>·replace·the·<code>{}</code>s·within·the	6	Additional·parameters·passed·to·<code>format!</code>·replace·the·<code>{}</code>s·within·the
7	formatting·string·in·the·order·given·unless·named·or·positional·parameters	7	formatting·string·in·the·order·given·unless·named·or·positional·parameters
8	are·used.</p>	8	are·used.</p>
9	<p>See·<a·href="../std/fmt/index.html">the·formatting·syntax·documentation·in·<code>std::fmt</code></a>	9	<p>See·<a·href="../std/fmt/index.html">the·formatting·syntax·documentation·in·<code>std::fmt</code></a>
10	for·details.</p>	10	for·details.</p>
11	<p>A·common·use·for·<code>format!</code>·is·concatenation·and·interpolation·of·strings.	11	<p>A·common·use·for·<code>format!</code>·is·concatenation·and·interpolation·of·strings.
12	The·same·convention·is·used·with·<a·href="../std/macro.print.html"><code>print!</code></a>·and·<a·href="../core/macro.write.html"·title="macro·core::write"><code>write!</code></a>·macros,	12	The·same·convention·is·used·with·<a·href="../std/macro.print.html"><code>print!</code></a>·and·<a·href="https://doc.rust-lang.org/1.85.0/core/macro.write.html"·title="macro·core::write"><code>write!</code></a>·macros,
13	depending·on·the·intended·destination·of·the·string;·all·these·macros·internally·use·<a·href="../core/macro.format_args.html"·title="macro·core::format_args"><code>format_args!</code></a>.</p>	13	depending·on·the·intended·destination·of·the·string;·all·these·macros·internally·use·<a·href="https://doc.rust-lang.org/1.85.0/core/macro.format_args.html"·title="macro·core::format_args"><code>format_args!</code></a>.</p>
14	<p>To·convert·a·single·value·to·a·string,·use·the·<a·href="string/trait.ToString.html"·title="trait·alloc::string::ToString"><code>to_string</code></a>·method.·This	14	<p>To·convert·a·single·value·to·a·string,·use·the·<a·href="string/trait.ToString.html"·title="trait·alloc::string::ToString"><code>to_string</code></a>·method.·This
15	will·use·the·<a·href="fmt/trait.Display.html"·title="trait·alloc::fmt::Display"><code>Display</code></a>·formatting·trait.</p>	15	will·use·the·<a·href="fmt/trait.Display.html"·title="trait·alloc::fmt::Display"><code>Display</code></a>·formatting·trait.</p>
16	<p>To·concatenate·literals·into·a·<code>&'static·str</code>,·use·the·<a·href="../core/macro.concat.html"·title="macro·core::concat"><code>concat!</code></a>·macro.</p>	16	<p>To·concatenate·literals·into·a·<code>&'static·str</code>,·use·the·<a·href="https://doc.rust-lang.org/1.85.0/core/macro.concat.html"·title="macro·core::concat"><code>concat!</code></a>·macro.</p>
17	<h2·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h2>	17	<h2·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h2>
18	<p><code>format!</code>·panics·if·a·formatting·trait·implementation·returns·an·error.	18	<p><code>format!</code>·panics·if·a·formatting·trait·implementation·returns·an·error.
19	This·indicates·an·incorrect·implementation	19	This·indicates·an·incorrect·implementation
20	since·<code>fmt::Write·for·String</code>·never·returns·an·error·itself.</p>	20	since·<code>fmt::Write·for·String</code>·never·returns·an·error·itself.</p>
21	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>	21	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>
22	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="macro">format!</span>(<span·class="string">"test"</span>);·····························<span·class="comment">//·=>·"test"	22	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="macro">format!</span>(<span·class="string">"test"</span>);·····························<span·class="comment">//·=>·"test"
23	</span><span·class="macro">format!</span>(<span·class="string">"hello·{}"</span>,·<span·class="string">"world!"</span>);···············<span·class="comment">//·=>·"hello·world!"	23	</span><span·class="macro">format!</span>(<span·class="string">"hello·{}"</span>,·<span·class="string">"world!"</span>);···············<span·class="comment">//·=>·"hello·world!"


Offset 16, 15 lines modified		Offset 16, 15 lines modified
16	<ul>	16	<ul>
17	<li>Create·a·<a·href="vec/struct.Vec.html"·title="struct·alloc::vec::Vec"><code>Vec</code></a>·from·a·given·element·and·size:</li>	17	<li>Create·a·<a·href="vec/struct.Vec.html"·title="struct·alloc::vec::Vec"><code>Vec</code></a>·from·a·given·element·and·size:</li>
18	</ul>	18	</ul>

19	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>v·=·<span·class="macro">vec!</span>[<span·class="number">1</span>;·<span·class="number">3</span>];	19	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>v·=·<span·class="macro">vec!</span>[<span·class="number">1</span>;·<span·class="number">3</span>];
20	<span·class="macro">assert_eq!</span>(v,·[<span·class="number">1</span>,·<span·class="number">1</span>,·<span·class="number">1</span>]);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+v+=+vec!%5B1;+3%5D;%0A++++assert_eq!(v,+%5B1,+1,+1%5D);%0A%7D&edition=2021"></a></div>	20	<span·class="macro">assert_eq!</span>(v,·[<span·class="number">1</span>,·<span·class="number">1</span>,·<span·class="number">1</span>]);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+v+=+vec!%5B1;+3%5D;%0A++++assert_eq!(v,+%5B1,+1,+1%5D);%0A%7D&edition=2021"></a></div>
21	<p>Note·that·unlike·array·expressions·this·syntax·supports·all·elements	21	<p>Note·that·unlike·array·expressions·this·syntax·supports·all·elements
22	which·implement·<a·href="../core/clone/trait.Clone.html"·title="trait·core::clone::Clone"><code>Clone</code></a>·and·the·number·of·elements·doesn’t·have·to·be	22	which·implement·<a·href="https://doc.rust-lang.org/1.85.0/core/clone/trait.Clone.html"·title="trait·core::clone::Clone"><code>Clone</code></a>·and·the·number·of·elements·doesn’t·have·to·be
23	a·constant.</p>	23	a·constant.</p>
24	<p>This·will·use·<code>clone</code>·to·duplicate·an·expression,·so·one·should·be·careful	24	<p>This·will·use·<code>clone</code>·to·duplicate·an·expression,·so·one·should·be·careful
25	using·this·with·types·having·a·nonstandard·<code>Clone</code>·implementation.·For	25	using·this·with·types·having·a·nonstandard·<code>Clone</code>·implementation.·For
26	example,·<code>vec![Rc::new(1);·5]</code>·will·create·a·vector·of·five·references	26	example,·<code>vec![Rc::new(1);·5]</code>·will·create·a·vector·of·five·references
27	to·the·same·boxed·integer·value,·not·five·references·pointing·to·independently	27	to·the·same·boxed·integer·value,·not·five·references·pointing·to·independently
28	boxed·integers.</p>	28	boxed·integers.</p>
29	<p>Also,·note·that·<code>vec![expr;·0]</code>·is·allowed,·and·produces·an·empty·vector.	29	<p>Also,·note·that·<code>vec![expr;·0]</code>·is·allowed,·and·produces·an·empty·vector.


Offset 1, 24 lines modified		Offset 1, 24 lines modified
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="Forms·a·mutable·slice·from·a·pointer·range."><title>from_mut_ptr_range·in·alloc::slice·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from»a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">from_<wbr>mut_<wbr>ptr_<wbr>range</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#safety"·title="Safety">Safety</a></li><li><a·href="#panics"·title="Panics">Panics</a></li><li><a·href="#caveat"·title="Caveat">Caveat</a></li><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>slice</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">slice</a></span><h1>Function·<span·class="fn">from_mut_ptr_range</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="../../src/core/slice/raw.rs.html#343">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·const·unsafe·fn·from_mut_ptr_range<'a,·T>(	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="Forms·a·mutable·slice·from·a·pointer·range."><title>from_mut_ptr_range·in·alloc::slice·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from»a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">from_<wbr>mut_<wbr>ptr_<wbr>range</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#safety"·title="Safety">Safety</a></li><li><a·href="#panics"·title="Panics">Panics</a></li><li><a·href="#caveat"·title="Caveat">Caveat</a></li><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>slice</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">slice</a></span><h1>Function·<span·class="fn">from_mut_ptr_range</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/slice/raw.rs.html#343">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·const·unsafe·fn·from_mut_ptr_range<'a,·T>(
2	····range:·<a·class="struct"·href="../../core/ops/range/struct.Range.html"·title="struct·core::ops::range::Range">Range</a><<a·class="primitive"·href="../../core/primitive.pointer.html">*mut·T</a>>,	2	····range:·<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ops/range/struct.Range.html"·title="struct·core::ops::range::Range">Range</a><<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.pointer.html">*mut·T</a>>,
3	)·->·&'a·mut·<a·class="primitive"·href="../../core/primitive.slice.html">[T]</a></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>slice_from_ptr_range</code> <a·href="https://github.com/rust-lang/rust/issues/89792">#89792</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Forms·a·mutable·slice·from·a·pointer·range.</p>	3	)·->·&'a·mut·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.slice.html">[T]</a></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>slice_from_ptr_range</code> <a·href="https://github.com/rust-lang/rust/issues/89792">#89792</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Forms·a·mutable·slice·from·a·pointer·range.</p>
4	<p>This·is·the·same·functionality·as·<a·href="fn.from_ptr_range.html"·title="fn·alloc::slice::from_ptr_range"><code>from_ptr_range</code></a>,·except·that·a	4	<p>This·is·the·same·functionality·as·<a·href="fn.from_ptr_range.html"·title="fn·alloc::slice::from_ptr_range"><code>from_ptr_range</code></a>,·except·that·a
5	mutable·slice·is·returned.</p>	5	mutable·slice·is·returned.</p>
6	<p>This·function·is·useful·for·interacting·with·foreign·interfaces·which	6	<p>This·function·is·useful·for·interacting·with·foreign·interfaces·which
7	use·two·pointers·to·refer·to·a·range·of·elements·in·memory,·as·is	7	use·two·pointers·to·refer·to·a·range·of·elements·in·memory,·as·is
8	common·in·C++.</p>	8	common·in·C++.</p>
9	<h2·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h2>	9	<h2·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h2>
10	<p>Behavior·is·undefined·if·any·of·the·following·conditions·are·violated:</p>	10	<p>Behavior·is·undefined·if·any·of·the·following·conditions·are·violated:</p>
11	<ul>	11	<ul>
12	<li>	12	<li>
13	<p>The·<code>start</code>·pointer·of·the·range·must·be·a·non-null,·<a·href="../../core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·and·properly·aligned·pointer	13	<p>The·<code>start</code>·pointer·of·the·range·must·be·a·non-null,·<a·href="https://doc.rust-lang.org/1.85.0/core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·and·properly·aligned·pointer
14	to·the·first·element·of·a·slice.</p>	14	to·the·first·element·of·a·slice.</p>
15	</li>	15	</li>
16	<li>	16	<li>
17	<p>The·<code>end</code>·pointer·must·be·a·<a·href="../../core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·and·properly·aligned·pointer·to·<em>one·past</em>	17	<p>The·<code>end</code>·pointer·must·be·a·<a·href="https://doc.rust-lang.org/1.85.0/core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·and·properly·aligned·pointer·to·<em>one·past</em>
18	the·last·element,·such·that·the·offset·from·the·end·to·the·start·pointer·is	18	the·last·element,·such·that·the·offset·from·the·end·to·the·start·pointer·is
19	the·length·of·the·slice.</p>	19	the·length·of·the·slice.</p>
20	</li>	20	</li>
21	<li>	21	<li>
22	<p>The·entire·memory·range·of·this·slice·must·be·contained·within·a·single·allocated·object!	22	<p>The·entire·memory·range·of·this·slice·must·be·contained·within·a·single·allocated·object!
23	Slices·can·never·span·across·multiple·allocated·objects.</p>	23	Slices·can·never·span·across·multiple·allocated·objects.</p>
24	</li>	24	</li>
Offset 29, 18 lines modified		Offset 29, 18 lines modified
29	<p>The·memory·referenced·by·the·returned·slice·must·not·be·accessed·through·any·other·pointer	29	<p>The·memory·referenced·by·the·returned·slice·must·not·be·accessed·through·any·other·pointer
30	(not·derived·from·the·return·value)·for·the·duration·of·lifetime·<code>'a</code>.	30	(not·derived·from·the·return·value)·for·the·duration·of·lifetime·<code>'a</code>.
31	Both·read·and·write·accesses·are·forbidden.</p>	31	Both·read·and·write·accesses·are·forbidden.</p>
32	</li>	32	</li>
33	<li>	33	<li>
34	<p>The·total·length·of·the·range·must·be·no·larger·than·<code>isize::MAX</code>,	34	<p>The·total·length·of·the·range·must·be·no·larger·than·<code>isize::MAX</code>,
35	and·adding·that·size·to·<code>start</code>·must·not·“wrap·around”·the·address·space.	35	and·adding·that·size·to·<code>start</code>·must·not·“wrap·around”·the·address·space.
36	See·the·safety·documentation·of·<a·href="../../core/primitive.pointer.html#method.offset"·title="method·pointer::offset"><code>pointer::offset</code></a>.</p>	36	See·the·safety·documentation·of·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.pointer.html#method.offset"·title="method·pointer::offset"><code>pointer::offset</code></a>.</p>
37	</li>	37	</li>
38	</ul>	38	</ul>
39	<p>Note·that·a·range·created·from·<a·href="../../core/primitive.slice.html#method.as_mut_ptr_range"·title="method·slice::as_mut_ptr_range"><code>slice::as_mut_ptr_range</code></a>·fulfills·these·requirements.</p>	39	<p>Note·that·a·range·created·from·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.slice.html#method.as_mut_ptr_range"·title="method·slice::as_mut_ptr_range"><code>slice::as_mut_ptr_range</code></a>·fulfills·these·requirements.</p>
40	<h2·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h2>	40	<h2·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h2>
41	<p>This·function·panics·if·<code>T</code>·is·a·Zero-Sized·Type·(“ZST”).</p>	41	<p>This·function·panics·if·<code>T</code>·is·a·Zero-Sized·Type·(“ZST”).</p>
42	<h2·id="caveat"><a·class="doc-anchor"·href="#caveat">§</a>Caveat</h2>	42	<h2·id="caveat"><a·class="doc-anchor"·href="#caveat">§</a>Caveat</h2>
43	<p>The·lifetime·for·the·returned·slice·is·inferred·from·its·usage.·To	43	<p>The·lifetime·for·the·returned·slice·is·inferred·from·its·usage.·To
44	prevent·accidental·misuse,·it’s·suggested·to·tie·the·lifetime·to·whichever	44	prevent·accidental·misuse,·it’s·suggested·to·tie·the·lifetime·to·whichever
45	source·lifetime·is·safe·in·the·context,·such·as·by·providing·a·helper	45	source·lifetime·is·safe·in·the·context,·such·as·by·providing·a·helper
46	function·taking·the·lifetime·of·a·host·value·for·the·slice,·or·by·explicit	46	function·taking·the·lifetime·of·a·host·value·for·the·slice,·or·by·explicit


Offset 1, 20 lines modified		Offset 1, 20 lines modified
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="Forms·a·slice·from·a·pointer·range."><title>from_ptr_range·in·alloc::slice·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4»2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">from_<wbr>ptr_<wbr>range</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#safety"·title="Safety">Safety</a></li><li><a·href="#panics"·title="Panics">Panics</a></li><li><a·href="#caveat"·title="Caveat">Caveat</a></li><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>slice</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">slice</a></span><h1>Function·<span·class="fn">from_ptr_range</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="../../src/core/slice/raw.rs.html#273">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·const·unsafe·fn·from_ptr_range<'a,·T>(range:·<a·class="struct"·href="~~../../core/o~~ps/r~~ange/st~~ruct.Range.~~html"·title="struct·~~core::ops::range~~::Range">Ra~~[·...·truncated·by·diffoscope;·len:·~~137~~,·SHA:·~~513b729fee33539a9~~8~~195f1f527ba~~c~~e7cfaeb442b92836~~8~~ff16c5a31a~~969~~0bbc~~·...·]/core/primitive.slice.html">[T]</a></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>slice_from_ptr_range</code> <a·href="https://github.com/rust-lang/rust/issues/89792">#89792</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Forms·a·slice·from·a·pointer·range.</p>	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="Forms·a·slice·from·a·pointer·range."><title>from_ptr_range·in·alloc::slice·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4»2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">from_<wbr>ptr_<wbr>range</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#safety"·title="Safety">Safety</a></li><li><a·href="#panics"·title="Panics">Panics</a></li><li><a·href="#caveat"·title="Caveat">Caveat</a></li><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>slice</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">slice</a></span><h1>Function·<span·class="fn">from_ptr_range</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/slice/raw.rs.html#273">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·const·unsafe·fn·from_ptr_range<'a,·T>(range:·<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ops/range/struct[·...·truncated·by·diffoscope;·len:·245,·SHA:·7a2a3c63d7d5ff72780a460ae8c99c46d53c657dd2595b8b120f79e0c9f953de·...·]/core/primitive.slice.html">[T]</a></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>slice_from_ptr_range</code> <a·href="https://github.com/rust-lang/rust/issues/89792">#89792</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Forms·a·slice·from·a·pointer·range.</p>
2	<p>This·function·is·useful·for·interacting·with·foreign·interfaces·which	2	<p>This·function·is·useful·for·interacting·with·foreign·interfaces·which
3	use·two·pointers·to·refer·to·a·range·of·elements·in·memory,·as·is	3	use·two·pointers·to·refer·to·a·range·of·elements·in·memory,·as·is
4	common·in·C++.</p>	4	common·in·C++.</p>
5	<h2·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h2>	5	<h2·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h2>
6	<p>Behavior·is·undefined·if·any·of·the·following·conditions·are·violated:</p>	6	<p>Behavior·is·undefined·if·any·of·the·following·conditions·are·violated:</p>
7	<ul>	7	<ul>
8	<li>	8	<li>
9	<p>The·<code>start</code>·pointer·of·the·range·must·be·a·non-null,·<a·href="../../core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·and·properly·aligned·pointer	9	<p>The·<code>start</code>·pointer·of·the·range·must·be·a·non-null,·<a·href="https://doc.rust-lang.org/1.85.0/core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·and·properly·aligned·pointer
10	to·the·first·element·of·a·slice.</p>	10	to·the·first·element·of·a·slice.</p>
11	</li>	11	</li>
12	<li>	12	<li>
13	<p>The·<code>end</code>·pointer·must·be·a·<a·href="../../core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·and·properly·aligned·pointer·to·<em>one·past</em>	13	<p>The·<code>end</code>·pointer·must·be·a·<a·href="https://doc.rust-lang.org/1.85.0/core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·and·properly·aligned·pointer·to·<em>one·past</em>
14	the·last·element,·such·that·the·offset·from·the·end·to·the·start·pointer·is	14	the·last·element,·such·that·the·offset·from·the·end·to·the·start·pointer·is
15	the·length·of·the·slice.</p>	15	the·length·of·the·slice.</p>
16	</li>	16	</li>
17	<li>	17	<li>
18	<p>The·entire·memory·range·of·this·slice·must·be·contained·within·a·single·allocated·object!	18	<p>The·entire·memory·range·of·this·slice·must·be·contained·within·a·single·allocated·object!
19	Slices·can·never·span·across·multiple·allocated·objects.</p>	19	Slices·can·never·span·across·multiple·allocated·objects.</p>
20	</li>	20	</li>
Offset 24, 18 lines modified		Offset 24, 18 lines modified
24	<li>	24	<li>
25	<p>The·memory·referenced·by·the·returned·slice·must·not·be·mutated·for·the·duration	25	<p>The·memory·referenced·by·the·returned·slice·must·not·be·mutated·for·the·duration
26	of·lifetime·<code>'a</code>,·except·inside·an·<code>UnsafeCell</code>.</p>	26	of·lifetime·<code>'a</code>,·except·inside·an·<code>UnsafeCell</code>.</p>
27	</li>	27	</li>
28	<li>	28	<li>
29	<p>The·total·length·of·the·range·must·be·no·larger·than·<code>isize::MAX</code>,	29	<p>The·total·length·of·the·range·must·be·no·larger·than·<code>isize::MAX</code>,
30	and·adding·that·size·to·<code>start</code>·must·not·“wrap·around”·the·address·space.	30	and·adding·that·size·to·<code>start</code>·must·not·“wrap·around”·the·address·space.
31	See·the·safety·documentation·of·<a·href="../../core/primitive.pointer.html#method.offset"·title="method·pointer::offset"><code>pointer::offset</code></a>.</p>	31	See·the·safety·documentation·of·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.pointer.html#method.offset"·title="method·pointer::offset"><code>pointer::offset</code></a>.</p>
32	</li>	32	</li>
33	</ul>	33	</ul>
34	<p>Note·that·a·range·created·from·<a·href="../../core/primitive.slice.html#method.as_ptr_range"·title="method·slice::as_ptr_range"><code>slice::as_ptr_range</code></a>·fulfills·these·requirements.</p>	34	<p>Note·that·a·range·created·from·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.slice.html#method.as_ptr_range"·title="method·slice::as_ptr_range"><code>slice::as_ptr_range</code></a>·fulfills·these·requirements.</p>
35	<h2·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h2>	35	<h2·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h2>
36	<p>This·function·panics·if·<code>T</code>·is·a·Zero-Sized·Type·(“ZST”).</p>	36	<p>This·function·panics·if·<code>T</code>·is·a·Zero-Sized·Type·(“ZST”).</p>
37	<h2·id="caveat"><a·class="doc-anchor"·href="#caveat">§</a>Caveat</h2>	37	<h2·id="caveat"><a·class="doc-anchor"·href="#caveat">§</a>Caveat</h2>
38	<p>The·lifetime·for·the·returned·slice·is·inferred·from·its·usage.·To	38	<p>The·lifetime·for·the·returned·slice·is·inferred·from·its·usage.·To
39	prevent·accidental·misuse,·it’s·suggested·to·tie·the·lifetime·to·whichever	39	prevent·accidental·misuse,·it’s·suggested·to·tie·the·lifetime·to·whichever
40	source·lifetime·is·safe·in·the·context,·such·as·by·providing·a·helper	40	source·lifetime·is·safe·in·the·context,·such·as·by·providing·a·helper
41	function·taking·the·lifetime·of·a·host·value·for·the·slice,·or·by·explicit	41	function·taking·the·lifetime·of·a·host·value·for·the·slice,·or·by·explicit


Offset 1, 37 lines modified		Offset 1, 37 lines modified
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="Forms·a·slice·from·a·pointer·and·a·length."><title>from_raw_parts·in·alloc::slice·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)»(built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">from_<wbr>raw_<wbr>parts</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#safety"·title="Safety">Safety</a></li><li><a·href="#caveat"·title="Caveat">Caveat</a></li><li><a·href="#examples"·title="Examples">Examples</a><ul><li><a·href="#incorrect-usage"·title="Incorrect·usage">Incorrect·usage</a></li><li><a·href="#ffi-handling-null-pointers"·title="FFI:·Handling·null·pointers">FFI:·Handling·null·pointers</a></li></ul></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>slice</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">slice</a></span><h1>Function·<span·class="fn">from_raw_parts</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0,·const·since·1.64.0">1.36.0·(const:·1.64.0)</span>···<a·class="src"·href="../../src/core/slice/raw.rs.html#123">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·const·unsafe·fn·from_raw_parts<'a,·T>(data:·<a·class="primitive"·href="~~../../core/~~p~~rimitive.p~~ointer.html~~">*c~~on~~st·T<~~/~~a>,·len:·<a·~~cla~~ss="~~primitive"~~·href~~[·...·truncated·by·diffoscope;·len:·92,·SHA:·~~4b5~~3~~de1~~0ce32a75~~28afba~~1~~f6b6b~~0~~2bf0~~4~~0f9ff132f~~6~~873~~0~~92f~~a~~01770633dce9d~~·...·]/core/primitive.slice.html">[T]</a></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Forms·a·slice·from·a·pointer·and·a·length.</p>	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="Forms·a·slice·from·a·pointer·and·a·length."><title>from_raw_parts·in·alloc::slice·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)»(built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">from_<wbr>raw_<wbr>parts</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#safety"·title="Safety">Safety</a></li><li><a·href="#caveat"·title="Caveat">Caveat</a></li><li><a·href="#examples"·title="Examples">Examples</a><ul><li><a·href="#incorrect-usage"·title="Incorrect·usage">Incorrect·usage</a></li><li><a·href="#ffi-handling-null-pointers"·title="FFI:·Handling·null·pointers">FFI:·Handling·null·pointers</a></li></ul></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>slice</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">slice</a></span><h1>Function·<span·class="fn">from_raw_parts</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.36.0,·const·since·1.64.0">1.36.0·(const:·1.64.0)</span>···<a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/slice/raw.rs.html#123">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·const·unsafe·fn·from_raw_parts<'a,·T>(data:·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.poin[·...·truncated·by·diffoscope;·len:·200,·SHA:·daa37b60e25ce1bef139d45067dd4eded786666140608b8ca1bbe812af968118·...·]/core/primitive.slice.html">[T]</a></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Forms·a·slice·from·a·pointer·and·a·length.</p>
2	<p>The·<code>len</code>·argument·is·the·number·of·<strong>elements</strong>,·not·the·number·of·bytes.</p>	2	<p>The·<code>len</code>·argument·is·the·number·of·<strong>elements</strong>,·not·the·number·of·bytes.</p>
3	<h2·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h2>	3	<h2·id="safety"><a·class="doc-anchor"·href="#safety">§</a>Safety</h2>
4	<p>Behavior·is·undefined·if·any·of·the·following·conditions·are·violated:</p>	4	<p>Behavior·is·undefined·if·any·of·the·following·conditions·are·violated:</p>
5	<ul>	5	<ul>
6	<li>	6	<li>
7	<p><code>data</code>·must·be·non-null,·<a·href="../../core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·for·reads·for·<code>len·*·mem::size_of::<T>()</code>·many·bytes,	7	<p><code>data</code>·must·be·non-null,·<a·href="https://doc.rust-lang.org/1.85.0/core/ptr/index.html#safety"·title="mod·core::ptr">valid</a>·for·reads·for·<code>len·*·mem::size_of::<T>()</code>·many·bytes,
8	and·it·must·be·properly·aligned.·This·means·in·particular:</p>	8	and·it·must·be·properly·aligned.·This·means·in·particular:</p>
9	<ul>	9	<ul>
10	<li>The·entire·memory·range·of·this·slice·must·be·contained·within·a·single·allocated·object!	10	<li>The·entire·memory·range·of·this·slice·must·be·contained·within·a·single·allocated·object!
11	Slices·can·never·span·across·multiple·allocated·objects.·See·<a·href="#incorrect-usage">below</a>	11	Slices·can·never·span·across·multiple·allocated·objects.·See·<a·href="#incorrect-usage">below</a>
12	for·an·example·incorrectly·not·taking·this·into·account.</li>	12	for·an·example·incorrectly·not·taking·this·into·account.</li>
13	<li><code>data</code>·must·be·non-null·and·aligned·even·for·zero-length·slices·or·slices·of·ZSTs.·One	13	<li><code>data</code>·must·be·non-null·and·aligned·even·for·zero-length·slices·or·slices·of·ZSTs.·One
14	reason·for·this·is·that·enum·layout·optimizations·may·rely·on·references	14	reason·for·this·is·that·enum·layout·optimizations·may·rely·on·references
15	(including·slices·of·any·length)·being·aligned·and·non-null·to·distinguish	15	(including·slices·of·any·length)·being·aligned·and·non-null·to·distinguish
16	them·from·other·data.·You·can·obtain·a·pointer·that·is·usable·as·<code>data</code>	16	them·from·other·data.·You·can·obtain·a·pointer·that·is·usable·as·<code>data</code>
17	for·zero-length·slices·using·<a·href="../../core/ptr/non_null/struct.NonNull.html#method.dangling"·title="associated·function·core::ptr::non_null::NonNull::dangling"><code>NonNull::dangling()</code></a>.</li>	17	for·zero-length·slices·using·<a·href="https://doc.rust-lang.org/1.85.0/core/ptr/non_null/struct.NonNull.html#method.dangling"·title="associated·function·core::ptr::non_null::NonNull::dangling"><code>NonNull::dangling()</code></a>.</li>
18	</ul>	18	</ul>
19	</li>	19	</li>
20	<li>	20	<li>
21	<p><code>data</code>·must·point·to·<code>len</code>·consecutive·properly·initialized·values·of·type·<code>T</code>.</p>	21	<p><code>data</code>·must·point·to·<code>len</code>·consecutive·properly·initialized·values·of·type·<code>T</code>.</p>
22	</li>	22	</li>
23	<li>	23	<li>
24	<p>The·memory·referenced·by·the·returned·slice·must·not·be·mutated·for·the·duration	24	<p>The·memory·referenced·by·the·returned·slice·must·not·be·mutated·for·the·duration
25	of·lifetime·<code>'a</code>,·except·inside·an·<code>UnsafeCell</code>.</p>	25	of·lifetime·<code>'a</code>,·except·inside·an·<code>UnsafeCell</code>.</p>
26	</li>	26	</li>
27	<li>	27	<li>
28	<p>The·total·size·<code>len·*·mem::size_of::<T>()</code>·of·the·slice·must·be·no·larger·than·<code>isize::MAX</code>,	28	<p>The·total·size·<code>len·*·mem::size_of::<T>()</code>·of·the·slice·must·be·no·larger·than·<code>isize::MAX</code>,
29	and·adding·that·size·to·<code>data</code>·must·not·“wrap·around”·the·address·space.	29	and·adding·that·size·to·<code>data</code>·must·not·“wrap·around”·the·address·space.
30	See·the·safety·documentation·of·<a·href="../../core/primitive.pointer.html#method.offset"·title="method·pointer::offset"><code>pointer::offset</code></a>.</p>	30	See·the·safety·documentation·of·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.pointer.html#method.offset"·title="method·pointer::offset"><code>pointer::offset</code></a>.</p>
31	</li>	31	</li>
32	</ul>	32	</ul>
33	<h2·id="caveat"><a·class="doc-anchor"·href="#caveat">§</a>Caveat</h2>	33	<h2·id="caveat"><a·class="doc-anchor"·href="#caveat">§</a>Caveat</h2>
34	<p>The·lifetime·for·the·returned·slice·is·inferred·from·its·usage.·To	34	<p>The·lifetime·for·the·returned·slice·is·inferred·from·its·usage.·To
35	prevent·accidental·misuse,·it’s·suggested·to·tie·the·lifetime·to·whichever	35	prevent·accidental·misuse,·it’s·suggested·to·tie·the·lifetime·to·whichever
36	source·lifetime·is·safe·in·the·context,·such·as·by·providing·a·helper	36	source·lifetime·is·safe·in·the·context,·such·as·by·providing·a·helper
37	function·taking·the·lifetime·of·a·host·value·for·the·slice,·or·by·explicit	37	function·taking·the·lifetime·of·a·host·value·for·the·slice,·or·by·explicit


Offset 1, 28 lines modified		Offset 1, 28 lines modified
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="Performs·bounds·checking·of·a·range."><title>range·in·alloc::slice·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">range</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#panics"·title="Panics">Panics</a></li><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>slice</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">slice</a></span><h1>Function·<span·class="fn">range</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="../../src/core/slice/index.rs.html#835-837">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·range<R>(range:·R,·bounds:·<a·class="struct"·href="~~../../core/o~~ps/r~~ange/st~~ruct.Rang~~eTo~~.~~html"·title="struct·~~core::ops::range~~::RangeTo">~~RangeTo[·...·truncated·by·diffoscope;·len:·237,·SHA:·11efb6f6cb4ab~~feb419~~35~~3dc~~8~~1666~~5~~51c85~~8f6abf079a883e7c5ae4298~~0559c4~~·...·]/core/primitive.usize.html">usize</a>><div·class="where">where	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="Performs·bounds·checking·of·a·range."><title>range·in·alloc::slice·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">range</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#panics"·title="Panics">Panics</a></li><li><a·href="#examples"·title="Examples">Examples</a></li></ul></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>slice</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">slice</a></span><h1>Function·<span·class="fn">range</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/slice/index.rs.html#835-837">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·range<R>(range:·R,·bounds:·<a·class="struct"·href="https://doc.rust-lang.org/1.85.0/core/ops/range/struct.RangeTo.[·...·truncated·by·diffoscope;·len:·372,·SHA:·28e8fcd2b2d64babc21ace3ff08c0b25682118ea572899e67c545238ffad83e8·...·]/core/primitive.usize.html">usize</a>><div·class="where">where
2	····R:·<a·class="trait"·href="../../core/ops/range/trait.RangeBounds.html"·title="trait·core::ops::range::RangeBounds">RangeBounds</a><<a·class="primitive"·href="../../core/primitive.usize.html">usize</a>>,</div></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>slice_range</code> <a·href="https://github.com/rust-lang/rust/issues/76393">#76393</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Performs·bounds·checking·of·a·range.</p>	2	····R:·<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/ops/range/trait.RangeBounds.html"·title="trait·core::ops::range::RangeBounds">RangeBounds</a><<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.usize.html">usize</a>>,</div></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>slice_range</code> <a·href="https://github.com/rust-lang/rust/issues/76393">#76393</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Performs·bounds·checking·of·a·range.</p>
3	<p>This·method·is·similar·to·<a·href="../../core/ops/index/trait.Index.html#tymethod.index"·title="method·core::ops::index::Index::index"><code>Index::index</code></a>·for·slices,·but·it·returns·a	3	<p>This·method·is·similar·to·<a·href="https://doc.rust-lang.org/1.85.0/core/ops/index/trait.Index.html#tymethod.index"·title="method·core::ops::index::Index::index"><code>Index::index</code></a>·for·slices,·but·it·returns·a
4	<a·href="../../core/ops/range/struct.Range.html"·title="struct·core::ops::range::Range"><code>Range</code></a>·equivalent·to·<code>range</code>.·You·can·use·this·method·to·turn·any·range	4	<a·href="https://doc.rust-lang.org/1.85.0/core/ops/range/struct.Range.html"·title="struct·core::ops::range::Range"><code>Range</code></a>·equivalent·to·<code>range</code>.·You·can·use·this·method·to·turn·any·range
5	into·<code>start</code>·and·<code>end</code>·values.</p>	5	into·<code>start</code>·and·<code>end</code>·values.</p>
6	<p><code>bounds</code>·is·the·range·of·the·slice·to·use·for·bounds·checking.·It·should	6	<p><code>bounds</code>·is·the·range·of·the·slice·to·use·for·bounds·checking.·It·should
7	be·a·<a·href="../../core/ops/range/struct.RangeTo.html"·title="struct·core::ops::range::RangeTo"><code>RangeTo</code></a>·range·that·ends·at·the·length·of·the·slice.</p>	7	be·a·<a·href="https://doc.rust-lang.org/1.85.0/core/ops/range/struct.RangeTo.html"·title="struct·core::ops::range::RangeTo"><code>RangeTo</code></a>·range·that·ends·at·the·length·of·the·slice.</p>
8	<p>The·returned·<a·href="../../core/ops/range/struct.Range.html"·title="struct·core::ops::range::Range"><code>Range</code></a>·is·safe·to·pass·to·<a·href="../../core/primitive.slice.html#method.get_unchecked"·title="method·slice::get_unchecked"><code>slice::get_unchecked</code></a>·and	8	<p>The·returned·<a·href="https://doc.rust-lang.org/1.85.0/core/ops/range/struct.Range.html"·title="struct·core::ops::range::Range"><code>Range</code></a>·is·safe·to·pass·to·<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.slice.html#method.get_unchecked"·title="method·slice::get_unchecked"><code>slice::get_unchecked</code></a>·and
9	<a·href="../../core/primitive.slice.html#method.get_unchecked_mut"·title="method·slice::get_unchecked_mut"><code>slice::get_unchecked_mut</code></a>·for·slices·with·the·given·range.</p>	9	<a·href="https://doc.rust-lang.org/1.85.0/core/primitive.slice.html#method.get_unchecked_mut"·title="method·slice::get_unchecked_mut"><code>slice::get_unchecked_mut</code></a>·for·slices·with·the·given·range.</p>
10	<h2·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h2>	10	<h2·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h2>
11	<p>Panics·if·<code>range</code>·would·be·out·of·bounds.</p>	11	<p>Panics·if·<code>range</code>·would·be·out·of·bounds.</p>
12	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>	12	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>
13	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="attr">#![feature(slice_range)]	13	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="attr">#![feature(slice_range)]

14	</span><span·class="kw">use·</span>std::slice;	14	</span><span·class="kw">use·</span>std::slice;

15	<span·class="kw">let·</span>v·=·[<span·class="number">10</span>,·<span·class="number">40</span>,·<span·class="number">30</span>];	15	<span·class="kw">let·</span>v·=·[<span·class="number">10</span>,·<span·class="number">40</span>,·<span·class="number">30</span>];
16	<span·class="macro">assert_eq!</span>(<span·class="number">1</span>..<span·class="number">2</span>,·slice::range(<span·class="number">1</span>..<span·class="number">2</span>,·..v.len()));	16	<span·class="macro">assert_eq!</span>(<span·class="number">1</span>..<span·class="number">2</span>,·slice::range(<span·class="number">1</span>..<span·class="number">2</span>,·..v.len()));
17	<span·class="macro">assert_eq!</span>(<span·class="number">0</span>..<span·class="number">2</span>,·slice::range(..<span·class="number">2</span>,·..v.len()));	17	<span·class="macro">assert_eq!</span>(<span·class="number">0</span>..<span·class="number">2</span>,·slice::range(..<span·class="number">2</span>,·..v.len()));
18	<span·class="macro">assert_eq!</span>(<span·class="number">1</span>..<span·class="number">3</span>,·slice::range(<span·class="number">1</span>..,·..v.len()));</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(slice_range)%5D%0A%0Afn+main()+%7B%0A++++use+std::slice;%0A++++%0A++++let+v+=+%5B10,+40,+30%5D;%0A++++assert_eq!(1..2,+slice::range(1..2,+..v.len()));%0A++++assert_eq!(0..2,+slice::range(..2,+..v.len()));%0A++++assert_eq!(1..3,+slice::range(1..,+..v.len()));%0A%7D&version=nightly&edition=2021"></a></div>	18	<span·class="macro">assert_eq!</span>(<span·class="number">1</span>..<span·class="number">3</span>,·slice::range(<span·class="number">1</span>..,·..v.len()));</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(slice_range)%5D%0A%0Afn+main()+%7B%0A++++use+std::slice;%0A++++%0A++++let+v+=+%5B10,+40,+30%5D;%0A++++assert_eq!(1..2,+slice::range(1..2,+..v.len()));%0A++++assert_eq!(0..2,+slice::range(..2,+..v.len()));%0A++++assert_eq!(1..3,+slice::range(1..,+..v.len()));%0A%7D&version=nightly&edition=2021"></a></div>
19	<p>Panics·when·<a·href="../../core/ops/index/trait.Index.html#tymethod.index"·title="method·core::ops::index::Index::index"><code>Index::index</code></a>·would·panic:</p>	19	<p>Panics·when·<a·href="https://doc.rust-lang.org/1.85.0/core/ops/index/trait.Index.html#tymethod.index"·title="method·core::ops::index::Index::index"><code>Index::index</code></a>·would·panic:</p>

20	<div·class="example-wrap·should_panic"><a·href="#"·class="tooltip"·title="This·example·panics">ⓘ</a><pre·class="rust·rust-example-rendered"><code><span·class="attr">#![feature(slice_range)]	20	<div·class="example-wrap·should_panic"><a·href="#"·class="tooltip"·title="This·example·panics">ⓘ</a><pre·class="rust·rust-example-rendered"><code><span·class="attr">#![feature(slice_range)]

21	</span><span·class="kw">use·</span>std::slice;	21	</span><span·class="kw">use·</span>std::slice;

22	<span·class="kw">let·_·</span>=·slice::range(<span·class="number">2</span>..<span·class="number">1</span>,·..<span·class="number">3</span>);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(slice_range)%5D%0A%0Afn+main()+%7B%0A++++use+std::slice;%0A++++%0A++++let+_+=+slice::range(2..1,+..3);%0A%7D&version=nightly&edition=2021"></a></div>	22	<span·class="kw">let·_·</span>=·slice::range(<span·class="number">2</span>..<span·class="number">1</span>,·..<span·class="number">3</span>);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(slice_range)%5D%0A%0Afn+main()+%7B%0A++++use+std::slice;%0A++++%0A++++let+_+=+slice::range(2..1,+..3);%0A%7D&version=nightly&edition=2021"></a></div>


Offset 1, 11 lines modified		Offset 1, 11 lines modified
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="Creates·a·`&mut·str`·from·a·pointer·and·a·length."><title>from_raw_parts_mut·in·alloc::str·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>str</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">str</a></span><h1>Function·<span·class="fn">from_raw_parts_mut</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="../../src/core/str/converts.rs.html#239">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·const·unsafe·fn·from_raw_parts_mut<'a>(	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="Creates·a·`&mut·str`·from·a·pointer·and·a·length."><title>from_raw_parts_mut·in·alloc::str·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·fn"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>str</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">str</a></span><h1>Function·<span·class="fn">from_raw_parts_mut</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><a·class="src"·href="https://doc.rust-lang.org/1.85.0/src/core/str/converts.rs.html#239">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·const·unsafe·fn·from_raw_parts_mut<'a>(
2	····ptr:·<a·class="primitive"·href="../../core/primitive.pointer.html">*mut·</a><a·class="primitive"·href="../../core/primitive.u8.html">u8</a>,	2	····ptr:·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.pointer.html">*mut·</a><a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.u8.html">u8</a>,
3	····len:·<a·class="primitive"·href="../../core/primitive.usize.html">usize</a>,	3	····len:·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.usize.html">usize</a>,
4	)·->·&'a·mut·<a·class="primitive"·href="../../core/primitive.str.html">str</a></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>str_from_raw_parts</code> <a·href="https://github.com/rust-lang/rust/issues/119206">#119206</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Creates·a·<code>&mut·str</code>·from·a·pointer·and·a·length.</p>	4	)·->·&'a·mut·<a·class="primitive"·href="https://doc.rust-lang.org/1.85.0/core/primitive.str.html">str</a></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>str_from_raw_parts</code> <a·href="https://github.com/rust-lang/rust/issues/119206">#119206</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Creates·a·<code>&mut·str</code>·from·a·pointer·and·a·length.</p>
5	<p>The·pointed-to·bytes·must·be·valid·UTF-8.	5	<p>The·pointed-to·bytes·must·be·valid·UTF-8.
6	If·this·might·not·be·the·case,·use·<code>str::from_utf8_mut(slice::from_raw_parts_mut(ptr,·len))</code>,	6	If·this·might·not·be·the·case,·use·<code>str::from_utf8_mut(slice::from_raw_parts_mut(ptr,·len))</code>,
7	which·will·return·an·<code>Err</code>·if·the·data·isn’t·valid·UTF-8.</p>	7	which·will·return·an·<code>Err</code>·if·the·data·isn’t·valid·UTF-8.</p>
8	<p>This·function·is·the·<code>str</code>·equivalent·of·<a·href="../slice/fn.from_raw_parts_mut.html"·title="fn·alloc::slice::from_raw_parts_mut"><code>slice::from_raw_parts_mut</code></a>.	8	<p>This·function·is·the·<code>str</code>·equivalent·of·<a·href="../slice/fn.from_raw_parts_mut.html"·title="fn·alloc::slice::from_raw_parts_mut"><code>slice::from_raw_parts_mut</code></a>.
9	See·that·function’s·documentation·for·safety·concerns·and·examples.</p>	9	See·that·function’s·documentation·for·safety·concerns·and·examples.</p>
10	<p>The·immutable·version·of·this·function·is·<a·href="fn.from_raw_parts.html"·title="fn·alloc::str::from_raw_parts"><code>from_raw_parts</code></a>.</p>	10	<p>The·immutable·version·of·this·function·is·<a·href="fn.from_raw_parts.html"·title="fn·alloc::str::from_raw_parts"><code>from_raw_parts</code></a>.</p>
11	</div></details></section></div></main></body></html>	11	</div></details></section></div></main></body></html>


Offset 24, 8 lines modified		Offset 24, 8 lines modified
24	</span><span·class="kw">let·</span>sparkle_heart·=·String::from_utf8(sparkle_heart).unwrap();	24	</span><span·class="kw">let·</span>sparkle_heart·=·String::from_utf8(sparkle_heart).unwrap();

25	<span·class="macro">assert_eq!</span>(<span·class="string">"💖"</span>,·sparkle_heart);	25	<span·class="macro">assert_eq!</span>(<span·class="string">"💖"</span>,·sparkle_heart);

26	<span·class="kw">let·</span>bytes·=·sparkle_heart.into_bytes();	26	<span·class="kw">let·</span>bytes·=·sparkle_heart.into_bytes();

27	<span·class="macro">assert_eq!</span>(bytes,·[<span·class="number">240</span>,·<span·class="number">159</span>,·<span·class="number">146</span>,·<span·class="number">150</span>]);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+sparkle_heart+=+vec!%5B240,+159,+146,+150%5D;%0A++++%0A++++//+We+know+these+bytes+are+valid,+so+we'll+use+%60unwrap()%60.%0A++++let+sparkle_heart+=+String::from_utf8(sparkle_heart).unwrap();%0A++++%0A++++assert_eq!(%22%F0%9F%92%96%22,+sparkle_heart);%0A++++%0A++++let+bytes+=+sparkle_heart.into_bytes();%0A++++%0A++++assert_eq!(bytes,+%5B240,+159,+146,+150%5D);%0A%7D&edition=2021"></a></div>	27	<span·class="macro">assert_eq!</span>(bytes,·[<span·class="number">240</span>,·<span·class="number">159</span>,·<span·class="number">146</span>,·<span·class="number">150</span>]);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+sparkle_heart+=+vec!%5B240,+159,+146,+150%5D;%0A++++%0A++++//+We+know+these+bytes+are+valid,+so+we'll+use+%60unwrap()%60.%0A++++let+sparkle_heart+=+String::from_utf8(sparkle_heart).unwrap();%0A++++%0A++++assert_eq!(%22%F0%9F%92%96%22,+sparkle_heart);%0A++++%0A++++let+bytes+=+sparkle_heart.into_bytes();%0A++++%0A++++assert_eq!(bytes,+%5B240,+159,+146,+150%5D);%0A%7D&edition=2021"></a></div>
28	</div></details><h2·id="structs"·class="section-header">Structs<a·href="#structs"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="struct"·href="struct.Drain.html"·title="struct·alloc::string::Drain">Drain</a></div><div·class="desc·docblock-short">A·draining·iterator·for·<code>String</code>.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.FromUtf8Error.html"·title="struct·alloc::string::FromUtf8Error">From<wbr>Utf8<wbr>Error</a></div><div·class="desc·docblock-short">A·possible·error·value·when·converting·a·<code>String</code>·from·a·UTF-8·byte·vector.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.FromUtf16Error.html"·title="struct·alloc::string::FromUtf16Error">From<wbr>Utf16<wbr>Error</a></div><div·class="desc·docblock-short">A·possible·error·value·when·converting·a·<code>String</code>·from·a·UTF-16·byte·slice.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.String.html"·title="struct·alloc::string::String">String</a></div><div·class="desc·docblock-short">A·UTF-8–encoded,·growable·string.</div></li></ul><h2·id="traits"·class="section-header">Traits<a·href="#traits"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="trait"·href="trait.ToString.html"·title="trait·alloc::string::ToString">ToString</a></div><div·class="desc·docblock-short">A·trait·for·converting·a·value·to·a·<code>String</code>.</div></li></ul><h2·id="types"·class="section-header">Type·Aliases<a·href="#types"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="type"·href="type.ParseError.html"·title="type·alloc::string::ParseError">Parse<wbr>Error</a></div><div·class="desc·docblock-short">A·type·alias·for·<a·href="../../core/convert/enum.Infallible.html"·title="convert::Infallible"><code>Infallible</code></a>.</div></li></ul></section></div></main></body></html>	28	</div></details><h2·id="structs"·class="section-header">Structs<a·href="#structs"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="struct"·href="struct.Drain.html"·title="struct·alloc::string::Drain">Drain</a></div><div·class="desc·docblock-short">A·draining·iterator·for·<code>String</code>.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.FromUtf8Error.html"·title="struct·alloc::string::FromUtf8Error">From<wbr>Utf8<wbr>Error</a></div><div·class="desc·docblock-short">A·possible·error·value·when·converting·a·<code>String</code>·from·a·UTF-8·byte·vector.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.FromUtf16Error.html"·title="struct·alloc::string::FromUtf16Error">From<wbr>Utf16<wbr>Error</a></div><div·class="desc·docblock-short">A·possible·error·value·when·converting·a·<code>String</code>·from·a·UTF-16·byte·slice.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.String.html"·title="struct·alloc::string::String">String</a></div><div·class="desc·docblock-short">A·UTF-8–encoded,·growable·string.</div></li></ul><h2·id="traits"·class="section-header">Traits<a·href="#traits"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="trait"·href="trait.ToString.html"·title="trait·alloc::string::ToString">ToString</a></div><div·class="desc·docblock-short">A·trait·for·converting·a·value·to·a·<code>String</code>.</div></li></ul><h2·id="types"·class="section-header">Type·Aliases<a·href="#types"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="type"·href="type.ParseError.html"·title="type·alloc::string::ParseError">Parse<wbr>Error</a></div><div·class="desc·docblock-short">A·type·alias·for·<a·href="https://doc.rust-lang.org/1.85.0/core/convert/enum.Infallible.html"·title="convert::Infallible"><code>Infallible</code></a>.</div></li></ul></section></div></main></body></html>


Offset 8, 13 lines modified		Offset 8, 13 lines modified
8	implementation·for·free.</p>	8	implementation·for·free.</p>
9	</div></details><h2·id="required-methods"·class="section-header">Required·Methods<a·href="#required-methods"·class="anchor">§</a></h2><div·class="methods"><details·class="toggle·method-toggle"·open><summary><section·id="tymethod.to_string"·class="method"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.0.0">1.0.0</span>···<a·class="src"·href="../../src/alloc/string.rs.html#2666">Source</a></span><h4·class="code-header">fn·<a·href="#tymethod.to_string"·class="fn">to_string</a>(&self)·->·<a·class="struct"·href="struct.String.html"·title="struct·alloc::string::String">String</a></h4></section></summary><div·class="docblock"><p>Converts·the·given·value·to·a·<code>String</code>.</p>	9	</div></details><h2·id="required-methods"·class="section-header">Required·Methods<a·href="#required-methods"·class="anchor">§</a></h2><div·class="methods"><details·class="toggle·method-toggle"·open><summary><section·id="tymethod.to_string"·class="method"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.0.0">1.0.0</span>···<a·class="src"·href="../../src/alloc/string.rs.html#2666">Source</a></span><h4·class="code-header">fn·<a·href="#tymethod.to_string"·class="fn">to_string</a>(&self)·->·<a·class="struct"·href="struct.String.html"·title="struct·alloc::string::String">String</a></h4></section></summary><div·class="docblock"><p>Converts·the·given·value·to·a·<code>String</code>.</p>
10	<h5·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h5>	10	<h5·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h5>
11	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>i·=·<span·class="number">5</span>;	11	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span>i·=·<span·class="number">5</span>;
12	<span·class="kw">let·</span>five·=·String::from(<span·class="string">"5"</span>);	12	<span·class="kw">let·</span>five·=·String::from(<span·class="string">"5"</span>);

13	<span·class="macro">assert_eq!</span>(five,·i.to_string());</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+i+=+5;%0A++++let+five+=+String::from(%225%22);%0A++++%0A++++assert_eq!(five,+i.to_string());%0A%7D&edition=2021"></a></div>	13	<span·class="macro">assert_eq!</span>(five,·i.to_string());</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+i+=+5;%0A++++let+five+=+String::from(%225%22);%0A++++%0A++++assert_eq!(five,+i.to_string());%0A%7D&edition=2021"></a></div>
14	</div></details></div><h2·id="implementors"·class="section-header">Implementors<a·href="#implementors"·class="anchor">§</a></h2><div·id="implementors-list"><section·id="impl-ToString-for-T"·class="impl"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.0.0">1.0.0</span>···<a·class="src"·href="../../src/alloc/string.rs.html#2677-2682">Source</a></span><a·href="#impl-ToString-for-T"·class="anchor">§</a><h3·class="code-header">impl<T:·<a·class="trait"·href="../fmt/trait.Display.html"·title="trait·alloc::fmt::Display">Display</a>·+·?<a·class="trait"·href="../../core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>>·<a·class="trait"·href="trait.ToString.html"·title="trait·alloc::string::ToString">ToString</a>·for·T</h3><div·class="docblock"><h4·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h4>	14	</div></details></div><h2·id="implementors"·class="section-header">Implementors<a·href="#implementors"·class="anchor">§</a></h2><div·id="implementors-list"><section·id="impl-ToString-for-T"·class="impl"><span·class="rightside"><span·class="since"·title="Stable·since·Rust·version·1.0.0">1.0.0</span>···<a·class="src"·href="../../src/alloc/string.rs.html#2677-2682">Source</a></span><a·href="#impl-ToString-for-T"·class="anchor">§</a><h3·class="code-header">impl<T:·<a·class="trait"·href="../fmt/trait.Display.html"·title="trait·alloc::fmt::Display">Display</a>·+·?<a·class="trait"·href="https://doc.rust-lang.org/1.85.0/core/marker/trait.Sized.html"·title="trait·core::marker::Sized">Sized</a>>·<a·class="trait"·href="trait.ToString.html"·title="trait·alloc::string::ToString">ToString</a>·for·T</h3><div·class="docblock"><h4·id="panics"><a·class="doc-anchor"·href="#panics">§</a>Panics</h4>
15	<p>In·this·implementation,·the·<code>to_string</code>·method·panics	15	<p>In·this·implementation,·the·<code>to_string</code>·method·panics
16	if·the·<code>Display</code>·implementation·returns·an·error.	16	if·the·<code>Display</code>·implementation·returns·an·error.
17	This·indicates·an·incorrect·<code>Display</code>·implementation	17	This·indicates·an·incorrect·<code>Display</code>·implementation
18	since·<code>fmt::Write·for·String</code>·never·returns·an·error·itself.</p>	18	since·<code>fmt::Write·for·String</code>·never·returns·an·error·itself.</p>
19	</div></section></div><script·src="../../trait.impl/alloc/string/trait.ToString.js"·async></script></section></div></main></body></html>	19	</div></section></div><script·src="../../trait.impl/alloc/string/trait.ToString.js"·async></script></section></div></main></body></html>


Offset 84, 9 lines modified		Offset 84, 9 lines modified
84	block_on(<span·class="kw">async·</span>{	84	block_on(<span·class="kw">async·</span>{
85	····<span·class="macro">println!</span>(<span·class="string">"hello·world"</span>);	85	····<span·class="macro">println!</span>(<span·class="string">"hello·world"</span>);
86	});</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(local_waker)%5D%0Afn+main()+%7B%0A++++use+std::task::%7BLocalWake,+ContextBuilder,+LocalWaker,+Waker%7D;%0A++++use+std::future::Future;%0A++++use+std::pin::Pin;%0A++++use+std::rc::Rc;%0A++++use+std::cell::RefCell;%0A++++use+std::collections::VecDeque;%0A++++%0A++++%0A++++thread_local!+%7B%0A++++++++//+A+queue+containing+all+tasks+ready+to+do+progress%0A++++++++static+RUN_QUEUE:+RefCell%3CVecDeque%3CRc%3CTask%3E%3E%3E+=+RefCell::default();%0A++++%7D%0A++++%0A++++type+BoxedFuture+=+Pin%3CBox%3Cdyn+Future%3COutput+=+()%3E%3E%3E;%0A++++%0A++++struct+Task(RefCell%3CBoxedFuture%3E);%0A++++%0A++++impl+LocalWake+for+Task+%7B%0A++++++++fn+wake(self:+Rc%3CSelf%3E)+%7B%0A++++++++++++RUN_QUEUE.with_borrow_mut(%7Cqueue%7C+%7B%0A++++++++++++++++queue.push_back(self)%0A++++++++++++%7D)%0A++++++++%7D%0A++++%7D%0A++++%0A++++fn+spawn%3CF%3E(future:+F)%0A++++where%0A++++++++F:+Future%3COutput=()%3E+%2B+'static+%2B+Send+%2B+Sync%0A++++%7B%0A++++++++let+task+=+RefCell::new(Box::pin(future));%0A++++++++RUN_QUEUE.with_borrow_mut(%7Cqueue%7C+%7B%0A++++++++++++queue.push_back(Rc::new(Task(task)));%0A++++++++%7D);%0A++++%7D%0A++++%0A++++fn+block_on%3CF%3E(future:+F)%0A++++where%0A++++++++F:+Future%3COutput=()%3E+%2B+'static+%2B+Sync+%2B+Send%0A++++%7B%0A++++++++spawn(future);%0A++++++++loop+%7B%0A++++++++++++let+Some(task)+=+RUN_QUEUE.with_borrow_mut(%7Cqueue%7C+queue.pop_front())+else+%7B%0A++++++++++++++++//+we+exit,+since+there+are+no+more+tasks+remaining+on+the+queue%0A++++++++++++++++return;%0A++++++++++++%7D;%0A++++%0A++++++++++++//+cast+the+Rc%3CTask%3E+into+a+%60LocalWaker%60%0A++++++++++++let+local_waker:+LocalWaker+=+task.clone().into();%0A++++++++++++//+Build+the+context+using+%60ContextBuilder%60%0A++++++++++++let+mut+cx+=+ContextBuilder::from_waker(Waker::noop())%0A++++++++++++++++.local_waker(%26local_waker)%0A++++++++++++++++.build();%0A++++%0A++++++++++++//+Poll+the+task%0A++++++++++++let+_+=+task.0%0A++++++++++++++++.borrow_mut()%0A++++++++++++++++.as_mut()%0A++++++++++++++++.poll(%26mut+cx);%0A++++++++%7D%0A++++%7D%0A++++%0A++++block_on(async+%7B%0A++++++++println!(%22hello+world%22);%0A++++%7D);%0A%7D&version=nightly&edition=2021"></a></div>	86	});</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0A%23!%5Bfeature(local_waker)%5D%0Afn+main()+%7B%0A++++use+std::task::%7BLocalWake,+ContextBuilder,+LocalWaker,+Waker%7D;%0A++++use+std::future::Future;%0A++++use+std::pin::Pin;%0A++++use+std::rc::Rc;%0A++++use+std::cell::RefCell;%0A++++use+std::collections::VecDeque;%0A++++%0A++++%0A++++thread_local!+%7B%0A++++++++//+A+queue+containing+all+tasks+ready+to+do+progress%0A++++++++static+RUN_QUEUE:+RefCell%3CVecDeque%3CRc%3CTask%3E%3E%3E+=+RefCell::default();%0A++++%7D%0A++++%0A++++type+BoxedFuture+=+Pin%3CBox%3Cdyn+Future%3COutput+=+()%3E%3E%3E;%0A++++%0A++++struct+Task(RefCell%3CBoxedFuture%3E);%0A++++%0A++++impl+LocalWake+for+Task+%7B%0A++++++++fn+wake(self:+Rc%3CSelf%3E)+%7B%0A++++++++++++RUN_QUEUE.with_borrow_mut(%7Cqueue%7C+%7B%0A++++++++++++++++queue.push_back(self)%0A++++++++++++%7D)%0A++++++++%7D%0A++++%7D%0A++++%0A++++fn+spawn%3CF%3E(future:+F)%0A++++where%0A++++++++F:+Future%3COutput=()%3E+%2B+'static+%2B+Send+%2B+Sync%0A++++%7B%0A++++++++let+task+=+RefCell::new(Box::pin(future));%0A++++++++RUN_QUEUE.with_borrow_mut(%7Cqueue%7C+%7B%0A++++++++++++queue.push_back(Rc::new(Task(task)));%0A++++++++%7D);%0A++++%7D%0A++++%0A++++fn+block_on%3CF%3E(future:+F)%0A++++where%0A++++++++F:+Future%3COutput=()%3E+%2B+'static+%2B+Sync+%2B+Send%0A++++%7B%0A++++++++spawn(future);%0A++++++++loop+%7B%0A++++++++++++let+Some(task)+=+RUN_QUEUE.with_borrow_mut(%7Cqueue%7C+queue.pop_front())+else+%7B%0A++++++++++++++++//+we+exit,+since+there+are+no+more+tasks+remaining+on+the+queue%0A++++++++++++++++return;%0A++++++++++++%7D;%0A++++%0A++++++++++++//+cast+the+Rc%3CTask%3E+into+a+%60LocalWaker%60%0A++++++++++++let+local_waker:+LocalWaker+=+task.clone().into();%0A++++++++++++//+Build+the+context+using+%60ContextBuilder%60%0A++++++++++++let+mut+cx+=+ContextBuilder::from_waker(Waker::noop())%0A++++++++++++++++.local_waker(%26local_waker)%0A++++++++++++++++.build();%0A++++%0A++++++++++++//+Poll+the+task%0A++++++++++++let+_+=+task.0%0A++++++++++++++++.borrow_mut()%0A++++++++++++++++.as_mut()%0A++++++++++++++++.poll(%26mut+cx);%0A++++++++%7D%0A++++%7D%0A++++%0A++++block_on(async+%7B%0A++++++++println!(%22hello+world%22);%0A++++%7D);%0A%7D&version=nightly&edition=2021"></a></div>
87	</div></details><h2·id="required-methods"·class="section-header">Required·Methods<a·href="#required-methods"·class="anchor">§</a></h2><div·class="methods"><details·class="toggle·method-toggle"·open><summary><section·id="tymethod.wake"·class="method"><a·class="src·rightside"·href="../../src/alloc/task.rs.html#272">Source</a><h4·class="code-header">fn·<a·href="#tymethod.wake"·class="fn">wake</a>(self:·<a·class="struct"·href="../rc/struct.Rc.html"·title="struct·alloc::rc::Rc">Rc</a><Self>)</h4></section><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>local_waker</code> <a·href="https://github.com/rust-lang/rust/issues/118959">#118959</a>)</span></div></span></summary><div·class="docblock"><p>Wake·this·task.</p>	87	</div></details><h2·id="required-methods"·class="section-header">Required·Methods<a·href="#required-methods"·class="anchor">§</a></h2><div·class="methods"><details·class="toggle·method-toggle"·open><summary><section·id="tymethod.wake"·class="method"><a·class="src·rightside"·href="../../src/alloc/task.rs.html#272">Source</a><h4·class="code-header">fn·<a·href="#tymethod.wake"·class="fn">wake</a>(self:·<a·class="struct"·href="../rc/struct.Rc.html"·title="struct·alloc::rc::Rc">Rc</a><Self>)</h4></section><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>local_waker</code> <a·href="https://github.com/rust-lang/rust/issues/118959">#118959</a>)</span></div></span></summary><div·class="docblock"><p>Wake·this·task.</p>
88	</div></details></div><h2·id="provided-methods"·class="section-header">Provided·Methods<a·href="#provided-methods"·class="anchor">§</a></h2><div·class="methods"><details·class="toggle·method-toggle"·open><summary><section·id="method.wake_by_ref"·class="method"><a·class="src·rightside"·href="../../src/alloc/task.rs.html#282-284">Source</a><h4·class="code-header">fn·<a·href="#method.wake_by_ref"·class="fn">wake_by_ref</a>(self:·&<a·class="struct"·href="../rc/struct.Rc.html"·title="struct·alloc::rc::Rc">Rc</a><Self>)</h4></section><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>local_waker</code> <a·href="https://github.com/rust-lang/rust/issues/118959">#118959</a>)</span></div></span></summary><div·class="docblock"><p>Wake·this·task·without·consuming·the·local·waker.</p>	88	</div></details></div><h2·id="provided-methods"·class="section-header">Provided·Methods<a·href="#provided-methods"·class="anchor">§</a></h2><div·class="methods"><details·class="toggle·method-toggle"·open><summary><section·id="method.wake_by_ref"·class="method"><a·class="src·rightside"·href="../../src/alloc/task.rs.html#282-284">Source</a><h4·class="code-header">fn·<a·href="#method.wake_by_ref"·class="fn">wake_by_ref</a>(self:·&<a·class="struct"·href="../rc/struct.Rc.html"·title="struct·alloc::rc::Rc">Rc</a><Self>)</h4></section><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>local_waker</code> <a·href="https://github.com/rust-lang/rust/issues/118959">#118959</a>)</span></div></span></summary><div·class="docblock"><p>Wake·this·task·without·consuming·the·local·waker.</p>
89	<p>If·an·executor·supports·a·cheaper·way·to·wake·without·consuming·the	89	<p>If·an·executor·supports·a·cheaper·way·to·wake·without·consuming·the
90	waker,·it·should·override·this·method.·By·default,·it·clones·the	90	waker,·it·should·override·this·method.·By·default,·it·clones·the
91	<a·href="../rc/struct.Rc.html"·title="struct·alloc::rc::Rc"><code>Rc</code></a>·and·calls·<a·href="../../core/task/wake/struct.LocalWaker.html#method.wake"·title="method·core::task::wake::LocalWaker::wake"><code>wake</code></a>·on·the·clone.</p>	91	<a·href="../rc/struct.Rc.html"·title="struct·alloc::rc::Rc"><code>Rc</code></a>·and·calls·<a·href="https://doc.rust-lang.org/1.85.0/core/task/wake/struct.LocalWaker.html#method.wake"·title="method·core::task::wake::LocalWaker::wake"><code>wake</code></a>·on·the·clone.</p>
92	</div></details></div><h2·id="dyn-compatibility"·class="section-header">Dyn·Compatibility<a·href="#dyn-compatibility"·class="anchor">§</a></h2><div·class="dyn-compatibility-info"><p>This·trait·is·<b>not</b>·<a·href="https://doc.rust-lang.org/1.85.0/reference/items/traits.html#object-safety">dyn·compatible</a>.</p><p><i>In·older·versions·of·Rust,·dyn·compatibility·was·called·"object·safety",·so·this·trait·is·not·object·safe.</i></p></div><h2·id="implementors"·class="section-header">Implementors<a·href="#implementors"·class="anchor">§</a></h2><div·id="implementors-list"></div><script·src="../../trait.impl/alloc/task/trait.LocalWake.js"·async></script></section></div></main></body></html>	92	</div></details></div><h2·id="dyn-compatibility"·class="section-header">Dyn·Compatibility<a·href="#dyn-compatibility"·class="anchor">§</a></h2><div·class="dyn-compatibility-info"><p>This·trait·is·<b>not</b>·<a·href="https://doc.rust-lang.org/1.85.0/reference/items/traits.html#object-safety">dyn·compatible</a>.</p><p><i>In·older·versions·of·Rust,·dyn·compatibility·was·called·"object·safety",·so·this·trait·is·not·object·safe.</i></p></div><h2·id="implementors"·class="section-header">Implementors<a·href="#implementors"·class="anchor">§</a></h2><div·id="implementors-list"></div><script·src="../../trait.impl/alloc/task/trait.LocalWake.js"·async></script></section></div></main></body></html>


Offset 1, 25 lines modified		Offset 1, 25 lines modified
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="The·implementation·of·waking·a·task·on·an·executor."><title>Wake·in·alloc::task·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·trait"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Wake</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#examples"·title="Examples">Examples</a></li></ul><h3><a·href="#required-methods">Required·Methods</a></h3><ul·class="block"><li><a·href="#tymethod.wake"·title="wake">wake</a></li></ul><h3><a·href="#provided-methods">Provided·Methods</a></h3><ul·class="block"><li><a·href="#method.wake_by_ref"·title="wake_by_ref">wake_by_ref</a></li></ul><h3><a·href="#dyn-compatibility">Dyn·Compatibility</a></h3><h3><a·href="#implementors">Implementors</a></h3></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>task</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">task</a></span><h1>Trait·<span·class="trait">Wake</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.51.0">1.51.0</span>···<a·class="src"·href="../../src/alloc/task.rs.html#90-106">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·trait·Wake·{	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="The·implementation·of·waking·a·task·on·an·executor."><title>Wake·in·alloc::task·-·Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link·rel="preload"·as="font"·type="font/woff2"·crossorigin·href="../../static.files/${f}">`).join(""))</script><link·rel="stylesheet"·href="../../static.files/normalize-9960930a.css"><link·rel="stylesheet"·href="../../static.files/rustdoc-0a967d28.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.85.0"·data-rustdoc-version="1.85.0·(4d91de4e4·2025-02-17)·(built·from·a·source·tarball)"·data-channel="1.85.0"·data-search-js="search-75f5ac3e.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.85.0.js"></script><script·defer·src="../../static.files/main-5f194d8c.js"></script><noscript><link·rel="stylesheet"·href="../../static.files/noscript-893ab5e7.css"></noscript><link·rel="alternate·icon"·type="image/png"·href="../../static.files/favicon-32x32-6580c154.png"><link·rel="icon"·type="image/svg+xml"·href="../../static.files/favicon-044be391.svg"></head><body·class="rustdoc·trait"><!--[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"·title="show·sidebar"></button><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt=""></a></nav><nav·class="sidebar"><div·class="sidebar-crate"><a·class="logo-container"·href="../../alloc/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../alloc/index.html">alloc</a><span·class="version">1.85.0</span></h2></div><div·class="version">(4d91de4e4» 2025-02-17)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">Wake</a></h2><h3><a·href="#">Sections</a></h3><ul·class="block·top-toc"><li><a·href="#examples"·title="Examples">Examples</a></li></ul><h3><a·href="#required-methods">Required·Methods</a></h3><ul·class="block"><li><a·href="#tymethod.wake"·title="wake">wake</a></li></ul><h3><a·href="#provided-methods">Provided·Methods</a></h3><ul·class="block"><li><a·href="#method.wake_by_ref"·title="wake_by_ref">wake_by_ref</a></li></ul><h3><a·href="#dyn-compatibility">Dyn·Compatibility</a></h3><h3><a·href="#implementors">Implementors</a></h3></section><div·id="rustdoc-modnav"><h2><a·href="index.html">In·alloc::<wbr>task</a></h2></div></div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><div·class="main-heading"><span·class="rustdoc-breadcrumbs"><a·href="../index.html">alloc</a>::<wbr><a·href="index.html">task</a></span><h1>Trait·<span·class="trait">Wake</span><button·id="copy-path"·title="Copy·item·path·to·clipboard">Copy·item·path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span·class="sub-heading"><span·class="since"·title="Stable·since·Rust·version·1.51.0">1.51.0</span>···<a·class="src"·href="../../src/alloc/task.rs.html#90-106">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·trait·Wake·{
2	····//·Required·method	2	····//·Required·method
3	····fn·<a·href="#tymethod.wake"·class="fn">wake</a>(self:·<a·class="struct"·href="../sync/struct.Arc.html"·title="struct·alloc::sync::Arc">Arc</a><Self>);	3	····fn·<a·href="#tymethod.wake"·class="fn">wake</a>(self:·<a·class="struct"·href="../sync/struct.Arc.html"·title="struct·alloc::sync::Arc">Arc</a><Self>);

4	····//·Provided·method	4	····//·Provided·method
5	····fn·<a·href="#method.wake_by_ref"·class="fn">wake_by_ref</a>(self:·&<a·class="struct"·href="../sync/struct.Arc.html"·title="struct·alloc::sync::Arc">Arc</a><Self>)·{·...·}	5	····fn·<a·href="#method.wake_by_ref"·class="fn">wake_by_ref</a>(self:·&<a·class="struct"·href="../sync/struct.Arc.html"·title="struct·alloc::sync::Arc">Arc</a><Self>)·{·...·}
6	}</code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>The·implementation·of·waking·a·task·on·an·executor.</p>	6	}</code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>The·implementation·of·waking·a·task·on·an·executor.</p>
7	<p>This·trait·can·be·used·to·create·a·<a·href="../../core/task/wake/struct.Waker.html"·title="struct·core::task::wake::Waker"><code>Waker</code></a>.·An·executor·can·define·an	7	<p>This·trait·can·be·used·to·create·a·<a·href="https://doc.rust-lang.org/1.85.0/core/task/wake/struct.Waker.html"·title="struct·core::task::wake::Waker"><code>Waker</code></a>.·An·executor·can·define·an
8	implementation·of·this·trait,·and·use·that·to·construct·a·<a·href="../../core/task/wake/struct.Waker.html"·title="struct·core::task::wake::Waker"><code>Waker</code></a>·to·pass	8	implementation·of·this·trait,·and·use·that·to·construct·a·<a·href="https://doc.rust-lang.org/1.85.0/core/task/wake/struct.Waker.html"·title="struct·core::task::wake::Waker"><code>Waker</code></a>·to·pass
9	to·the·tasks·that·are·executed·on·that·executor.</p>	9	to·the·tasks·that·are·executed·on·that·executor.</p>
10	<p>This·trait·is·a·memory-safe·and·ergonomic·alternative·to·constructing·a	10	<p>This·trait·is·a·memory-safe·and·ergonomic·alternative·to·constructing·a
11	<a·href="../../core/task/wake/struct.RawWaker.html"·title="struct·core::task::wake::RawWaker"><code>RawWaker</code></a>.·It·supports·the·common·executor·design·in·which·the·data·used	11	<a·href="https://doc.rust-lang.org/1.85.0/core/task/wake/struct.RawWaker.html"·title="struct·core::task::wake::RawWaker"><code>RawWaker</code></a>.·It·supports·the·common·executor·design·in·which·the·data·used
12	to·wake·up·a·task·is·stored·in·an·<a·href="../sync/struct.Arc.html"·title="struct·alloc::sync::Arc"><code>Arc</code></a>.·Some·executors·(especially	12	to·wake·up·a·task·is·stored·in·an·<a·href="../sync/struct.Arc.html"·title="struct·alloc::sync::Arc"><code>Arc</code></a>.·Some·executors·(especially
13	those·for·embedded·systems)·cannot·use·this·API,·which·is·why·<a·href="../../core/task/wake/struct.RawWaker.html"·title="struct·core::task::wake::RawWaker"><code>RawWaker</code></a>	13	those·for·embedded·systems)·cannot·use·this·API,·which·is·why·<a·href="https://doc.rust-lang.org/1.85.0/core/task/wake/struct.RawWaker.html"·title="struct·core::task::wake::RawWaker"><code>RawWaker</code></a>
14	exists·as·an·alternative·for·those·systems.</p>	14	exists·as·an·alternative·for·those·systems.</p>
15	<p>To·construct·a·<a·href="../../core/task/wake/struct.Waker.html"·title="struct·core::task::wake::Waker"><code>Waker</code></a>·from·some·type·<code>W</code>·implementing·this·trait,	15	<p>To·construct·a·<a·href="https://doc.rust-lang.org/1.85.0/core/task/wake/struct.Waker.html"·title="struct·core::task::wake::Waker"><code>Waker</code></a>·from·some·type·<code>W</code>·implementing·this·trait,
16	wrap·it·in·an·<a·href="../sync/struct.Arc.html"·title="struct·alloc::sync::Arc"><code>Arc<W></code></a>·and·call·<code>Waker::from()</code>·on·that.	16	wrap·it·in·an·<a·href="../sync/struct.Arc.html"·title="struct·alloc::sync::Arc"><code>Arc<W></code></a>·and·call·<code>Waker::from()</code>·on·that.
17	It·is·also·possible·to·convert·to·<a·href="../../core/task/wake/struct.RawWaker.html"·title="struct·core::task::wake::RawWaker"><code>RawWaker</code></a>·in·the·same·way.</p>	17	It·is·also·possible·to·convert·to·<a·href="https://doc.rust-lang.org/1.85.0/core/task/wake/struct.RawWaker.html"·title="struct·core::task::wake::RawWaker"><code>RawWaker</code></a>·in·the·same·way.</p>
18	<!--·Ideally·we'd·link·to·the·`From`·impl,·but·rustdoc·doesn't·generate·any·page·for·it·within	18	<!--·Ideally·we'd·link·to·the·`From`·impl,·but·rustdoc·doesn't·generate·any·page·for·it·within
19	·····`alloc`·because·`alloc`·neither·defines·nor·re-exports·`From`·or·`Waker`,·and·we·can't	19	·····`alloc`·because·`alloc`·neither·defines·nor·re-exports·`From`·or·`Waker`,·and·we·can't
20	·····link·../../std/task/struct.Waker.html#impl-From%3CArc%3CW,+Global%3E%3E-for-Waker	20	·····link·../../std/task/struct.Waker.html#impl-From%3CArc%3CW,+Global%3E%3E-for-Waker
21	·····without·getting·a·link-checking·error·in·CI.·-->	21	·····without·getting·a·link-checking·error·in·CI.·-->
22	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>	22	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>
23	<p>A·basic·<code>block_on</code>·function·that·takes·a·future·and·runs·it·to·completion·on	23	<p>A·basic·<code>block_on</code>·function·that·takes·a·future·and·runs·it·to·completion·on
24	the·current·thread.</p>	24	the·current·thread.</p>


Offset 21, 13 lines modified		Offset 21, 13 lines modified

21	v.push(<span·class="number">3</span>);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+mut+v+=+vec!%5B1,+2%5D;%0A++++%0A++++v.push(3);%0A%7D&edition=2021"></a></div>	21	v.push(<span·class="number">3</span>);</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+mut+v+=+vec!%5B1,+2%5D;%0A++++%0A++++v.push(3);%0A%7D&edition=2021"></a></div>
22	<p>Popping·values·works·in·much·the·same·way:</p>	22	<p>Popping·values·works·in·much·the·same·way:</p>

23	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span><span·class="kw-2">mut·</span>v·=·<span·class="macro">vec!</span>[<span·class="number">1</span>,·<span·class="number">2</span>];	23	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span><span·class="kw-2">mut·</span>v·=·<span·class="macro">vec!</span>[<span·class="number">1</span>,·<span·class="number">2</span>];

24	<span·class="kw">let·</span>two·=·v.pop();</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+mut+v+=+vec!%5B1,+2%5D;%0A++++%0A++++let+two+=+v.pop();%0A%7D&edition=2021"></a></div>	24	<span·class="kw">let·</span>two·=·v.pop();</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+mut+v+=+vec!%5B1,+2%5D;%0A++++%0A++++let+two+=+v.pop();%0A%7D&edition=2021"></a></div>
25	<p>Vectors·also·support·indexing·(through·the·<a·href="../../core/ops/index/trait.Index.html"·title="trait·core::ops::index::Index"><code>Index</code></a>·and·<a·href="../../core/ops/index/trait.IndexMut.html"·title="trait·core::ops::index::IndexMut"><code>IndexMut</code></a>·traits):</p>	25	<p>Vectors·also·support·indexing·(through·the·<a·href="https://doc.rust-lang.org/1.85.0/core/ops/index/trait.Index.html"·title="trait·core::ops::index::Index"><code>Index</code></a>·and·<a·href="https://doc.rust-lang.org/1.85.0/core/ops/index/trait.IndexMut.html"·title="trait·core::ops::index::IndexMut"><code>IndexMut</code></a>·traits):</p>

26	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span><span·class="kw-2">mut·</span>v·=·<span·class="macro">vec!</span>[<span·class="number">1</span>,·<span·class="number">2</span>,·<span·class="number">3</span>];	26	<div·class="example-wrap"><pre·class="rust·rust-example-rendered"><code><span·class="kw">let·</span><span·class="kw-2">mut·</span>v·=·<span·class="macro">vec!</span>[<span·class="number">1</span>,·<span·class="number">2</span>,·<span·class="number">3</span>];
27	<span·class="kw">let·</span>three·=·v[<span·class="number">2</span>];	27	<span·class="kw">let·</span>three·=·v[<span·class="number">2</span>];
28	v[<span·class="number">1</span>]·=·v[<span·class="number">1</span>]·+·<span·class="number">5</span>;</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+mut+v+=+vec!%5B1,+2,+3%5D;%0A++++let+three+=+v%5B2%5D;%0A++++v%5B1%5D+=+v%5B1%5D+%2B+5;%0A%7D&edition=2021"></a></div>	28	v[<span·class="number">1</span>]·=·v[<span·class="number">1</span>]·+·<span·class="number">5</span>;</code></pre><a·class="test-arrow"·target="_blank"·title="Run·code"·href="https://play.rust-lang.org/?code=%23!%5Ballow(unused)%5D%0Afn+main()+%7B%0A++++let+mut+v+=+vec!%5B1,+2,+3%5D;%0A++++let+three+=+v%5B2%5D;%0A++++v%5B1%5D+=+v%5B1%5D+%2B+5;%0A%7D&edition=2021"></a></div>
29	</div></details><h2·id="structs"·class="section-header">Structs<a·href="#structs"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="struct"·href="struct.Drain.html"·title="struct·alloc::vec::Drain">Drain</a></div><div·class="desc·docblock-short">A·draining·iterator·for·<code>Vec<T></code>.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.IntoIter.html"·title="struct·alloc::vec::IntoIter">Into<wbr>Iter</a></div><div·class="desc·docblock-short">An·iterator·that·moves·out·of·a·vector.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.Splice.html"·title="struct·alloc::vec::Splice">Splice</a></div><div·class="desc·docblock-short">A·splicing·iterator·for·<code>Vec</code>.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.Vec.html"·title="struct·alloc::vec::Vec">Vec</a></div><div·class="desc·docblock-short">A·contiguous·growable·array·type,·written·as·<code>Vec<T></code>,·short·for·‘vector’.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.ExtractIf.html"·title="struct·alloc::vec::ExtractIf">Extract<wbr>If</a><wbr><span·class="stab·unstable"·title="">Experimental</span></div><div·class="desc·docblock-short">An·iterator·which·uses·a·closure·to·determine·if·an·element·should·be·removed.</div></li></ul></section></div></main></body></html>	29	</div></details><h2·id="structs"·class="section-header">Structs<a·href="#structs"·class="anchor">§</a></h2><ul·class="item-table"><li><div·class="item-name"><a·class="struct"·href="struct.Drain.html"·title="struct·alloc::vec::Drain">Drain</a></div><div·class="desc·docblock-short">A·draining·iterator·for·<code>Vec<T></code>.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.IntoIter.html"·title="struct·alloc::vec::IntoIter">Into<wbr>Iter</a></div><div·class="desc·docblock-short">An·iterator·that·moves·out·of·a·vector.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.Splice.html"·title="struct·alloc::vec::Splice">Splice</a></div><div·class="desc·docblock-short">A·splicing·iterator·for·<code>Vec</code>.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.Vec.html"·title="struct·alloc::vec::Vec">Vec</a></div><div·class="desc·docblock-short">A·contiguous·growable·array·type,·written·as·<code>Vec<T></code>,·short·for·‘vector’.</div></li><li><div·class="item-name"><a·class="struct"·href="struct.ExtractIf.html"·title="struct·alloc::vec::ExtractIf">Extract<wbr>If</a><wbr><span·class="stab·unstable"·title="">Experimental</span></div><div·class="desc·docblock-short">An·iterator·which·uses·a·closure·to·determine·if·an·element·should·be·removed.</div></li></ul></section></div></main></body></html>


Offset 5, 8 lines modified		Offset 5, 8 lines modified
5	Architecture:·i386	5	Architecture:·i386
6	Maintainer:·Debian·Rust·Maintainers·<pkg-rust-maintainers@alioth-lists.debian.net>	6	Maintainer:·Debian·Rust·Maintainers·<pkg-rust-maintainers@alioth-lists.debian.net>
7	Installed-Size:·17633	7	Installed-Size:·17633
8	Depends:·cargo·(=·1.85.0+dfsg2-3)	8	Depends:·cargo·(=·1.85.0+dfsg2-3)
9	Section:·debug	9	Section:·debug
10	Priority:·optional	10	Priority:·optional
11	Description:·debug·symbols·for·cargo	11	Description:·debug·symbols·for·cargo
12	Build-Ids:·613898f~~b46~~c~~9910~~1473~~b69f0497~~93ef~~5c3~~0~~0e3~~62	12	Build-Ids:·157fc4852173f3e1d55096ebf43703a726a9f211


Offset 1, 1 lines modified		Offset 1, 1 lines modified
1	usr/lib/debug/.build-id/61/~~389~~8~~fb46c99101473b~~6~~9f0~~49793e~~f5c300e362~~.debug	1	usr/lib/debug/.build-id/15/7fc4852173f3e1d55096ebf43703a726a9f211.debug


Offset 1, 10 lines modified		Offset 1, 10 lines modified
1	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./	1	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./
2	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/	2	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/
3	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/lib/	3	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/lib/
4	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/lib/debug/	4	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/lib/debug/
5	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/lib/debug/.build-id/	5	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/lib/debug/.build-id/
6	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/lib/debug/.build-id/61/	6	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/lib/debug/.build-id/15/
7	-rw-r--r--···0·root·········(0)·root·········(0)·18045516·2025-04-11·11:40:09.000000·./usr/lib/debug/.build-id/61/~~389~~8~~fb46c99101473b~~6~~9f0~~49793e~~f5c300e362~~.debug	7	-rw-r--r--···0·root·········(0)·root·········(0)·18045536·2025-04-11·11:40:09.000000·./usr/lib/debug/.build-id/15/7fc4852173f3e1d55096ebf43703a726a9f211.debug
8	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/	8	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/
9	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/	9	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/
10	lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/cargo-dbgsym·->·cargo	10	lrwxrwxrwx···0·root·········(0)·root·········(0)········0·2025-04-11·11:40:09.000000·./usr/share/doc/cargo-dbgsym·->·cargo


Offset 6, 15 lines modified		Offset 6, 15 lines modified
6	··OS/ABI:····························UNIX·-·System·V	6	··OS/ABI:····························UNIX·-·System·V
7	··ABI·Version:·······················0	7	··ABI·Version:·······················0
8	··Type:······························DYN·(Shared·object·file)	8	··Type:······························DYN·(Shared·object·file)
9	··Machine:···························Intel·80386	9	··Machine:···························Intel·80386
10	··Version:···························0x1	10	··Version:···························0x1
11	··Entry·point·address:···············0xf2750	11	··Entry·point·address:···············0xf2750
12	··Start·of·program·headers:··········52·(bytes·into·file)	12	··Start·of·program·headers:··········52·(bytes·into·file)
13	··Start·of·section·headers:··········18043916·(bytes·into·file)	13	··Start·of·section·headers:··········18043936·(bytes·into·file)
14	··Flags:·····························0x0	14	··Flags:·····························0x0
15	··Size·of·this·header:···············52·(bytes)	15	··Size·of·this·header:···············52·(bytes)
16	··Size·of·program·headers:···········32·(bytes)	16	··Size·of·program·headers:···········32·(bytes)
17	··Number·of·program·headers:·········13	17	··Number·of·program·headers:·········13
18	··Size·of·section·headers:···········40·(bytes)	18	··Size·of·section·headers:···········40·(bytes)
19	··Number·of·section·headers:·········40	19	··Number·of·section·headers:·········40
20	··Section·header·string·table·index:·39	20	··Section·header·string·table·index:·39