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