1+ <!doctype html>
2+ < html class ="cpprefjp " lang ="ja " itemscope ="" itemtype ="http://schema.org/WebPage ">
3+ < head >
4+
5+
6+ <!-- Google tag (gtag.js) -->
7+ < script async src ="https://www.googletagmanager.com/gtag/js?id=G-NXNBNVBTJS "> </ script >
8+ < script >
9+ window . dataLayer = window . dataLayer || [ ] ;
10+ function gtag ( ) { dataLayer . push ( arguments ) ; }
11+ gtag ( 'js' , new Date ( ) ) ;
12+
13+ gtag ( 'config' , 'G-NXNBNVBTJS' ) ;
14+ </ script >
15+
16+
17+ < meta charset ="UTF-8 ">
18+
19+ < title > is_sufficiently_aligned - cpprefjp C++日本語リファレンス</ title >
20+
21+ < meta name ="viewport " content ="width=device-width,initial-scale=1 ">
22+ < meta name ="keywords " content ="
23+ C++,標準ライブラリ,リファレンス,ドキュメント,STL,std,memory,function template,std,cpp26
24+ ">
25+ < meta name ="title " content ="is_sufficiently_aligned - cpprefjp C++日本語リファレンス " />
26+ < meta itemprop ="name " content ="is_sufficiently_aligned - cpprefjp C++日本語リファレンス " />
27+ < meta property ="og:title " content ="is_sufficiently_aligned - cpprefjp C++日本語リファレンス " />
28+ < meta property ="og:url " content ="https://cpprefjp.github.io/reference/memory/is_sufficiently_aligned.html " />
29+ < meta property ="og:site_name " content ="cpprefjp - C++日本語リファレンス " />
30+ < meta property ="og:type " content ="article " />
31+ < meta property ="og:description " content ="ポインタ値が指定したアライメントを満たすか否かを返す。 " />
32+ < meta name ="twitter:card " content ="summary " />
33+ < meta name ="twitter:title " content ="is_sufficiently_aligned - cpprefjp C++日本語リファレンス " />
34+ < meta name ="twitter:url " content ="https://cpprefjp.github.io/reference/memory/is_sufficiently_aligned.html " />
35+ < meta name ="twitter:description " content ="ポインタ値が指定したアライメントを満たすか否かを返す。 " />
36+
37+
38+ < link rel ="alternate " type ="application/atom+xml " title ="Atom " href ="https://cpprefjp.github.io/rss.xml " />
39+
40+
41+ < link rel ="apple-touch-icon " sizes ="180x180 " href ="../../static/favicons/apple-touch-icon.png?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 ">
42+ < link rel ="icon " type ="image/png " sizes ="32x32 " href ="../../static/favicons/favicon-32x32.png?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 ">
43+ < link rel ="icon " type ="image/png " sizes ="16x16 " href ="../../static/favicons/favicon-16x16.png?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 ">
44+ < link rel ="manifest " href ="../../manifest.json?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 ">
45+ < meta name ="theme-color " content ="#f5f8fc ">
46+
47+ < link rel ="stylesheet " href ="../../static/pygments/default.css?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 ">
48+ <!-- <link rel="stylesheet" href="../../static/css/root.css"> -->
49+
50+
51+
52+
53+
54+ < link href ="../../static/kunai/css/kunai-stage-0.css?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 " rel ="stylesheet ">
55+ < link href ="../../static/kunai/css/kunai-stage-1.css?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 " rel ="stylesheet ">
56+ < link href ="../../static/kunai/css/kunai-stage-2.css?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 " rel ="stylesheet ">
57+ < link href ="../../static/kunai/css/kunai-stage-3.css?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 " rel ="stylesheet ">
58+
59+ < script type ="text/javascript " src ="../../static/kunai/js/kunai-vendor.js?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 "> </ script >
60+ < script type ="text/javascript " src ="../../static/kunai/js/kunai.js?cachebust=248ec228047e1a42e1ea837fc52a20ca001164c0 "> </ script >
61+
62+ < script type ="text/javascript ">
63+ document . addEventListener ( 'DOMContentLoaded' , function ( ) {
64+ var kn = new Kunai ;
65+ kn . cpprefjp ( ) ;
66+ } ) ;
67+ </ script >
68+
69+ </ head >
70+ < body >
71+ < header data-kunai-mdinfo ="{"meta": {"header": ["memory"], "id-type": ["function template"], "namespace": ["std"], "cpp": ["cpp26"]}, "sources": [{"id": "f59e08f2a992387e6c7508fb5e68d201bb373896", "source": "#include <cassert>\n#include <memory>\n#include <news>\n\nint main()\n{\n int *ptr = new(std::align_val_t{32}) int;\n assert( std::is_sufficiently_aligned<32>(ptr) );\n delete ptr;\n}\n"}], "page_id": ["reference", "memory", "is_sufficiently_aligned"]} ">
72+ < nav class ="navbar navbar-default " role ="navigation ">
73+ < div class ="container-fluid ">
74+ < div class ="navbar-header ">
75+ < button type ="button " class ="navbar-toggle collapsed " data-toggle ="collapse " data-target ="#navbar-collapse ">
76+ < span class ="sr-only "> Toggle navigation</ span >
77+ < span class ="icon-bar "> </ span >
78+ < span class ="icon-bar "> </ span >
79+ < span class ="icon-bar "> </ span >
80+ </ button >
81+ < a class ="navbar-brand " href ="../../index.html ">
82+ < div class ="title-wrapper clearfix ">
83+ < div class ="title "> cpprefjp - C++日本語リファレンス</ div >
84+ </ div >
85+ </ a >
86+ </ div >
87+
88+ < div class ="collapse navbar-collapse " id ="navbar-collapse ">
89+ < ul class ="nav navbar-nav navbar-right ">
90+ < li >
91+ < div class ="google-search ">
92+
93+
94+ < script >
95+ ( function ( ) {
96+ var cx = '013316413321391058734:ji_u66hl7hq' ;
97+ var gcse = document . createElement ( 'script' ) ;
98+ gcse . type = 'text/javascript' ;
99+ gcse . async = true ;
100+ gcse . src = ( document . location . protocol == 'https:' ? 'https:' : 'http:' ) +
101+ '//www.google.com/cse/cse.js?cx=' + cx ;
102+ var s = document . getElementsByTagName ( 'script' ) [ 0 ] ;
103+ s . parentNode . insertBefore ( gcse , s ) ;
104+ } ) ( ) ;
105+ </ script >
106+ < div class ="gcse-search "> </ div >
107+
108+
109+ </ div >
110+ </ li >
111+ < li >
112+ < a href ="https://github.com/cpprefjp/site "> GitHub Project</ a >
113+ </ li >
114+ </ ul >
115+ </ div >
116+ </ div >
117+ </ nav >
118+ </ header >
119+
120+ < main id ="main " role ="main ">
121+ < div class ="container-fluid ">
122+ < div class ="row ">
123+ < div class ="col-sm-9 col-sm-push-3 " itemscope itemtype ="http://schema.org/Article ">
124+ < div class ="row ">
125+ < div class ="col-sm-12 google-search-result ">
126+ < gcse:searchresults > </ gcse:searchresults >
127+ </ div >
128+ </ div >
129+ < div class ="row ">
130+ < div class ="col-sm-12 content-header ">
131+
132+ < ol class ="breadcrumb ">
133+
134+ < li itemscope itemtype ="http://www.schema.org/SiteNavigationElement ">
135+ < span >
136+
137+ < a href ="../../index.html " itemprop ="url ">
138+
139+ < i class ="fa fa-fw fa-home "> </ i >
140+
141+ </ a >
142+
143+ </ span >
144+ </ li >
145+
146+ < li itemscope itemtype ="http://www.schema.org/SiteNavigationElement ">
147+ < span >
148+
149+ < a href ="../../reference.html " itemprop ="url ">
150+
151+ < span itemprop ="name "> リファレンス</ span >
152+
153+ </ a >
154+
155+ </ span >
156+ </ li >
157+
158+ < li itemscope itemtype ="http://www.schema.org/SiteNavigationElement ">
159+ < span >
160+
161+ < a href ="../../reference/memory.html " itemprop ="url ">
162+
163+ < span itemprop ="name "> memory</ span >
164+
165+ </ a >
166+
167+ </ span >
168+ </ li >
169+
170+ < li class ="active " itemscope itemtype ="http://www.schema.org/SiteNavigationElement ">
171+ < span >
172+
173+
174+ < span itemprop ="name "> is_sufficiently_aligned</ span >
175+
176+
177+ </ span >
178+ </ li >
179+
180+ </ ol >
181+ < div class ="crsearch "> </ div >
182+
183+ </ div >
184+ </ div >
185+ < div class ="row ">
186+ < div class ="col-sm-12 edit-button ">
187+
188+
189+ < p class ="text-right "> < small >
190+ 最終更新日時(UTC):
191+ < span itemprop ="datePublished " content ="2024-12-20T01:21:34 ">
192+ 2024年12月20日 01時21分34秒
193+ </ span >
194+ < br />
195+ < span itemprop ="author " itemscope itemtype ="http://schema.org/Person ">
196+ < span itemprop ="name "> yoh</ span >
197+ </ span >
198+ が更新
199+ </ small > </ p >
200+
201+
202+ < p class ="text-right ">
203+ < a class ="history " target ="_blank " href ="https://github.com/cpprefjp/site/commits/master/reference/memory/is_sufficiently_aligned.md ">
204+ < span class ="fa fa-fw fa-clock-o fa-flip-horizontal "> </ span > 履歴
205+ </ a >
206+ < a class ="edit " target ="_blank " href ="https://github.com/cpprefjp/site/edit/master/reference/memory/is_sufficiently_aligned.md ">
207+ < span class ="fa fa-fw fa-pencil "> </ span > 編集
208+ </ a >
209+ </ p >
210+ </ div >
211+ </ div >
212+ < div class ="row ">
213+ < div class ="col-sm-12 content-body ">
214+
215+ < div class ="identifier-type "> function template</ div > < div class ="header "> <memory></ div > < h1 itemprop ="name "> < span class ="namespace " title ="namespace std "> std::</ span > < span class ="token "> is_sufficiently_aligned</ span > < span class ="cpp cpp26 " title ="C++26で追加 "> (C++26)</ span > </ h1 >
216+ < div itemprop ="articleBody "> < p > < div class ="codehilite "> < pre > < span > </ span > < code > < span class ="k "> template</ span > < span class ="o "> <</ span > < span class ="kt "> size_t</ span > < span class ="n "> Alignment</ span > < span class ="p "> ,</ span > < span class ="k "> class</ span > < span class ="nc "> T</ span > < span class ="o "> ></ span >
217+ < span class ="kt "> bool</ span > < span class ="n "> is_sufficiently_aligned</ span > < span class ="p "> (</ span > < span class ="n "> T</ span > < span class ="o "> *</ span > < span class ="n "> ptr</ span > < span class ="p "> );</ span >
218+ </ code > </ pre > </ div >
219+ </ p >
220+ < h2 > 概要</ h2 >
221+ < p > ポインタ値が指定したアライメントを満たすか否かを返す。</ p >
222+ < h2 > 事前条件</ h2 >
223+ < p > ポインタ< code > p</ code > が、< code > T</ code > に類似(similar)した型のオブジェクト< code > X</ code > を指すこと。</ p >
224+ < h2 > 戻り値</ h2 >
225+ < p > < code > X</ code > が少なくとも< code > Alignment</ code > でアライメントされるならば< code > true</ code > 。そうでなければ< code > false</ code > 。</ p >
226+ < h2 > 例外</ h2 >
227+ < p > 投げない</ p >
228+ < h2 > この機能が必要になった背景・経緯</ h2 >
229+ < p > この関数テンプレートは< code > < a href ="../mdspan.html "> <mdspan></ a > </ code > ヘッダへの< code > < span href ="https://cpprefjp.github.io/reference/mdspan/aligned_accessor.md.nolink "> aligned_accessor</ span > </ code > 導入に伴って必要とされた機能である。
230+ 一方で、ポインタ値のアライメント要件を検査するユースケースは一般的と考えられたため、汎用ユーティリティとして< code > <memory></ code > ヘッダに対して機能追加された。</ p >
231+ < h2 > 例</ h2 >
232+ < p > < div class ="yata " id ="f59e08f2a992387e6c7508fb5e68d201bb373896 "> < div class ="codehilite "> < pre > < span > </ span > < code > < span class ="cp "> #include</ span > < span class ="cpf "> < a href ="../cassert.html "> <cassert></ a > </ span > < span class ="cp "> </ span >
233+ < span class ="cp "> #include</ span > < span class ="cpf "> < a href ="../memory.html "> <memory></ a > </ span > < span class ="cp "> </ span >
234+ < span class ="cp "> #include</ span > < span class ="cpf "> <news></ span > < span class ="cp "> </ span >
235+
236+ < span class ="kt "> int</ span > < span class ="nf "> main</ span > < span class ="p "> ()</ span >
237+ < span class ="p "> {</ span >
238+ < span class ="kt "> int</ span > < span class ="o "> *</ span > < span class ="n "> ptr</ span > < span class ="o "> =</ span > < span class ="k "> new</ span > < span class ="p "> (</ span > < span class ="n "> < a href ="../new/align_val_t.html "> std::align_val_t</ a > </ span > < span class ="p "> {</ span > < span class ="mi "> 32</ span > < span class ="p "> })</ span > < span class ="kt "> int</ span > < span class ="p "> ;</ span >
239+ < span class ="n "> < a href ="../cassert/assert.html "> assert</ a > </ span > < span class ="p "> (</ span > < span class ="n "> < span style ="color:#ff0000 "> std::is_sufficiently_aligned</ span > </ span > < span class ="o "> <</ span > < span class ="mi "> 32</ span > < span class ="o "> ></ span > < span class ="p "> (</ span > < span class ="n "> ptr</ span > < span class ="p "> )</ span > < span class ="p "> );</ span >
240+ < span class ="k "> delete</ span > < span class ="n "> ptr</ span > < span class ="p "> ;</ span >
241+ < span class ="p "> }</ span >
242+ </ code > </ pre > </ div >
243+ </ div > </ p >
244+ < h3 > 出力</ h3 >
245+ < p > < pre > < code > </ code > </ pre > </ p >
246+ < h2 > 実装例</ h2 >
247+ < p > < div class ="codehilite "> < pre > < span > </ span > < code > < span class ="c1 "> // 提案文書P2897R7より引用</ span >
248+ < span class ="k "> template</ span > < span class ="o "> <</ span > < span class ="kt "> size_t</ span > < span class ="n "> ByteAlignment</ span > < span class ="p "> ,</ span > < span class ="k "> class</ span > < span class ="nc "> ElementType</ span > < span class ="o "> ></ span >
249+ < span class ="kt "> bool</ span > < span class ="n "> is_sufficiently_aligned</ span > < span class ="p "> (</ span > < span class ="n "> ElementType</ span > < span class ="o "> *</ span > < span class ="n "> p</ span > < span class ="p "> )</ span >
250+ < span class ="p "> {</ span >
251+ < span class ="k "> return</ span > < span class ="n "> < a href ="../bit/bit_cast.html "> bit_cast</ a > </ span > < span class ="o "> <</ span > < span class ="kt "> uintptr_t</ span > < span class ="o "> ></ span > < span class ="p "> (</ span > < span class ="n "> p</ span > < span class ="p "> )</ span > < span class ="o "> %</ span > < span class ="n "> ByteAlignment</ span > < span class ="o "> ==</ span > < span class ="mi "> 0</ span > < span class ="p "> ;</ span >
252+ < span class ="p "> }</ span >
253+ </ code > </ pre > </ div >
254+ </ p >
255+ < h2 > バージョン</ h2 >
256+ < h3 > 言語</ h3 >
257+ < ul >
258+ < li > C++26</ li >
259+ </ ul >
260+ < h3 > 処理系</ h3 >
261+ < ul >
262+ < li > < a href ="../../implementation.html#clang "> Clang</ a > : ??</ li >
263+ < li > < a href ="../../implementation.html#gcc "> GCC</ a > : ??</ li >
264+ < li > < a href ="../../implementation.html#visual_cpp "> Visual C++</ a > : ??</ li >
265+ </ ul >
266+ < h2 > 関連項目</ h2 >
267+ < ul >
268+ < li > < code > < a href ="assume_aligned.html "> assume_aligned</ a > </ code > </ li >
269+ < li > < a href ="../../lang/cpp17/dynamic_memory_allocation_for_over-aligned_data.html "> アライメント指定されたデータの動的メモリ確保</ a > </ li >
270+ </ ul >
271+ < h2 > 参照</ h2 >
272+ < ul >
273+ < li > < a href ="https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2024/p2897r7.html " target ="_blank "> P2897R7 < code > aligned_accessor</ code > : An mdspan accessor expressing pointer over-alignment</ a > </ li >
274+ </ ul > </ div >
275+
276+ </ div >
277+ </ div >
278+ </ div >
279+
280+
281+ < div id ="sidebar " class ="col-sm-3 col-sm-pull-9 ">
282+ </ div >
283+
284+
285+ </ div >
286+ </ div >
287+ </ main >
288+ < footer class ="footer navbar navbar-default ">
289+ < div class ="container-fluid ">
290+ < p > < small >
291+ 本サイトの情報は、
292+ < a href ="https://creativecommons.org/licenses/by/3.0/deed.ja " rel ="nofollow "> クリエイティブ・コモンズ 表示 3.0 非移植 ライセンス(CC BY)</ a >
293+ の下に提供されています。
294+ </ small > </ p >
295+ </ div >
296+ </ footer >
297+ </ body >
298+ </ html >
0 commit comments