/usr/bin/diffoscope --timeout 7200 --html /srv/reproducible-results/rbuild-debian/r-b-build.RbGFPGXY/rustc_1.84.0+dfsg1-1.diffoscope.html --text /srv/reproducible-results/rbuild-debian/r-b-build.RbGFPGXY/rustc_1.84.0+dfsg1-1.diffoscope.txt --json /srv/reproducible-results/rbuild-debian/r-b-build.RbGFPGXY/rustc_1.84.0+dfsg1-1.diffoscope.json --profile=- /srv/reproducible-results/rbuild-debian/r-b-build.RbGFPGXY/b1/rustc_1.84.0+dfsg1-1_i386.changes /srv/reproducible-results/rbuild-debian/r-b-build.RbGFPGXY/b2/rustc_1.84.0+dfsg1-1

⊟

43.9 MB

/srv/reproducible-results/rbuild-debian/r-b-build.RbGFPGXY/b1/rustc_1.84.0+dfsg1-1_i386.changes vs.

/srv/reproducible-results/rbuild-debian/r-b-build.RbGFPGXY/b2/rustc_1.84.0+dfsg1-1_i386.changes ¶

⊟

2.27 KB

Files ¶

⊟

9.11 KB

cargo-doc_1.84.0+dfsg1-1_all.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

⊟

8.51 KB

data.tar.xz ¶

⊟

8.49 KB

data.tar ¶

⊟

2.23 KB

file list ¶

⊟

6.24 KB

⊟

427 KB

libstd-rust-dev-windows_1.84.0+dfsg1-1_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

⊟

427 KB

data.tar.xz ¶

⊟

427 KB

data.tar ¶

⊟

13.4 KB

./usr/lib/rustlib/i686-pc-windows-gnu/lib/libstd-76b0e90875c26d08.rlib ¶

⊟

5.27 KB

nm -s {} ¶

Max HTML report size reached

⊟

825 B

bcryptprimitives.dllt.o ¶

⊟

1.21 KB

bcryptprimitives.dllh.o ¶

Max HTML report size reached

⊟

963 B

bcryptprimitives.dlls00000.o ¶

⊟

1.02 KB

api-ms-win-core-synch-l1-2-0.dllt.o ¶

Max HTML report size reached

⊟

1.29 KB

api-ms-win-core-synch-l1-2-0.dllh.o ¶

Max HTML report size reached

⊟

922 B

api-ms-win-core-synch-l1-2-0.dlls00002.o ¶

⊟

997 B

api-ms-win-core-synch-l1-2-0.dlls00001.o ¶

Max HTML report size reached

⊟

918 B

api-ms-win-core-synch-l1-2-0.dlls00000.o ¶

⊟

413 KB

./usr/lib/rustlib/i686-pc-windows-gnu/lib/std-76b0e90875c26d08.dll ¶

Max HTML report size reached

⊟

43.4 MB

rust-doc_1.84.0+dfsg1-1_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

⊟

43.4 MB

data.tar.xz ¶

⊟

43.4 MB

data.tar ¶

⊟

148 KB

file list ¶

⊟

8.64 KB

⊟

8.83 KB

⊟

8.57 KB

⊟

9.38 KB

⊟

9.08 KB

⊟

74.2 KB

⊟

70.8 KB

⊟

108 KB

⊟

77.8 KB

⊟

46.8 KB

⊟

22.2 KB

⊟

8.03 KB

⊟

310 KB

⊟

31.4 KB

⊟

20.1 KB

⊟

12.6 KB

⊟

5.72 KB

⊟

971 KB

Max HTML report size reached

⊟

84.2 KB

⊟

167 KB

⊟

328 KB

⊟

311 KB

⊟

349 KB

Max HTML report size reached

⊟

326 KB

⊟

339 KB

⊟

62.2 KB

⊟

68.4 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

⊟

65.0 KB

⊟

331 KB

⊟

317 KB

⊟

69.0 KB

⊟

55.6 KB

⊟

340 KB

⊟

326 KB

⊟

286 KB

⊟

58.7 KB

⊟

57.6 KB

⊟

56.2 KB

⊟

312 KB

⊟

301 KB

⊟

312 KB

⊟

336 KB

⊟

337 KB

⊟

328 KB

⊟

303 KB

⊟

302 KB

⊟

69.4 KB

⊟

55.8 KB

⊟

67.7 KB

⊟

71.1 KB

⊟

290 KB

⊟

346 KB

Max HTML report size reached

⊟

339 KB

⊟

324 KB

⊟

178 KB

⊟

73.1 KB

⊟

328 KB

⊟

341 KB

⊟

342 KB

⊟

336 KB

⊟

324 KB

⊟

227 KB

⊟

70.9 KB

⊟

64.8 KB

⊟

68.3 KB

⊟

7.71 KB

⊟

225 KB

⊟

70.3 KB

⊟

64.2 KB

⊟

67.6 KB

⊟

6.92 KB

⊟

60.9 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

⊟

108 KB

⊟

51.4 KB

⊟

35.0 KB

⊟

530 KB

Max HTML report size reached

⊟

123 KB

⊟

6.65 KB

Max HTML report size reached

⊟

32.6 KB

⊟

33.3 KB

⊟

32.7 KB

⊟

29.1 KB

⊟

32.6 KB

⊟

33.3 KB

⊟

26.5 KB

⊟

11.4 KB

⊟

2.33 KB

⊟

2.78 KB

⊟

1.7 KB

⊟

11.6 KB

⊟

376 KB

⊟

74.3 KB

⊟

111 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

⊟

13.4 KB

⊟

351 KB

Max HTML report size reached

⊟

337 KB

⊟

346 KB

Max HTML report size reached

⊟

328 KB

⊟

328 KB

⊟

345 KB

Max HTML report size reached

⊟

351 KB

Max HTML report size reached

⊟

334 KB

⊟

330 KB

⊟

340 KB

⊟

357 KB

Max HTML report size reached

⊟

352 KB

Max HTML report size reached

⊟

345 KB

Max HTML report size reached

⊟

351 KB

Max HTML report size reached

⊟

334 KB

⊟

330 KB

⊟

345 KB

Max HTML report size reached

⊟

328 KB

⊟

311 KB

⊟

310 KB

⊟

349 KB

Max HTML report size reached

⊟

346 KB

Max HTML report size reached

⊟

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

Max HTML report size reached

⊟

344 KB

⊟

74.6 KB

⊟

348 KB

Max HTML report size reached

⊟

346 KB

Max HTML report size reached

⊟

351 KB

Max HTML report size reached

⊟

332 KB

⊟

352 KB

Max HTML report size reached

⊟

348 KB

Max HTML report size reached

⊟

341 KB

⊟

350 KB

Max HTML report size reached

⊟

329 KB

⊟

350 KB

Max HTML report size reached

⊟

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.64 KB

⊟

8.07 KB

⊟

412 KB

Max HTML report size reached

⊟

116 KB

⊟

5.55 KB

⊟

7.7 KB

⊟

3.61 KB

⊟

337 KB

⊟

296 KB

⊟

355 KB

Max HTML report size reached

⊟

337 KB

⊟

1.07 MB

Max HTML report size reached

⊟

35.9 KB

⊟

29.0 KB

⊟

36.0 KB

⊟

51.3 KB

⊟

7.33 KB

⊟

36.3 KB

⊟

36.9 KB

⊟

34.2 KB

⊟

46.1 KB

⊟

37.3 KB

⊟

114 KB

⊟

56.8 KB

⊟

43.8 KB

⊟

45.2 KB

⊟

76.7 KB

⊟

177 KB

⊟

9.93 KB

⊟

7.7 KB

⊟

75.2 KB

⊟

5.47 KB

⊟

7.07 KB

⊟

8.43 KB

⊟

41.9 KB

⊟

40.8 KB

⊟

34.1 KB

⊟

46.0 KB

⊟

38.5 KB

⊟

41.1 KB

⊟

47.3 KB

⊟

45.8 KB

⊟

56.4 KB

⊟

41.1 KB

⊟

8.04 KB

⊟

5.09 KB

⊟

4.99 KB

⊟

4.66 KB

⊟

8.44 KB

⊟

55.5 KB

⊟

47.9 KB

⊟

45.2 KB

⊟

48.6 KB

⊟

25.3 KB

⊟

50.5 KB

⊟

50.9 KB

⊟

41.5 KB

⊟

26.8 KB

⊟

47.8 KB

⊟

57.1 KB

⊟

44.5 KB

⊟

41.6 KB

⊟

47.4 KB

⊟

47.9 KB

⊟

45.6 KB

⊟

49.1 KB

⊟

25.7 KB

⊟

44.8 KB

⊟

51.2 KB

⊟

51.3 KB

⊟

52.7 KB

⊟

2.07 KB

⊟

1.89 KB

Max HTML report size reached

⊟

7.54 KB

⊟

7.41 KB

Max HTML report size reached

⊟

3.18 KB

⊟

3.04 KB

Max HTML report size reached

⊟

42.5 KB

⊟

42.4 KB

Max HTML report size reached

⊟

16.4 KB

⊟

16.3 KB

Max HTML report size reached

⊟

13.0 KB

⊟

12.9 KB

Max HTML report size reached

⊟

54.0 KB

⊟

53.8 KB

Max HTML report size reached

⊟

14.5 KB

⊟

14.4 KB

Max HTML report size reached

⊟

4.18 KB

⊟

4.04 KB

Max HTML report size reached

⊟

13.3 KB

⊟

13.1 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

⊟

57.9 KB

⊟

57.8 KB

Max HTML report size reached

⊟

10.9 KB

⊟

10.8 KB

Max HTML report size reached

⊟

3.45 KB

⊟

3.32 KB

Max HTML report size reached

⊟

2.13 KB

⊟

1.99 KB

Max HTML report size reached

⊟

13.2 KB

⊟

13.1 KB

Max HTML report size reached

⊟

2.09 KB

⊟

1.96 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

⊟

67.9 KB

⊟

67.8 KB

Max HTML report size reached

⊟

1.14 KB

⊟

1.0 KB

Max HTML report size reached

⊟

90.8 KB

⊟

90.6 KB

Max HTML report size reached

⊟

6.91 KB

⊟

6.75 KB

Max HTML report size reached

⊟

90.8 KB

⊟

90.6 KB

Max HTML report size reached

⊟

69.0 KB

⊟

68.9 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.34 KB

⊟

4.21 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.47 KB

⊟

3.34 KB

Max HTML report size reached

⊟

3.46 KB

⊟

3.33 KB

Max HTML report size reached

⊟

3.47 KB

⊟

3.34 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

⊟

6.59 KB

⊟

6.45 KB

Max HTML report size reached

⊟

21.2 KB

⊟

21.1 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.4 KB

⊟

8.26 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

⊟

8.58 KB

⊟

8.42 KB

Max HTML report size reached

⊟

111 KB

⊟

111 KB

Max HTML report size reached

⊟

96.4 KB

⊟

96.2 KB

Max HTML report size reached

⊟

6.62 KB

⊟

6.47 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

⊟

313 KB

⊟

313 KB

Max HTML report size reached


Offset 1, 3 lines modified		Offset 1, 3 lines modified
1	-rw-r--r--···0········0········0········4·2025-01-16·19:46:05.000000·debian-binary	1	-rw-r--r--···0········0········0········4·2025-01-16·19:46:05.000000·debian-binary
2	-rw-r--r--···0········0········0····74904·2025-01-16·19:46:05.000000·control.tar.xz	2	-rw-r--r--···0········0········0····74908·2025-01-16·19:46:05.000000·control.tar.xz
3	-rw-r--r--···0········0········0··4250~~132~~·2025-01-16·19:46:05.000000·data.tar.xz	3	-rw-r--r--···0········0········0··4250064·2025-01-16·19:46:05.000000·data.tar.xz


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="List·of·crates"><title>Index·of·crates</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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="./"·data-static-root-path="./static.files/"·data-current-crate="cargo_util"·data-themes=""·data-resource-suffix=""·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="./static.files/storage-59e33391.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·mod·sys"><!--[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="./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="./index.html"><img·class="rust-logo"·src="./static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="./index.html">Rustdoc</a><span·class="version">1.84.0</span></h2></div><div·class="version">(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)</div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><h1>List·of·all·crates</h1><ul·class="all-items"><li><a·href="cargo/index.html">cargo</a></li><li><a·href="cargo_credential/index.html">cargo_credential</a></li><li><a·href="cargo_platform/index.html">cargo_platform</a></li><li><a·href="cargo_test_macro/index.html">cargo_test_macro</a></li><li><a·href="cargo_test_support/index.html">cargo_test_support</a></li><li><a·href="cargo_util/index.html">cargo_util</a></li><li><a·href="cargo_util_schemas/index.html">cargo_util_schemas</a></li><li><a·href="crates_io/index.html">crates_io</a></li><li><a·href="mdman/index.html">mdman</a></li><li><a·href="rustfix/index.html">rustfix</a></li></ul></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="List·of·crates"><title>Index·of·crates</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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="./"·data-static-root-path="./static.files/"·data-current-crate="cargo_platform"·data-themes=""·data-resource-suffix=""·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="./static.files/storage-59e33391.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·mod·sys"><!--[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="./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="./index.html"><img·class="rust-logo"·src="./static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="./index.html">Rustdoc</a><span·class="version">1.84.0</span></h2></div><div·class="version">(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)</div></nav><div·class="sidebar-resizer"></div><main><div·class="width-limiter"><rustdoc-search></rustdoc-search><section·id="main-content"·class="content"><h1>List·of·all·crates</h1><ul·class="all-items"><li><a·href="cargo/index.html">cargo</a></li><li><a·href="cargo_credential/index.html">cargo_credential</a></li><li><a·href="cargo_platform/index.html">cargo_platform</a></li><li><a·href="cargo_test_macro/index.html">cargo_test_macro</a></li><li><a·href="cargo_test_support/index.html">cargo_test_support</a></li><li><a·href="cargo_util/index.html">cargo_util</a></li><li><a·href="cargo_util_schemas/index.html">cargo_util_schemas</a></li><li><a·href="crates_io/index.html">crates_io</a></li><li><a·href="mdman/index.html">mdman</a></li><li><a·href="rustfix/index.html">rustfix</a></li></ul></section></div></main></body></html>
2	<!--{"start":2440,"fragment_lengths":[45,67,63,67,71,55,71,53,45,49]}-->	2	<!--{"start":2444,"fragment_lengths":[45,67,63,67,71,55,71,53,45,49]}-->


Offset 1, 3 lines modified		Offset 1, 3 lines modified
1	-rw-r--r--···0········0········0········4·2025-01-16·19:46:05.000000·debian-binary	1	-rw-r--r--···0········0········0········4·2025-01-16·19:46:05.000000·debian-binary
2	-rw-r--r--···0········0········0·····2288·2025-01-16·19:46:05.000000·control.tar.xz	2	-rw-r--r--···0········0········0·····2284·2025-01-16·19:46:05.000000·control.tar.xz
3	-rw-r--r--···0········0········0·43654580·2025-01-16·19:46:05.000000·data.tar.xz	3	-rw-r--r--···0········0········0·43654920·2025-01-16·19:46:05.000000·data.tar.xz


Offset 1, 22 lines modified		Offset 1, 22 lines modified

1	·352c548c1ab20d481951ae5e6646a6b2·3162956·debug·optional·cargo-dbgsym_1.84.0+dfsg1-1_i386.deb	1	·352c548c1ab20d481951ae5e6646a6b2·3162956·debug·optional·cargo-dbgsym_1.84.0+dfsg1-1_i386.deb
2	·~~268~~4d3e87a1207e~~20ae~~040d7~~c51~~3~~9ec6~~·4325~~228~~·doc·optional·cargo-doc_1.84.0+dfsg1-1_all.deb	2	·9ffc4f2ebc89b3a22b9e13b304776243·4325164·doc·optional·cargo-doc_1.84.0+dfsg1-1_all.deb
3	·4d5abe792bfbebd53f800f965d87c7e1·6909528·devel·optional·cargo_1.84.0+dfsg1-1_i386.deb	3	·4d5abe792bfbebd53f800f965d87c7e1·6909528·devel·optional·cargo_1.84.0+dfsg1-1_i386.deb
4	·5169fc3b19aff3ff2d04a0b6a454390e·7335548·debug·optional·libstd-rust-1.84-dbgsym_1.84.0+dfsg1-1_i386.deb	4	·5169fc3b19aff3ff2d04a0b6a454390e·7335548·debug·optional·libstd-rust-1.84-dbgsym_1.84.0+dfsg1-1_i386.deb
5	·7b991d092865e783839e03ff037f61f8·21842796·libs·optional·libstd-rust-1.84_1.84.0+dfsg1-1_i386.deb	5	·7b991d092865e783839e03ff037f61f8·21842796·libs·optional·libstd-rust-1.84_1.84.0+dfsg1-1_i386.deb
6	·1a171ae9525e6857fdc6bc8295ddc607·92213244·libdevel·optional·libstd-rust-dev-wasm32_1.84.0+dfsg1-1_all.deb	6	·1a171ae9525e6857fdc6bc8295ddc607·92213244·libdevel·optional·libstd-rust-dev-wasm32_1.84.0+dfsg1-1_all.deb
7	·173~~888~~433~~a7a792d3~~1~~07e~~312b3995750·43657~~060~~·libdevel·optional·libstd-rust-dev-windows_1.84.0+dfsg1-1_i386.deb	7	·486305f40c93441066681e903ad3f5b2·43657396·libdevel·optional·libstd-rust-dev-windows_1.84.0+dfsg1-1_i386.deb
8	·cfd522ce815e152836c070902b5016a6·38217276·libdevel·optional·libstd-rust-dev_1.84.0+dfsg1-1_i386.deb	8	·cfd522ce815e152836c070902b5016a6·38217276·libdevel·optional·libstd-rust-dev_1.84.0+dfsg1-1_i386.deb
9	·161c01c5a56972e18e5dd28f442e13ba·240132·devel·optional·rust-all_1.84.0+dfsg1-1_all.deb	9	·161c01c5a56972e18e5dd28f442e13ba·240132·devel·optional·rust-all_1.84.0+dfsg1-1_all.deb
10	·ff9d3064e177c66243953bc808e5faf8·1244356·debug·optional·rust-analyzer-dbgsym_1.84.0+dfsg1-1_i386.deb	10	·ff9d3064e177c66243953bc808e5faf8·1244356·debug·optional·rust-analyzer-dbgsym_1.84.0+dfsg1-1_i386.deb
11	·3ffb2426c7d8920aee804de18c41ded0·8617512·devel·optional·rust-analyzer_1.84.0+dfsg1-1_i386.deb	11	·3ffb2426c7d8920aee804de18c41ded0·8617512·devel·optional·rust-analyzer_1.84.0+dfsg1-1_i386.deb
12	·9d27a1bb8a822d4ab1f31e6bf186e4b5·520672·debug·optional·rust-clippy-dbgsym_1.84.0+dfsg1-1_i386.deb	12	·9d27a1bb8a822d4ab1f31e6bf186e4b5·520672·debug·optional·rust-clippy-dbgsym_1.84.0+dfsg1-1_i386.deb
13	·13d508bc799a3bbd59cbf5eff80d2dc5·3587928·devel·optional·rust-clippy_1.84.0+dfsg1-1_i386.deb	13	·13d508bc799a3bbd59cbf5eff80d2dc5·3587928·devel·optional·rust-clippy_1.84.0+dfsg1-1_i386.deb
14	·~~d6056f69aa11~~c~~4e9c7a7492~~b~~5448955c~~·22~~34580~~8·doc·optional·rust-doc_1.84.0+dfsg1-1_all.deb	14	·174bb557c848c6bbd65dbb0bd71f5892·22568468·doc·optional·rust-doc_1.84.0+dfsg1-1_all.deb
15	·04970036be19d8ce52738d041a0d7481·245844·devel·optional·rust-gdb_1.84.0+dfsg1-1_all.deb	15	·04970036be19d8ce52738d041a0d7481·245844·devel·optional·rust-gdb_1.84.0+dfsg1-1_all.deb
16	·2871b8941c7202814f634f3baf615753·246632·devel·optional·rust-lldb_1.84.0+dfsg1-1_all.deb	16	·2871b8941c7202814f634f3baf615753·246632·devel·optional·rust-lldb_1.84.0+dfsg1-1_all.deb
17	·4d5ff99e3224ebba15da179e516d70dc·1906168·devel·optional·rust-llvm_1.84.0+dfsg1-1_i386.deb	17	·4d5ff99e3224ebba15da179e516d70dc·1906168·devel·optional·rust-llvm_1.84.0+dfsg1-1_i386.deb
18	·f12987f936aa8cc733073deecff0344f·46613444·devel·optional·rust-src_1.84.0+dfsg1-1_all.deb	18	·f12987f936aa8cc733073deecff0344f·46613444·devel·optional·rust-src_1.84.0+dfsg1-1_all.deb
19	·5c3f99025428ffc2e3f46b5d760ce945·1750616·debug·optional·rustc-dbgsym_1.84.0+dfsg1-1_i386.deb	19	·5c3f99025428ffc2e3f46b5d760ce945·1750616·debug·optional·rustc-dbgsym_1.84.0+dfsg1-1_i386.deb
20	·a399958d0b54a9da80851e73458cc26b·4003620·devel·optional·rustc_1.84.0+dfsg1-1_i386.deb	20	·a399958d0b54a9da80851e73458cc26b·4003620·devel·optional·rustc_1.84.0+dfsg1-1_i386.deb
21	·05f64046c7af2f8394fb9fe385da559e·2556228·debug·optional·rustfmt-dbgsym_1.84.0+dfsg1-1_i386.deb	21	·05f64046c7af2f8394fb9fe385da559e·2556228·debug·optional·rustfmt-dbgsym_1.84.0+dfsg1-1_i386.deb


Offset 2755, 15 lines modified		Offset 2755, 15 lines modified
2755	-rw-r--r--···0·root·········(0)·root·········(0)····35802·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.Registry.html	2755	-rw-r--r--···0·root·········(0)·root·········(0)····35802·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.Registry.html
2756	-rw-r--r--···0·root·········(0)·root·········(0)····22878·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.TotalCrates.html	2756	-rw-r--r--···0·root·········(0)·root·········(0)····22878·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.TotalCrates.html
2757	-rw-r--r--···0·root·········(0)·root·········(0)····25325·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.User.html	2757	-rw-r--r--···0·root·········(0)·root·········(0)····25325·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.User.html
2758	-rw-r--r--···0·root·········(0)·root·········(0)····22832·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.Users.html	2758	-rw-r--r--···0·root·········(0)·root·········(0)····22832·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.Users.html
2759	-rw-r--r--···0·root·········(0)·root·········(0)····21821·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.Warnings.html	2759	-rw-r--r--···0·root·········(0)·root·········(0)····21821·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/struct.Warnings.html
2760	-rw-r--r--···0·root·········(0)·root·········(0)·····4852·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/type.Result.html	2760	-rw-r--r--···0·root·········(0)·root·········(0)·····4852·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/crates_io/type.Result.html
2761	-rw-r--r--···0·root·········(0)·root·········(0)·····2863·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/help.html	2761	-rw-r--r--···0·root·········(0)·root·········(0)·····2863·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/help.html
2762	-rw-r--r--···0·root·········(0)·root·········(0)·····3141·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/index.html	2762	-rw-r--r--···0·root·········(0)·root·········(0)·····3145·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/index.html
2763	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/	2763	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/
2764	-rw-r--r--···0·root·········(0)·root·········(0)·····5237·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/all.html	2764	-rw-r--r--···0·root·········(0)·root·········(0)·····5237·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/all.html
2765	-rw-r--r--···0·root·········(0)·root·········(0)····28689·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/enum.Format.html	2765	-rw-r--r--···0·root·········(0)·root·········(0)····28689·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/enum.Format.html
2766	-rw-r--r--···0·root·········(0)·root·········(0)·····4059·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/fn.convert.html	2766	-rw-r--r--···0·root·········(0)·root·········(0)·····4059·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/fn.convert.html
2767	-rw-r--r--···0·root·········(0)·root·········(0)·····3287·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/fn.extract_section.html	2767	-rw-r--r--···0·root·········(0)·root·········(0)·····3287·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/fn.extract_section.html
2768	-rw-r--r--···0·root·········(0)·root·········(0)·····3095·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/fn.join_url.html	2768	-rw-r--r--···0·root·········(0)·root·········(0)·····3095·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/fn.join_url.html
2769	-rw-r--r--···0·root·········(0)·root·········(0)·····3931·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/fn.md_parser.html	2769	-rw-r--r--···0·root·········(0)·root·········(0)·····3931·2025-01-16·19:46:05.000000·./usr/share/doc/cargo/reference/mdman/fn.md_parser.html


Offset 30, 10 lines modified		Offset 30, 10 lines modified
000001d0:·0000·0000·0000·0000·2e69·6461·7461·2435··.........idata$5		000001d0:·0000·0000·0000·0000·2e69·6461·7461·2435··.........idata$5
000001e0:·0000·0000·0500·0000·0301·0400·0000·0000··................		000001e0:·0000·0000·0500·0000·0301·0400·0000·0000··................
000001f0:·0000·0000·0000·0000·0000·0000·2e69·6461··.............ida		000001f0:·0000·0000·0000·0000·0000·0000·2e69·6461··.............ida
00000200:·7461·2437·0000·0000·0600·0000·0301·1500··ta$7............		00000200:·7461·2437·0000·0000·0600·0000·0301·1500··ta$7............
00000210:·0000·0000·0000·0000·0000·0000·0000·0000··................		00000210:·0000·0000·0000·0000·0000·0000·0000·0000··................
00000220:·0000·0000·0400·0000·0000·0000·0600·0000··................		00000220:·0000·0000·0400·0000·0000·0000·0600·0000··................
00000230:·0200·3e00·0000·5f5f·5f74·6d70·5f72·7573··..>...___tmp_rus		00000230:·0200·3e00·0000·5f5f·5f74·6d70·5f72·7573··..>...___tmp_rus
00000240:·7463·6~~96c~~·3578·~~5446~~·5f62·6372·7970·7470··tc~~il5xTF~~_bcryptp		00000240:·7463·6153·4577·6354·5f62·6372·7970·7470··tcaSEwcT_bcryptp
00000250:·7269·6d69·7469·7665·735f·646c·6c5f·696d··rimitives_dll_im		00000250:·7269·6d69·7469·7665·735f·646c·6c5f·696d··rimitives_dll_im
00000260:·706f·7274·735f·6c69·625f·696e·616d·6500··ports_lib_iname.		00000260:·706f·7274·735f·6c69·625f·696e·616d·6500··ports_lib_iname.


Offset 31, 11 lines modified		Offset 31, 11 lines modified
000001e0:·0000·0300·2e69·6461·7461·2436·0000·0000··.....idata$6....		000001e0:·0000·0300·2e69·6461·7461·2436·0000·0000··.....idata$6....
000001f0:·0700·0000·0300·0000·0000·0400·0000·0000··................		000001f0:·0700·0000·0300·0000·0000·0400·0000·0000··................
00000200:·0000·0100·0000·0200·0000·0000·1000·0000··................		00000200:·0000·0100·0000·0200·0000·0000·1000·0000··................
00000210:·0000·0000·0500·0000·0200·0000·0000·2200··..............".		00000210:·0000·0000·0500·0000·0200·0000·0000·2200··..............".
00000220:·0000·0000·0000·0000·0000·0200·5a00·0000··............Z...		00000220:·0000·0000·0000·0000·0000·0200·5a00·0000··............Z...
00000230:·5072·6f63·6573·7350·726e·6700·5f5f·696d··ProcessPrng.__im		00000230:·5072·6f63·6573·7350·726e·6700·5f5f·696d··ProcessPrng.__im
00000240:·705f·5072·6f63·6573·7350·726e·6700·5f68··p_ProcessPrng._h		00000240:·705f·5072·6f63·6573·7350·726e·6700·5f68··p_ProcessPrng._h
00000250:·6561·645f·5f74·6d70·5f72·7573·7463·6~~96c~~··ead__tmp_rustcil		00000250:·6561·645f·5f74·6d70·5f72·7573·7463·6153··ead__tmp_rustcaS
00000260:·3578·~~5446~~·5f62·6372·7970·7470·7269·6d69··~~5xTF~~_bcryptprimi		00000260:·4577·6354·5f62·6372·7970·7470·7269·6d69··EwcT_bcryptprimi
00000270:·7469·7665·735f·646c·6c5f·696d·706f·7274··tives_dll_import		00000270:·7469·7665·735f·646c·6c5f·696d·706f·7274··tives_dll_import
00000280:·735f·6c69·6200···························s_lib.		00000280:·735f·6c69·6200···························s_lib.


Offset 33, 11 lines modified		Offset 33, 11 lines modified
00000200:·0000·0400·0000·0000·0000·0100·0000·0200··................		00000200:·0000·0400·0000·0000·0000·0100·0000·0200··................
00000210:·0000·0000·1800·0000·0000·0000·0500·0000··................		00000210:·0000·0000·1800·0000·0000·0000·0500·0000··................
00000220:·0200·0000·0000·3200·0000·0000·0000·0000··......2.........		00000220:·0200·0000·0000·3200·0000·0000·0000·0000··......2.........
00000230:·0000·0200·7600·0000·5761·6b65·4279·4164··....v...WakeByAd		00000230:·0000·0200·7600·0000·5761·6b65·4279·4164··....v...WakeByAd
00000240:·6472·6573·7353·696e·676c·6500·5f5f·696d··dressSingle.__im		00000240:·6472·6573·7353·696e·676c·6500·5f5f·696d··dressSingle.__im
00000250:·705f·5761·6b65·4279·4164·6472·6573·7353··p_WakeByAddressS		00000250:·705f·5761·6b65·4279·4164·6472·6573·7353··p_WakeByAddressS
00000260:·696e·676c·6500·5f68·6561·645f·5f74·6d70··ingle._head__tmp		00000260:·696e·676c·6500·5f68·6561·645f·5f74·6d70··ingle._head__tmp
00000270:·5f72·7573·7463·6~~96c~~·3578·~~5446~~·5f61·7069··_rustc~~il5xTF~~_api		00000270:·5f72·7573·7463·6153·4577·6354·5f61·7069··_rustcaSEwcT_api
00000280:·5f6d·735f·7769·6e5f·636f·7265·5f73·796e··_ms_win_core_syn		00000280:·5f6d·735f·7769·6e5f·636f·7265·5f73·796e··_ms_win_core_syn
00000290:·6368·5f6c·315f·325f·305f·646c·6c5f·696d··ch_l1_2_0_dll_im		00000290:·6368·5f6c·315f·325f·305f·646c·6c5f·696d··ch_l1_2_0_dll_im
000002a0:·706f·7274·735f·6c69·6200·················ports_lib.		000002a0:·706f·7274·735f·6c69·6200·················ports_lib.


Offset 32, 11 lines modified		Offset 32, 11 lines modified
000001f0:·0700·0000·0300·0000·0000·0400·0000·0000··................		000001f0:·0700·0000·0300·0000·0000·0400·0000·0000··................
00000200:·0000·0100·0000·0200·0000·0000·1200·0000··................		00000200:·0000·0100·0000·0200·0000·0000·1200·0000··................
00000210:·0000·0000·0500·0000·0200·0000·0000·2600··..............&.		00000210:·0000·0000·0500·0000·0200·0000·0000·2600··..............&.
00000220:·0000·0000·0000·0000·0000·0200·6a00·0000··............j...		00000220:·0000·0000·0000·0000·0000·0200·6a00·0000··............j...
00000230:·5761·6974·4f6e·4164·6472·6573·7300·5f5f··WaitOnAddress.__		00000230:·5761·6974·4f6e·4164·6472·6573·7300·5f5f··WaitOnAddress.__
00000240:·696d·705f·5761·6974·4f6e·4164·6472·6573··imp_WaitOnAddres		00000240:·696d·705f·5761·6974·4f6e·4164·6472·6573··imp_WaitOnAddres
00000250:·7300·5f68·6561·645f·5f74·6d70·5f72·7573··s._head__tmp_rus		00000250:·7300·5f68·6561·645f·5f74·6d70·5f72·7573··s._head__tmp_rus
00000260:·7463·6~~96c~~·3578·~~5446~~·5f61·7069·5f6d·735f··tc~~il5xTF~~_api_ms_		00000260:·7463·6153·4577·6354·5f61·7069·5f6d·735f··tcaSEwcT_api_ms_
00000270:·7769·6e5f·636f·7265·5f73·796e·6368·5f6c··win_core_synch_l		00000270:·7769·6e5f·636f·7265·5f73·796e·6368·5f6c··win_core_synch_l
00000280:·315f·325f·305f·646c·6c5f·696d·706f·7274··1_2_0_dll_import		00000280:·315f·325f·305f·646c·6c5f·696d·706f·7274··1_2_0_dll_import
00000290:·735f·6c69·6200···························s_lib.		00000290:·735f·6c69·6200···························s_lib.


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.84.0+dfsg1-1	3	Version:·1.84.0+dfsg1-1
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:·51~~9565~~	6	Installed-Size:·517304
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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (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#93-101">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.84.0/core/primitive.pointer.html">*mut·</a><a·class="primitive"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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>	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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (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#93-101">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>
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>alloc</code>·method	5	<p>This·function·is·expected·to·be·deprecated·in·favor·of·the·<code>alloc</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, 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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (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.84.0/src/core/alloc/layout.rs.html#538">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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (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#538">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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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.84.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.84.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:·~~06e8~~862~~25397fdd~~416b~~e32~~15e~~3163~~6d5~~a44c657656be16aaf9e2~~a~~7217~~c67~~44b2~~·...·]/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#1081">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.84.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:·9dc58f210770a0a41a8bb77919e8d11658b27a0312919f8c764a4aafbac6d170·...·]/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#1081">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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·0~~d2a~~5~~6d53100~~4102~~6c1~~7~~0d6ac1d38~~8be~~a6aa4~~360b~~a29~~f516~~f0d891f438~~96f58b·...·]/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#882">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="../../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:·89c5c27cff448072376fa00cbbc8b68c9d325b990fb526c9825ed762798f5d25·...·]/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#882">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 6, 53 lines modified		Offset 6, 53 lines modified
6	-rw-r--r--···0·root·········(0)·root·········(0)·····9383·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/changelog.Debian.gz	6	-rw-r--r--···0·root·········(0)·root·········(0)·····9383·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/changelog.Debian.gz
7	-rw-r--r--···0·root·········(0)·root·········(0)···198090·2025-01-07·01:26:09.000000·./usr/share/doc/rust-doc/changelog.gz	7	-rw-r--r--···0·root·········(0)·root·········(0)···198090·2025-01-07·01:26:09.000000·./usr/share/doc/rust-doc/changelog.gz
8	-rw-r--r--···0·root·········(0)·root·········(0)···144664·2025-01-16·19:43:36.000000·./usr/share/doc/rust-doc/copyright	8	-rw-r--r--···0·root·········(0)·root·········(0)···144664·2025-01-16·19:43:36.000000·./usr/share/doc/rust-doc/copyright
9	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/	9	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/
10	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/	10	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/
11	-rw-r--r--···0·root·········(0)·root·········(0)····19195·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/all.html	11	-rw-r--r--···0·root·········(0)·root·········(0)····19195·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/all.html
12	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/	12	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/
13	-rw-r--r--···0·root·········(0)·root·········(0)·····6~~336~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.alloc.html	13	-rw-r--r--···0·root·········(0)·root·········(0)·····6282·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.alloc.html
14	-rw-r--r--···0·root·········(0)·root·········(0)·····6~~307~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.alloc_zeroed.html	14	-rw-r--r--···0·root·········(0)·root·········(0)·····6253·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.alloc_zeroed.html
15	-rw-r--r--···0·root·········(0)·root·········(0)·····4~~841~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.dealloc.html	15	-rw-r--r--···0·root·········(0)·root·········(0)·····4787·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.dealloc.html
16	-rw-r--r--···0·root·········(0)·root·········(0)·····5~~331~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.handle_alloc_error.html	16	-rw-r--r--···0·root·········(0)·root·········(0)·····5250·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.handle_alloc_error.html
17	-rw-r--r--···0·root·········(0)·root·········(0)·····5~~140~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.realloc.html	17	-rw-r--r--···0·root·········(0)·root·········(0)·····5005·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/fn.realloc.html
18	-rw-r--r--···0·root·········(0)·root·········(0)·····7634·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/index.html	18	-rw-r--r--···0·root·········(0)·root·········(0)·····7634·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/index.html
19	-rw-r--r--···0·root·········(0)·root·········(0)······209·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/sidebar-items1.84.0.js	19	-rw-r--r--···0·root·········(0)·root·········(0)······209·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/sidebar-items1.84.0.js
20	-rw-r--r--···0·root·········(0)·root·········(0)····3~~9827~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.AllocError.html	20	-rw-r--r--···0·root·········(0)·root·········(0)····36695·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.AllocError.html
21	-rw-r--r--···0·root·········(0)·root·········(0)····~~41507~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.Global.html	21	-rw-r--r--···0·root·········(0)·root·········(0)····38726·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.Global.html
22	-rw-r--r--···0·root·········(0)·root·········(0)····64667·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.Layout.html	22	-rw-r--r--···0·root·········(0)·root·········(0)····60563·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.Layout.html
23	-rw-r--r--···0·root·········(0)·root·········(0)····~~41692~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.LayoutError.html	23	-rw-r--r--···0·root·········(0)·root·········(0)····38560·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/struct.LayoutError.html
24	-rw-r--r--···0·root·········(0)·root·········(0)····3~~5443~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/trait.Allocator.html	24	-rw-r--r--···0·root·········(0)·root·········(0)····33769·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/trait.Allocator.html
25	-rw-r--r--···0·root·········(0)·root·········(0)····2~~4720~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/trait.GlobalAlloc.html	25	-rw-r--r--···0·root·········(0)·root·········(0)····23991·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/trait.GlobalAlloc.html
26	-rw-r--r--···0·root·········(0)·root·········(0)·····4059·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/type.LayoutErr.html	26	-rw-r--r--···0·root·········(0)·root·········(0)·····4032·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/alloc/type.LayoutErr.html
27	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/	27	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/
28	-rw-r--r--···0·root·········(0)·root·········(0)···1~~89321~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/enum.Cow.html	28	-rw-r--r--···0·root·········(0)·root·········(0)···176550·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/enum.Cow.html
29	-rw-r--r--···0·root·········(0)·root·········(0)·····4648·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/index.html	29	-rw-r--r--···0·root·········(0)·root·········(0)·····4648·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/index.html
30	-rw-r--r--···0·root·········(0)·root·········(0)·······81·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/sidebar-items1.84.0.js	30	-rw-r--r--···0·root·········(0)·root·········(0)·······81·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/sidebar-items1.84.0.js
31	-rw-r--r--···0·root·········(0)·root·········(0)····24~~797~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.Borrow.html	31	-rw-r--r--···0·root·········(0)·root·········(0)····24068·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.Borrow.html
32	-rw-r--r--···0·root·········(0)·root·········(0)····1~~1264~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.BorrowMut.html	32	-rw-r--r--···0·root·········(0)·root·········(0)····10805·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.BorrowMut.html
33	-rw-r--r--···0·root·········(0)·root·········(0)····14~~421~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.ToOwned.html	33	-rw-r--r--···0·root·········(0)·root·········(0)····14259·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/borrow/trait.ToOwned.html
34	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/	34	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/
35	-rw-r--r--···0·root·········(0)·root·········(0)····18~~419~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/index.html	35	-rw-r--r--···0·root·········(0)·root·········(0)····18338·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/index.html
36	-rw-r--r--···0·root·········(0)·root·········(0)·······52·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/sidebar-items1.84.0.js	36	-rw-r--r--···0·root·········(0)·root·········(0)·······52·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/sidebar-items1.84.0.js
37	-rw-r--r--···0·root·········(0)·root·········(0)···5~~92324~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/struct.Box.html	37	-rw-r--r--···0·root·········(0)·root·········(0)···549178·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/struct.Box.html
38	-rw-r--r--···0·root·········(0)·root·········(0)····4~~6676~~·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/struct.ThinBox.html	38	-rw-r--r--···0·root·········(0)·root·········(0)····43598·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/struct.ThinBox.html
39	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/thin/	39	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/thin/
40	-rw-r--r--···0·root·········(0)·root·········(0)······432·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/thin/struct.ThinBox.html	40	-rw-r--r--···0·root·········(0)·root·········(0)······432·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/boxed/thin/struct.ThinBox.html
41	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/collections/	41	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/collections/
42	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/collections/binary_heap/	42	drwxr-xr-x···0·root·········(0)·root·········(0)········0·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/collections/binary_heap/
43	-rw-r--r--···0·root·········(0)·root·········(0)····19432·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/collections/binary_heap/index.html	43	-rw-r--r--···0·root·········(0)·root·········(0)····19432·2025-01-16·19:46:05.000000·./usr/share/doc/rust-doc/html/alloc/collections/binary_heap/index.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="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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)»(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#398-417">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.84.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>	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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)»(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#398-417">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>
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/macro.panic.html"·title="macro·core::panic"><code>panic!</code></a>·or·similar.</p>	4	rather·than·directly·invoking·<a·href="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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, 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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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.84.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	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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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.84.0/~~core/clone~~/trait.~~Clone~~.html"~~·~~tit~~le="trai[·...·truncated·by·diffoscope;·len:·1~~1391~~,·SHA:·34~~c50b~~6b~~baf96f61b133~~38c01f~~d61c~~3c870~~ed9352e278~~156ca58f~~4eb~~d68~~3d5a0~~·...·]/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="../../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·class="struct"·[·...·truncated·by·diffoscope;·len:·10203,·SHA:·923343a2f6d7051d2b32da38831fc204e3a670af4c9ccaca1d5a5f06ad6d8122·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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~~.~~rus~~t-l~~ang.org/1.84.0/~~core/marker~~/trait.~~Copy~~.html"~~·~~tit~~le="trait[·...·truncated·by·diffoscope;·len:·~~4347~~,·SHA:·~~dbe3f6ea4824c0~~ed8e90621e7de~~1c4ce126ba8~~d~~5affe~~61~~8cf~~163cf~~827b3ce1ce~~·...·]/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="../../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/trait.Copy.html"·title="trait·core::marker::Copy">Copy</a>·for·<a·class="struct"·hr[·...·truncated·by·diffoscope;·len:·3969,·SHA:·b172bbc10f8b5dedce36de3e413a1f8a4d9de9611616a4214bf36fd18f0a756b·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·~~47d~~fc2aa0101a4103e2a94c1~~f97~~1~~c559790d87a6~~2d5~~8631fd2~~bfe~~d98~~e~~661~~6~~a34~~·...·]/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="../../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:·ace7a059971745d739c5abd9821e5d1d485cc233fd42150ceb251bdea1ce6bf7·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·9e65~~37066~~2e77fc5c56c9~~8c66~~a5dfda~~3c1d12445~~74dc~~8806ab91a8~~967514~~da78~~·...·]/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="../../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:·8e6f5d2e4a2830729c5d495459113ca6f54993696d7dc71c1f46e5691f5108ed·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·5ca~~6969~~8d4bb~~8de18~~49~~b64ae8~~75~~44dc~~0~~ec2bdd~~1~~a4d8~~dc~~75ba8d~~58b~~2c6c~~6~~a9ae6~~·...·]/core/clone/trait.CloneToUninit.html"·title="trait·core::clone::CloneToUninit">CloneToUninit</a>·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="method·trait-impl"><a·class="s[·...·truncated·by·diffoscope;·len:·819,·SHA:·3ca215d87d373be29774fff31d75c216034e4aa910e49de0e3fc5b88c46bc387·...·]/core/clone/trait.CloneToUninit.html"·title="trait·core::clone::CloneToUninit">CloneToUninit</a>·for·T<div·class="where">where
10	····T:·<a·class="trait"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·~~e07301fb~~9~~e28~~f950d74~~50480a6b68014~~ffc~~dcc~~3~~be12~~b1adda~~27936cb1244~~377e·...·]/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="../../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:·fde0dd5e9bb3fa078effcc98999e7fcc8b1aa390c8b7a3b6a3d8fd02f0c83e78·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/src/core/convert/mod.rs.html#748-750">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.84.0/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="../../src/core/convert/mod.rs.html#748-750">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
12	····U:·<a·class="trait"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·986~~03c35860~~1~~02b3af~~9b5cf~~27aeabf3~~9e~~3c03236~~5519~~86a6ec030817~~f1~~08d~~919·...·]/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="../../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-impl"><a·class=[·...·truncated·by·diffoscope;·len:·156,·SHA:·79561c49c77b14346871935198fc061d00c9e84705db975b0451f5fb4f6af9a0·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>·for·U</code>·chooses·to·do.</p>	14	<code><a·href="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·1~~350~~,·SHA:·~~06ff48~~5~~c70~~db~~27d9~~6df~~4529c~~9aabc34074~~88a0~~d8b~~3f23~~8~~ea19fe87222~~f~~3c0e93~~·...·]/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-2691">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="../../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·trait-impl"><a·class="src·ri[·...·truncated·by·diffoscope;·len:·1296,·SHA:·88285bd52e5f5ad6b3e1b6d101339ab4047bdbd5b9d568c1e216b159cf17296e·...·]/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-2691">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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·~~956~~,·SHA:·5~~fb3~~f~~a997a6fe164f~~1~~c04c1d4cb696121~~571b376241~~266d~~c8~~7e8079e~~bdfed810·...·]/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="../../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="method·trait-impl"><a·class="sr[·...·truncated·by·diffoscope;·len:·875,·SHA:·e58967f6ca4eee938a4135856f0af0adfcd5abe0b4e62c194e5c506c603bfcf1·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·~~db4~~b8~~407e8e20~~5~~81ad139aef2~~5a6221~~a11~~d~~a0f5f18~~d~~6aa3~~5a~~a33e~~b~~843f4e1b9f~~·...·]/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="../../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="associatedtype·trait-impl"><a·c[·...·truncated·by·diffoscope;·len:·1676,·SHA:·4c73b68f4fb433b5f24fbcd660156381e5dd9f46425d075b558b9b6ca0705f88·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·9~~98d5af10fd8895~~6~~7cd999d1~~30~~6bfd16c911~~34d223~~8a3c172f1e7fa~~8~~ed138c1~~8·...·]/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="../../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"·class="associatedtype·trait-imp[·...·truncated·by·diffoscope;·len:·1308,·SHA:·6741e462a0e1b36010204263b7580305663bb27f362987d14303068592f9f358·...·]/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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (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#53">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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (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#53">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#253-343">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#256-258">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.84.0/core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu[·...·truncated·by·diffoscope;·len:·2~~652~~,·SHA:·~~9b01f13e~~b~~290~~c28c49~~b9b~~d72341~~2e3~~7~~df1861977~~235~~6ff9f517c82c476~~f~~ae8f~~d·...·]/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#278-286">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#253-343">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#256-258">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">NonNull</a><[<a·class="primitive"·href="../../core/primi[·...·truncated·by·diffoscope;·len:·2436,·SHA:·5af33344b95d6c264a31d5211d87307e4249e2c53292c7e4eb35905dfb414d38·...·]/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#278-286">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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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.84.0/core/primitive.u8.html">u8</a>>,	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>>,
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu~~[·...·trunca~~te~~d·by~~·~~diffos~~c~~ope;·~~l~~en:·70,·SHA:·242a8643de213d5ba4aab67664~~a~~7846bf3b04cb18867fda~~e~~06ddf025a13~~f~~581~~e·..~~.·]~~/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#290-298">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="../../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">NonNull</a><[<a·class="primitive"·href="../../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#290-298">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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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.84.0/core/primitive.u8.html">u8</a>>,	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>>,
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu~~[·...·trunca~~te~~d·by~~·~~diffos~~c~~ope;·~~l~~en:·70,·SHA:·242a8643de213d5ba4aab67664~~a~~7846bf3b04cb18867fda~~e~~06ddf025a13~~f~~581~~e·..~~.·]~~/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="../../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">NonNull</a><[<a·class="primitive"·href="../../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#302-342">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#302-342">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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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.84.0/core/primitive.u8.html">u8</a>>,	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>>,
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="struct"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/ptr/non_null/struct.NonNull.html"·title="struct·core::ptr::non_null::NonNull">NonNu[·...·truncated·by·diffoscope;·len:·788,·SHA:·~~1786d8b748~~5af75024183~~55c~~df0~~4a3ec3bff82a~~4~~50a~~c~~58337c~~f79b67~~1b1f~~6cd5·...·]/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="../../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">NonNull</a><[<a·class="primitive"·href="../../core/primi[·...·truncated·by·diffoscope;·len:·680,·SHA:·f420ce52f390533b88d002cb92d22a7e54956c16d2ebf58a9123475a4a76a4de·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·~~2417~~c4c3f0~~576~~fe6371~~eb1~~491b~~c11~~bb6~~c87e936~~d~~673b~~2a11e0fb~~4b82fedea235~~·...·]/core/any/trait.Any.html"·title="trait·core::any::Any">Any</a>·for·T<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·experimental·API.·(<code>allocator_ap[·...·truncated·by·diffoscope;·len:·8773,·SHA:·c9c390d25fad71a684a7b27045b066b06b6dd48f02f91fae312b3a963996d6cf·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·~~47d~~fc2aa0101a4103e2a94c1~~f97~~1~~c559790d87a6~~2d5~~8631fd2~~bfe~~d98~~e~~661~~6~~a34~~·...·]/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="../../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:·ace7a059971745d739c5abd9821e5d1d485cc233fd42150ceb251bdea1ce6bf7·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·9e65~~37066~~2e77fc5c56c9~~8c66~~a5dfda~~3c1d12445~~74dc~~8806ab91a8~~967514~~da78~~·...·]/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="../../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:·8e6f5d2e4a2830729c5d495459113ca6f54993696d7dc71c1f46e5691f5108ed·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·5ca~~6969~~8d4bb~~8de18~~49~~b64ae8~~75~~44dc~~0~~ec2bdd~~1~~a4d8~~dc~~75ba8d~~58b~~2c6c~~6~~a9ae6~~·...·]/core/clone/trait.CloneToUninit.html"·title="trait·core::clone::CloneToUninit">CloneToUninit</a>·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="method·trait-impl"><a·class="s[·...·truncated·by·diffoscope;·len:·819,·SHA:·3ca215d87d373be29774fff31d75c216034e4aa910e49de0e3fc5b88c46bc387·...·]/core/clone/trait.CloneToUninit.html"·title="trait·core::clone::CloneToUninit">CloneToUninit</a>·for·T<div·class="where">where
28	····T:·<a·class="trait"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·~~e07301fb~~9~~e28~~f950d74~~50480a6b68014~~ffc~~dcc~~3~~be12~~b1adda~~27936cb1244~~377e·...·]/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="../../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:·fde0dd5e9bb3fa078effcc98999e7fcc8b1aa390c8b7a3b6a3d8fd02f0c83e78·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/src/core/convert/mod.rs.html#748-750">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.84.0/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="../../src/core/convert/mod.rs.html#748-750">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
30	····U:·<a·class="trait"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·986~~03c35860~~1~~02b3af~~9b5cf~~27aeabf3~~9e~~3c03236~~5519~~86a6ec030817~~f1~~08d~~919·...·]/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="../../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-impl"><a·class=[·...·truncated·by·diffoscope;·len:·156,·SHA:·79561c49c77b14346871935198fc061d00c9e84705db975b0451f5fb4f6af9a0·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/convert/trait.From.html"·title="trait·core::convert::From">From</a><T>·for·U</code>·chooses·to·do.</p>	32	<code><a·href="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·~~f368483~~b3c~~0c332~~6~~22730cf~~d8e12~~b999~~a38d~~a274~~28f159611~~e979a~~5a0~~448~~6d0c·...·]/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="../../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·trait-impl"><a·class="src·ri[·...·truncated·by·diffoscope;·len:·1871,·SHA:·5d02ea96bd0cae49516e469609d9e5f2add38a0bdc9952dbf03901b514350c50·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·~~db4~~b8~~407e8e20~~5~~81ad139aef2~~5a6221~~a11~~d~~a0f5f18~~d~~6aa3~~5a~~a33e~~b~~843f4e1b9f~~·...·]/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="../../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="associatedtype·trait-impl"><a·c[·...·truncated·by·diffoscope;·len:·1676,·SHA:·4c73b68f4fb433b5f24fbcd660156381e5dd9f46425d075b558b9b6ca0705f88·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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:·9~~98d5af10fd8895~~6~~7cd999d1~~30~~6bfd16c911~~34d223~~8a3c172f1e7fa~~8~~ed138c1~~8·...·]/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="../../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"·class="associatedtype·trait-imp[·...·truncated·by·diffoscope;·len:·1308,·SHA:·6741e462a0e1b36010204263b7580305663bb27f362987d14303068592f9f358·...·]/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 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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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>	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>
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/primitive.array.html"·title="primitive·array">here</a>.·Unfortunately,·it·was·later·found·that·a·similar	103	edition,·as·documented·<a·href="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/primitive.str.html"·title="primitive·str"><code>str</code></a>·primitive.·Both·are	9	borrowed·slices·of·strings·with·the·<a·href="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/primitive.char.html"·title="primitive·char"><code>char</code></a>·represents·a·‘[Unicode·scalar	30	each.·The·Rust·type·<a·href="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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	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
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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	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
74	is·what·you·would·use·to·wrap·a·raw·<code>*const·<a·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../core/primitive.u8.html"·title="primitive·u8">u8</a></code>·that·you·got·from
75	a·C·function.·A·<a·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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	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
76	of·bytes.·Once·you·have·a·<a·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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	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
77	<code>&<a·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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, 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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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#642-653">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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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#642-653">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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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 1, 21 lines modified		Offset 1, 21 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·output·stream·and·an·`Arguments`·struct·that·can·be·precompiled·with·the·`format_args!`·macro."><title>write·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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">write</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">write</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.84.0/src/core/fmt/mod.rs.html#1171">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·write(output:·&mut·dyn·<a·class="trait"·href="trait.Write.html"·title="trait·alloc::fmt::Write">Write</a>,·args:·<a·class="[·...·truncated·by·diffoscope;·len:·297,·SHA:·292~~b7c8fc2fa5~~8~~56f1c361~~3ce~~6397546896c536~~2d1~~b33a5~~a824f3~~15985a8~~f~~e3b~~·...·]/core/primitive.unit.html">()</a>,·<a·class="struct"·href="struct.Error.html"·title="struct·alloc::fmt::Error">Error</a>></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Takes·an·output·stream·and·an·<code>Arguments</code>·struct·that·can·be·precompiled·with	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·output·stream·and·an·`Arguments`·struct·that·can·be·precompiled·with·the·`format_args!`·macro."><title>write·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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><section·id="rustdoc-toc"><h2·class="location"><a·href="#">write</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">write</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/fmt/mod.rs.html#1171">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·write(output:·&mut·dyn·<a·class="trait"·href="trait.Write.html"·title="trait·alloc::fmt::Write">Write</a>,·args:·<a·class="struct"·href="struct.Argume[·...·truncated·by·diffoscope;·len:·216,·SHA:·898521425b4b2288bdc745a53f8e4ebd3c840a441f4241d7f14af2e32134ff40·...·]/core/primitive.unit.html">()</a>,·<a·class="struct"·href="struct.Error.html"·title="struct·alloc::fmt::Error">Error</a>></code></pre><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Takes·an·output·stream·and·an·<code>Arguments</code>·struct·that·can·be·precompiled·with
2	the·<code>format_args!</code>·macro.</p>	2	the·<code>format_args!</code>·macro.</p>
3	<p>The·arguments·will·be·formatted·according·to·the·specified·format·string	3	<p>The·arguments·will·be·formatted·according·to·the·specified·format·string
4	into·the·output·stream·provided.</p>	4	into·the·output·stream·provided.</p>
5	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>	5	<h2·id="examples"><a·class="doc-anchor"·href="#examples">§</a>Examples</h2>
6	<p>Basic·usage:</p>	6	<p>Basic·usage:</p>

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

8	<span·class="kw">let·</span><span·class="kw-2">mut·</span>output·=·String::new();	8	<span·class="kw">let·</span><span·class="kw-2">mut·</span>output·=·String::new();
9	fmt::write(<span·class="kw-2">&mut·</span>output,·<span·class="macro">format_args!</span>(<span·class="string">"Hello·{}!"</span>,·<span·class="string">"world"</span>))	9	fmt::write(<span·class="kw-2">&mut·</span>output,·<span·class="macro">format_args!</span>(<span·class="string">"Hello·{}!"</span>,·<span·class="string">"world"</span>))
10	····.expect(<span·class="string">"Error·occurred·while·trying·to·write·in·String"</span>);	10	····.expect(<span·class="string">"Error·occurred·while·trying·to·write·in·String"</span>);
11	<span·class="macro">assert_eq!</span>(output,·<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+mut+output+=+String::new();%0A++++fmt::write(%26mut+output,+format_args!(%22Hello+%7B%7D!%22,+%22world%22))%0A++++++++.expect(%22Error+occurred+while+trying+to+write+in+String%22);%0A++++assert_eq!(output,+%22Hello+world!%22);%0A%7D&edition=2021"></a></div>	11	<span·class="macro">assert_eq!</span>(output,·<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+mut+output+=+String::new();%0A++++fmt::write(%26mut+output,+format_args!(%22Hello+%7B%7D!%22,+%22world%22))%0A++++++++.expect(%22Error+occurred+while+trying+to+write+in+String%22);%0A++++assert_eq!(output,+%22Hello+world!%22);%0A%7D&edition=2021"></a></div>
12	<p>Please·note·that·using·<a·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/macro.write.html"·title="macro·core::write"><code>write!</code></a>·might·be·preferable.·Example:</p>	12	<p>Please·note·that·using·<a·href="../../core/macro.write.html"·title="macro·core::write"><code>write!</code></a>·might·be·preferable.·Example:</p>

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

14	<span·class="kw">let·</span><span·class="kw-2">mut·</span>output·=·String::new();	14	<span·class="kw">let·</span><span·class="kw-2">mut·</span>output·=·String::new();
15	<span·class="macro">write!</span>(<span·class="kw-2">&mut·</span>output,·<span·class="string">"Hello·{}!"</span>,·<span·class="string">"world"</span>)	15	<span·class="macro">write!</span>(<span·class="kw-2">&mut·</span>output,·<span·class="string">"Hello·{}!"</span>,·<span·class="string">"world"</span>)
16	····.expect(<span·class="string">"Error·occurred·while·trying·to·write·in·String"</span>);	16	····.expect(<span·class="string">"Error·occurred·while·trying·to·write·in·String"</span>);
17	<span·class="macro">assert_eq!</span>(output,·<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::Write;%0A++++%0A++++let+mut+output+=+String::new();%0A++++write!(%26mut+output,+%22Hello+%7B%7D!%22,+%22world%22)%0A++++++++.expect(%22Error+occurred+while+trying+to+write+in+String%22);%0A++++assert_eq!(output,+%22Hello+world!%22);%0A%7D&edition=2021"></a></div>	17	<span·class="macro">assert_eq!</span>(output,·<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::Write;%0A++++%0A++++let+mut+output+=+String::new();%0A++++write!(%26mut+output,+%22Hello+%7B%7D!%22,+%22world%22)%0A++++++++.expect(%22Error+occurred+while+trying+to+write+in+String%22);%0A++++assert_eq!(output,+%22Hello+world!%22);%0A%7D&edition=2021"></a></div>


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="~~https://doc.rust-lang.org/1~~.84.0/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="../core/cell/index.html"·title="mod·core::cell"><code>Cell</code></a>·or
21	<a·href="~~https://doc.rust-lang.org/1~~.84.0/core/cell/index.html"·title="mod·core::cell"><code>RefCell</code></a>·types·in·order·to·allow·mutation.</p>	21	<a·href="../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="~~https://doc.rust-lang.org/1~~.84.0/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="../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="~~https://doc.rust-lang.org/1~~.84.0/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="../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="~~https://doc.rust-lang.org/1~~.84.0/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="../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="~~https://doc.rust-lang.org/1~~.84.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	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
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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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.84.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>(	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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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>(
2	····range:·<a·class="struct"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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.84.0/core/primitive.pointer.html">*mut·T</a>>,	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>>,
3	)·->·&'a·mut·<a·class="primitive"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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>	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>
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/primitive.pointer.html#method.offset"·title="method·pointer::offset"><code>pointer::offset</code></a>.</p>	36	See·the·safety·documentation·of·<a·href="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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>	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>
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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (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.84.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="~~htt~~ps~~://doc.~~rust-lang.~~org/1.84.0/~~core/ops/range~~/struct~~[·...·truncated·by·diffoscope;·len:·~~245~~,·SHA:·94e~~c7d~~9815~~756d39f7~~c~~4ad7~~aeb45e2549~~0afd~~8ff~~4243~~a1100a~~288775~~849d~~ec50~~·...·]/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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (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/ops/range/struct.Range.html"·title="struct·core::ops::range::Range">Ra[·...·truncated·by·diffoscope;·len:·137,·SHA:·513b729fee33539a98195f1f527bace7cfaeb442b928368ff16c5a31a9690bbc·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/primitive.pointer.html#method.offset"·title="method·pointer::offset"><code>pointer::offset</code></a>.</p>	31	See·the·safety·documentation·of·<a·href="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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>	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>
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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)»(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.84.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="~~htt~~p~~s://d~~oc.rust-lan~~g.org~~/~~1.84.0/~~c~~ore/~~primitive~~.poin~~[·...·truncated·by·diffoscope;·len:·200,·SHA:·~~67877faf6947f~~75b8ca~~2086a~~6bb~~57e~~f~~e3cd8~~12f~~021b~~9~~f9c2c3~~70cc39a6d8~~38b4~~·...·]/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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)»(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/primitive.pointer.html">*const·T</a>,·len:·<a·class="primitive"·href[·...·truncated·by·diffoscope;·len:·92,·SHA:·4b53de10ce32a7528afba1f6b6b02bf040f9ff132f6873092fa01770633dce9d·...·]/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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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>	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>
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/primitive.pointer.html#method.offset"·title="method·pointer::offset"><code>pointer::offset</code></a>.</p>	30	See·the·safety·documentation·of·<a·href="../../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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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.84.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="~~htt~~ps~~://doc.~~rust-lang.~~org/1.84.0/~~core/ops/range~~/struct.~~RangeTo.[·...·truncated·by·diffoscope;·len:·372,·SHA:·9e~~adca93~~ba74~~0a7c25db7c~~3ec5766~~94b241dd98408~~7ba~~2f6fcb3~~a~~6b742~~0~~9bf4d~~·...·]/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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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/ops/range/struct.RangeTo.html"·title="struct·core::ops::range::RangeTo">RangeTo[·...·truncated·by·diffoscope;·len:·237,·SHA:·11efb6f6cb4abfeb419353dc81666551c858f6abf079a883e7c5ae42980559c4·...·]/core/primitive.usize.html">usize</a>><div·class="where">where
2	····R:·<a·class="trait"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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.84.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>	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>
3	<p>This·method·is·similar·to·<a·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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	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
4	<a·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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	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
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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>	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>
8	<p>The·returned·<a·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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.84.0/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="../../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
9	<a·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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>	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>
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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.84.0/src/core/str/converts.rs.html#238">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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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#238">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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/primitive.pointer.html">*mut·</a><a·class="primitive"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/primitive.u8.html">u8</a>,	2	····ptr:·<a·class="primitive"·href="../../core/primitive.pointer.html">*mut·</a><a·class="primitive"·href="../../core/primitive.u8.html">u8</a>,
3	····len:·<a·class="primitive"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/core/primitive.usize.html">usize</a>,	3	····len:·<a·class="primitive"·href="../../core/primitive.usize.html">usize</a>,
4	)·->·&'a·mut·<a·class="primitive"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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>	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>
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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-2691">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.84.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></section><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-2691">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></section><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></div><script·src="../../trait.impl/alloc/string/trait.ToString.js"·async></script></section></div></main></body></html>	19	</div></div><script·src="../../trait.impl/alloc/string/trait.ToString.js"·async></script></section></div></main></body></html>


Offset 85, 9 lines modified		Offset 85, 9 lines modified
85	block_on(<span·class="kw">async·</span>{	85	block_on(<span·class="kw">async·</span>{
86	····<span·class="macro">println!</span>(<span·class="string">"hello·world"</span>);	86	····<span·class="macro">println!</span>(<span·class="string">"hello·world"</span>);
87	});</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%0A%23!%5Bfeature(noop_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	});</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%0A%23!%5Bfeature(noop_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>
88	</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#273">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><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#273">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>
89	</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#283-285">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	</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#283-285">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>
90	<p>If·an·executor·supports·a·cheaper·way·to·wake·without·consuming·the	90	<p>If·an·executor·supports·a·cheaper·way·to·wake·without·consuming·the
91	waker,·it·should·override·this·method.·By·default,·it·clones·the	91	waker,·it·should·override·this·method.·By·default,·it·clones·the
92	<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.84.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	<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>
93	</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.84.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>	93	</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.84.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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="alloc"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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	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
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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,	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,
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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/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="../../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="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.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.84.0/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="../../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>

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 1, 6 lines modified		Offset 1, 6 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="Retrieve·an·environment·variable·and·add·it·to·build·dependency·info.·The·build·system·executing·the·compiler·will·know·that·the·variable·was·accessed·during·compilation,·and·will·be·able·to·rerun·the·build·when·the·value·of·that·variable·changes.·Besides·the·dependency·tracking·this·function·should·be·equivalent·to·`env::var`·from·the·standard·library,·except·that·the·argument·must·be·UTF-8."><title>var·in·proc_macro::tracked_env·-·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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="proc_macro"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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="../../proc_macro/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="../../proc_macro/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../proc_macro/index.html">proc_<wbr>macro</a><span·class="version">1.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·proc_<wbr>macro::<wbr>tracked_<wbr>env</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">proc_macro</a>::<wbr><a·href="index.html">tracked_env</a></span><h1>Function·<span·class="fn">var</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/proc_macro/lib.rs.html#1572-1578">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·var<K:·<a·class="trait"·href="../../core/convert/trait.AsRef.html"·title="trait·core::convert::AsRef">AsRef</a><<a·class="struct"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/std/ffi/os_str/struct.OsStr.html"·title="struct·std::ffi::os_str::OsStr">OsStr</a>>·+·<a·class="trait"·href="../../core/convert/trait.AsRef.html"·title="trait·core::convert::AsRef">AsRef</a><<a·class="primitive"·href=[·...·truncated·by·diffoscope;·len:·~~360~~,·SHA:·1361~~12f81e~~9e09~~94ee7~~98f~~48a~~5a83ffd8~~92c78~~c171c0f8873~~8def2ef~~1c9~~d8f~~93·...·]/std/env/enum.VarError.html"·title="enum·std::env::VarError">VarError</a>></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>proc_macro_tracked_env</code> <a·href="https://github.com/rust-lang/rust/issues/99515">#99515</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Retrieve·an·environment·variable·and·add·it·to·build·dependency·info.	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="Retrieve·an·environment·variable·and·add·it·to·build·dependency·info.·The·build·system·executing·the·compiler·will·know·that·the·variable·was·accessed·during·compilation,·and·will·be·able·to·rerun·the·build·when·the·value·of·that·variable·changes.·Besides·the·dependency·tracking·this·function·should·be·equivalent·to·`env::var`·from·the·standard·library,·except·that·the·argument·must·be·UTF-8."><title>var·in·proc_macro::tracked_env·-·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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="proc_macro"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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="../../proc_macro/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="../../proc_macro/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../proc_macro/index.html">proc_<wbr>macro</a><span·class="version">1.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·proc_<wbr>macro::<wbr>tracked_<wbr>env</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">proc_macro</a>::<wbr><a·href="index.html">tracked_env</a></span><h1>Function·<span·class="fn">var</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/proc_macro/lib.rs.html#1572-1578">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·var<K:·<a·class="trait"·href="../../core/convert/trait.AsRef.html"·title="trait·core::convert::AsRef">AsRef</a><<a·class="struct"·href="../../std/ffi/os_str/struct.OsStr.html"·title="struct·std::ffi::os_str::OsStr">OsStr</a>>·+·<a·class="trait"·href="../../core/convert/trait.AsRef.html"·title="trait·core::convert::AsRef">AsRef</a><<a·class="primitive"·href="../../std/primitive.str.ht[·...·truncated·by·diffoscope;·len:·279,·SHA:·f4cbd961d68b0395039d11ac9c0c27f62c59345df6631c2150b4305da940190b·...·]/std/env/enum.VarError.html"·title="enum·std::env::VarError">VarError</a>></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>proc_macro_tracked_env</code> <a·href="https://github.com/rust-lang/rust/issues/99515">#99515</a>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Retrieve·an·environment·variable·and·add·it·to·build·dependency·info.
2	The·build·system·executing·the·compiler·will·know·that·the·variable·was·accessed·during	2	The·build·system·executing·the·compiler·will·know·that·the·variable·was·accessed·during
3	compilation,·and·will·be·able·to·rerun·the·build·when·the·value·of·that·variable·changes.	3	compilation,·and·will·be·able·to·rerun·the·build·when·the·value·of·that·variable·changes.
4	Besides·the·dependency·tracking·this·function·should·be·equivalent·to·<code>env::var</code>·from·the	4	Besides·the·dependency·tracking·this·function·should·be·equivalent·to·<code>env::var</code>·from·the
5	standard·library,·except·that·the·argument·must·be·UTF-8.</p>	5	standard·library,·except·that·the·argument·must·be·UTF-8.</p>
6	</div></details></section></div></main></body></html>	6	</div></details></section></div></main></body></html>


Offset 1, 4 lines modified		Offset 1, 4 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="Invoked·when·unit·tests·terminate.·Returns·`Result::Err`·if·the·test·is·considered·a·failure.·By·default,·invokes·`report()`·and·checks·for·a·`0`·result."><title>assert_test_result·in·test·-·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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../"·data-static-root-path="../static.files/"·data-current-crate="test"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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="../test/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="../test/index.html"><img·class="rust-logo"·src="../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../test/index.html">test</a><span·class="version">1.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (built»from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"></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">test</a></span><h1>Function·<span·class="fn">assert_test_result</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/test/lib.rs.html#234-244">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·assert_test_result<T:·<a·class="trait"·href="~~https://doc.rust-lang.org/1~~.84.0/std/process/trait.Termination.html"·title="trait·std::process::Termination">Termination</a>>(result:·T)·->·<a·class="enum"·href="../core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·clas~~[·...·t~~ru~~nca~~t~~ed·by·d~~i~~ffoscope;·~~le~~n:·52,·SHA~~:·~~b5c3d3522f82c07d2a3753a37~~05e~~4b44b~~f~~53939000ab34497605c139bc5d4d02~~·...·]/std/primitive.unit.html">()</a>,·<a·class="struct"·href="../alloc/string/struct.String.html"·title="struct·alloc::string::String">String</a>></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>test</code>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Invoked·when·unit·tests·terminate.·Returns·<code>Result::Err</code>·if·the·test·is	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="Invoked·when·unit·tests·terminate.·Returns·`Result::Err`·if·the·test·is·considered·a·failure.·By·default,·invokes·`report()`·and·checks·for·a·`0`·result."><title>assert_test_result·in·test·-·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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../"·data-static-root-path="../static.files/"·data-current-crate="test"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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="../test/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="../test/index.html"><img·class="rust-logo"·src="../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../test/index.html">test</a><span·class="version">1.84.0</span></h2></div><div·class="version">(9fc6b4312» 2025-01-07)» (built»from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"></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">test</a></span><h1>Function·<span·class="fn">assert_test_result</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/test/lib.rs.html#234-244">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·assert_test_result<T:·<a·class="trait"·href="../std/process/trait.Termination.html"·title="trait·std::process::Termination">Termination</a>>(result:·T)·->·<a·class="enum"·href="../core/result/enum.Result.html"·title="enum·core::result::Result">Result</a><<a·class="primitive"·href="../std/primitive.unit.html">()</a>,·<a·class="struct"·href="../alloc/string/struct.String.html"·title="struct·alloc::string::String">String</a>></code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>test</code>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Invoked·when·unit·tests·terminate.·Returns·<code>Result::Err</code>·if·the·test·is
2	considered·a·failure.·By·default,·invokes·<code>report()</code>·and·checks·for·a·<code>0</code>	2	considered·a·failure.·By·default,·invokes·<code>report()</code>·and·checks·for·a·<code>0</code>
3	result.</p>	3	result.</p>
4	</div></details></section></div></main></body></html>	4	</div></details></section></div></main></body></html>


Offset 1, 7 lines modified		Offset 1, 7 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="Winsorize·a·set·of·samples,·replacing·values·above·the·`100-pct`·percentile·and·below·the·`pct`·percentile·with·those·percentiles·themselves.·This·is·a·way·of·minimizing·the·effect·of·outliers,·at·the·cost·of·biasing·the·sample.·It·differs·from·trimming·in·that·it·does·not·change·the·number·of·samples,·just·changes·the·values·of·those·that·are·outliers."><title>winsorize·in·test::stats·-·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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="test"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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="../../test/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="../../test/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../test/index.html">test</a><span·class="version">1.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·test::<wbr>stats</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">test</a>::<wbr><a·href="index.html">stats</a></span><h1>Function·<span·class="fn">winsorize</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/test/stats.rs.html#289-302">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·winsorize(samples:·&mut·[<a·class="primitive"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/std/primitive.f64.html">f64</a>],·pct:·<a·class="primitive"·href="~~https://doc~~.~~rust-lang~~.~~org~~/1.84.0/std/primitive.f64.html">f64</a>)</code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>test</code>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Winsorize·a·set·of·samples,·replacing·values·above·the·<code>100-pct</code>·percentile	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="Winsorize·a·set·of·samples,·replacing·values·above·the·`100-pct`·percentile·and·below·the·`pct`·percentile·with·those·percentiles·themselves.·This·is·a·way·of·minimizing·the·effect·of·outliers,·at·the·cost·of·biasing·the·sample.·It·differs·from·trimming·in·that·it·does·not·change·the·number·of·samples,·just·changes·the·values·of·those·that·are·outliers."><title>winsorize·in·test::stats·-·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-cb410811.css"><meta·name="rustdoc-vars"·data-root-path="../../"·data-static-root-path="../../static.files/"·data-current-crate="test"·data-themes=""·data-resource-suffix="1.84.0"·data-rustdoc-version="1.84.0·(9fc6b4312·2025-01-07)·(built·from·a·source·tarball)"·data-channel="1.84.0"·data-search-js="search-92e6798f.js"·data-settings-js="settings-0f613d39.js"·><script·src="../../static.files/storage-59e33391.js"></script><script·defer·src="sidebar-items1.84.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="../../test/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="../../test/index.html"><img·class="rust-logo"·src="../../static.files/rust-logo-9a9549ea.svg"·alt="logo"></a><h2><a·href="../../test/index.html">test</a><span·class="version">1.84.0</span></h2></div><div·class="version">(9fc6b4312»2025-01-07)» (built» from» a» source» tarball)</div><div·class="sidebar-elems"><div·id="rustdoc-modnav"><h2><a·href="index.html">In·test::<wbr>stats</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">test</a>::<wbr><a·href="index.html">stats</a></span><h1>Function·<span·class="fn">winsorize</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/test/stats.rs.html#289-302">Source</a>·</span></div><pre·class="rust·item-decl"><code>pub·fn·winsorize(samples:·&mut·[<a·class="primitive"·href="../../std/primitive.f64.html">f64</a>],·pct:·<a·class="primitive"·href="../../std/primitive.f64.html">f64</a>)</code></pre><span·class="item-info"><div·class="stab·unstable"><span·class="emoji">🔬</span><span>This·is·a·nightly-only·experimental·API.·(<code>test</code>)</span></div></span><details·class="toggle·top-doc"·open><summary·class="hideme"><span>Expand·description</span></summary><div·class="docblock"><p>Winsorize·a·set·of·samples,·replacing·values·above·the·<code>100-pct</code>·percentile
2	and·below·the·<code>pct</code>·percentile·with·those·percentiles·themselves.·This·is·a	2	and·below·the·<code>pct</code>·percentile·with·those·percentiles·themselves.·This·is·a
3	way·of·minimizing·the·effect·of·outliers,·at·the·cost·of·biasing·the·sample.	3	way·of·minimizing·the·effect·of·outliers,·at·the·cost·of·biasing·the·sample.
4	It·differs·from·trimming·in·that·it·does·not·change·the·number·of·samples,	4	It·differs·from·trimming·in·that·it·does·not·change·the·number·of·samples,
5	just·changes·the·values·of·those·that·are·outliers.</p>	5	just·changes·the·values·of·those·that·are·outliers.</p>
6	<p>See:·<a·href="https://en.wikipedia.org/wiki/Winsorising">https://en.wikipedia.org/wiki/Winsorising</a></p>	6	<p>See:·<a·href="https://en.wikipedia.org/wiki/Winsorising">https://en.wikipedia.org/wiki/Winsorising</a></p>
7	</div></details></section></div></main></body></html>	7	</div></details></section></div></main></body></html>