1 //===- llvm/DerivedTypes.h - Classes for handling data types ----*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This file contains the declarations of classes that represent "derived
10 // types". These are things like "arrays of x" or "structure of x, y, z" or
11 // "function returning x taking (y,z) as parameters", etc...
12 //
13 // The implementations of these classes live in the Type.cpp file.
14 //
15 //===----------------------------------------------------------------------===//
16
17 #ifndef LLVM_IR_DERIVEDTYPES_H
18 #define LLVM_IR_DERIVEDTYPES_H
19
20 #include "llvm/ADT/ArrayRef.h"
21 #include "llvm/ADT/STLExtras.h"
22 #include "llvm/ADT/StringRef.h"
23 #include "llvm/IR/Type.h"
24 #include "llvm/Support/Casting.h"
25 #include "llvm/Support/Compiler.h"
26 #include "llvm/Support/TypeSize.h"
27 #include <cassert>
28 #include <cstdint>
29
30 namespace llvm {
31
32 class Value;
33 class APInt;
34 class LLVMContext;
35
36 /// Class to represent integer types. Note that this class is also used to
37 /// represent the built-in integer types: Int1Ty, Int8Ty, Int16Ty, Int32Ty and
38 /// Int64Ty.
39 /// Integer representation type
40 class IntegerType : public Type {
41 friend class LLVMContextImpl;
42
43 protected:
IntegerType(LLVMContext & C,unsigned NumBits)44 explicit IntegerType(LLVMContext &C, unsigned NumBits) : Type(C, IntegerTyID){
45 setSubclassData(NumBits);
46 }
47
48 public:
49 /// This enum is just used to hold constants we need for IntegerType.
50 enum {
51 MIN_INT_BITS = 1, ///< Minimum number of bits that can be specified
52 MAX_INT_BITS = (1<<24)-1 ///< Maximum number of bits that can be specified
53 ///< Note that bit width is stored in the Type classes SubclassData field
54 ///< which has 24 bits. This yields a maximum bit width of 16,777,215
55 ///< bits.
56 };
57
58 /// This static method is the primary way of constructing an IntegerType.
59 /// If an IntegerType with the same NumBits value was previously instantiated,
60 /// that instance will be returned. Otherwise a new one will be created. Only
61 /// one instance with a given NumBits value is ever created.
62 /// Get or create an IntegerType instance.
63 static IntegerType *get(LLVMContext &C, unsigned NumBits);
64
65 /// Returns type twice as wide the input type.
getExtendedType()66 IntegerType *getExtendedType() const {
67 return Type::getIntNTy(getContext(), 2 * getScalarSizeInBits());
68 }
69
70 /// Get the number of bits in this IntegerType
getBitWidth()71 unsigned getBitWidth() const { return getSubclassData(); }
72
73 /// Return a bitmask with ones set for all of the bits that can be set by an
74 /// unsigned version of this type. This is 0xFF for i8, 0xFFFF for i16, etc.
getBitMask()75 uint64_t getBitMask() const {
76 return ~uint64_t(0UL) >> (64-getBitWidth());
77 }
78
79 /// Return a uint64_t with just the most significant bit set (the sign bit, if
80 /// the value is treated as a signed number).
getSignBit()81 uint64_t getSignBit() const {
82 return 1ULL << (getBitWidth()-1);
83 }
84
85 /// For example, this is 0xFF for an 8 bit integer, 0xFFFF for i16, etc.
86 /// @returns a bit mask with ones set for all the bits of this type.
87 /// Get a bit mask for this type.
88 APInt getMask() const;
89
90 /// Methods for support type inquiry through isa, cast, and dyn_cast.
classof(const Type * T)91 static bool classof(const Type *T) {
92 return T->getTypeID() == IntegerTyID;
93 }
94 };
95
getIntegerBitWidth()96 unsigned Type::getIntegerBitWidth() const {
97 return cast<IntegerType>(this)->getBitWidth();
98 }
99
100 /// Class to represent function types
101 ///
102 class FunctionType : public Type {
103 FunctionType(Type *Result, ArrayRef<Type*> Params, bool IsVarArgs);
104
105 public:
106 FunctionType(const FunctionType &) = delete;
107 FunctionType &operator=(const FunctionType &) = delete;
108
109 /// This static method is the primary way of constructing a FunctionType.
110 static FunctionType *get(Type *Result,
111 ArrayRef<Type*> Params, bool isVarArg);
112
113 /// Create a FunctionType taking no parameters.
114 static FunctionType *get(Type *Result, bool isVarArg);
115
116 /// Return true if the specified type is valid as a return type.
117 static bool isValidReturnType(Type *RetTy);
118
119 /// Return true if the specified type is valid as an argument type.
120 static bool isValidArgumentType(Type *ArgTy);
121
isVarArg()122 bool isVarArg() const { return getSubclassData()!=0; }
getReturnType()123 Type *getReturnType() const { return ContainedTys[0]; }
124
125 using param_iterator = Type::subtype_iterator;
126
param_begin()127 param_iterator param_begin() const { return ContainedTys + 1; }
param_end()128 param_iterator param_end() const { return &ContainedTys[NumContainedTys]; }
params()129 ArrayRef<Type *> params() const {
130 return makeArrayRef(param_begin(), param_end());
131 }
132
133 /// Parameter type accessors.
getParamType(unsigned i)134 Type *getParamType(unsigned i) const { return ContainedTys[i+1]; }
135
136 /// Return the number of fixed parameters this function type requires.
137 /// This does not consider varargs.
getNumParams()138 unsigned getNumParams() const { return NumContainedTys - 1; }
139
140 /// Methods for support type inquiry through isa, cast, and dyn_cast.
classof(const Type * T)141 static bool classof(const Type *T) {
142 return T->getTypeID() == FunctionTyID;
143 }
144 };
145 static_assert(alignof(FunctionType) >= alignof(Type *),
146 "Alignment sufficient for objects appended to FunctionType");
147
isFunctionVarArg()148 bool Type::isFunctionVarArg() const {
149 return cast<FunctionType>(this)->isVarArg();
150 }
151
getFunctionParamType(unsigned i)152 Type *Type::getFunctionParamType(unsigned i) const {
153 return cast<FunctionType>(this)->getParamType(i);
154 }
155
getFunctionNumParams()156 unsigned Type::getFunctionNumParams() const {
157 return cast<FunctionType>(this)->getNumParams();
158 }
159
160 /// A handy container for a FunctionType+Callee-pointer pair, which can be
161 /// passed around as a single entity. This assists in replacing the use of
162 /// PointerType::getElementType() to access the function's type, since that's
163 /// slated for removal as part of the [opaque pointer types] project.
164 class FunctionCallee {
165 public:
166 // Allow implicit conversion from types which have a getFunctionType member
167 // (e.g. Function and InlineAsm).
168 template <typename T, typename U = decltype(&T::getFunctionType)>
FunctionCallee(T * Fn)169 FunctionCallee(T *Fn)
170 : FnTy(Fn ? Fn->getFunctionType() : nullptr), Callee(Fn) {}
171
FunctionCallee(FunctionType * FnTy,Value * Callee)172 FunctionCallee(FunctionType *FnTy, Value *Callee)
173 : FnTy(FnTy), Callee(Callee) {
174 assert((FnTy == nullptr) == (Callee == nullptr));
175 }
176
FunctionCallee(std::nullptr_t)177 FunctionCallee(std::nullptr_t) {}
178
179 FunctionCallee() = default;
180
getFunctionType()181 FunctionType *getFunctionType() { return FnTy; }
182
getCallee()183 Value *getCallee() { return Callee; }
184
185 explicit operator bool() { return Callee; }
186
187 private:
188 FunctionType *FnTy = nullptr;
189 Value *Callee = nullptr;
190 };
191
192 /// Class to represent struct types. There are two different kinds of struct
193 /// types: Literal structs and Identified structs.
194 ///
195 /// Literal struct types (e.g. { i32, i32 }) are uniqued structurally, and must
196 /// always have a body when created. You can get one of these by using one of
197 /// the StructType::get() forms.
198 ///
199 /// Identified structs (e.g. %foo or %42) may optionally have a name and are not
200 /// uniqued. The names for identified structs are managed at the LLVMContext
201 /// level, so there can only be a single identified struct with a given name in
202 /// a particular LLVMContext. Identified structs may also optionally be opaque
203 /// (have no body specified). You get one of these by using one of the
204 /// StructType::create() forms.
205 ///
206 /// Independent of what kind of struct you have, the body of a struct type are
207 /// laid out in memory consecutively with the elements directly one after the
208 /// other (if the struct is packed) or (if not packed) with padding between the
209 /// elements as defined by DataLayout (which is required to match what the code
210 /// generator for a target expects).
211 ///
212 class StructType : public Type {
StructType(LLVMContext & C)213 StructType(LLVMContext &C) : Type(C, StructTyID) {}
214
215 enum {
216 /// This is the contents of the SubClassData field.
217 SCDB_HasBody = 1,
218 SCDB_Packed = 2,
219 SCDB_IsLiteral = 4,
220 SCDB_IsSized = 8
221 };
222
223 /// For a named struct that actually has a name, this is a pointer to the
224 /// symbol table entry (maintained by LLVMContext) for the struct.
225 /// This is null if the type is an literal struct or if it is a identified
226 /// type that has an empty name.
227 void *SymbolTableEntry = nullptr;
228
229 public:
230 StructType(const StructType &) = delete;
231 StructType &operator=(const StructType &) = delete;
232
233 /// This creates an identified struct.
234 static StructType *create(LLVMContext &Context, StringRef Name);
235 static StructType *create(LLVMContext &Context);
236
237 static StructType *create(ArrayRef<Type *> Elements, StringRef Name,
238 bool isPacked = false);
239 static StructType *create(ArrayRef<Type *> Elements);
240 static StructType *create(LLVMContext &Context, ArrayRef<Type *> Elements,
241 StringRef Name, bool isPacked = false);
242 static StructType *create(LLVMContext &Context, ArrayRef<Type *> Elements);
243 template <class... Tys>
244 static std::enable_if_t<are_base_of<Type, Tys...>::value, StructType *>
create(StringRef Name,Type * elt1,Tys * ...elts)245 create(StringRef Name, Type *elt1, Tys *... elts) {
246 assert(elt1 && "Cannot create a struct type with no elements with this");
247 SmallVector<llvm::Type *, 8> StructFields({elt1, elts...});
248 return create(StructFields, Name);
249 }
250
251 /// This static method is the primary way to create a literal StructType.
252 static StructType *get(LLVMContext &Context, ArrayRef<Type*> Elements,
253 bool isPacked = false);
254
255 /// Create an empty structure type.
256 static StructType *get(LLVMContext &Context, bool isPacked = false);
257
258 /// This static method is a convenience method for creating structure types by
259 /// specifying the elements as arguments. Note that this method always returns
260 /// a non-packed struct, and requires at least one element type.
261 template <class... Tys>
262 static std::enable_if_t<are_base_of<Type, Tys...>::value, StructType *>
get(Type * elt1,Tys * ...elts)263 get(Type *elt1, Tys *... elts) {
264 assert(elt1 && "Cannot create a struct type with no elements with this");
265 LLVMContext &Ctx = elt1->getContext();
266 SmallVector<llvm::Type *, 8> StructFields({elt1, elts...});
267 return llvm::StructType::get(Ctx, StructFields);
268 }
269
270 /// Return the type with the specified name, or null if there is none by that
271 /// name.
272 static StructType *getTypeByName(LLVMContext &C, StringRef Name);
273
isPacked()274 bool isPacked() const { return (getSubclassData() & SCDB_Packed) != 0; }
275
276 /// Return true if this type is uniqued by structural equivalence, false if it
277 /// is a struct definition.
isLiteral()278 bool isLiteral() const { return (getSubclassData() & SCDB_IsLiteral) != 0; }
279
280 /// Return true if this is a type with an identity that has no body specified
281 /// yet. These prints as 'opaque' in .ll files.
isOpaque()282 bool isOpaque() const { return (getSubclassData() & SCDB_HasBody) == 0; }
283
284 /// isSized - Return true if this is a sized type.
285 bool isSized(SmallPtrSetImpl<Type *> *Visited = nullptr) const;
286
287 /// Returns true if this struct contains a scalable vector.
288 bool containsScalableVectorType() const;
289
290 /// Return true if this is a named struct that has a non-empty name.
hasName()291 bool hasName() const { return SymbolTableEntry != nullptr; }
292
293 /// Return the name for this struct type if it has an identity.
294 /// This may return an empty string for an unnamed struct type. Do not call
295 /// this on an literal type.
296 StringRef getName() const;
297
298 /// Change the name of this type to the specified name, or to a name with a
299 /// suffix if there is a collision. Do not call this on an literal type.
300 void setName(StringRef Name);
301
302 /// Specify a body for an opaque identified type.
303 void setBody(ArrayRef<Type*> Elements, bool isPacked = false);
304
305 template <typename... Tys>
306 std::enable_if_t<are_base_of<Type, Tys...>::value, void>
setBody(Type * elt1,Tys * ...elts)307 setBody(Type *elt1, Tys *... elts) {
308 assert(elt1 && "Cannot create a struct type with no elements with this");
309 SmallVector<llvm::Type *, 8> StructFields({elt1, elts...});
310 setBody(StructFields);
311 }
312
313 /// Return true if the specified type is valid as a element type.
314 static bool isValidElementType(Type *ElemTy);
315
316 // Iterator access to the elements.
317 using element_iterator = Type::subtype_iterator;
318
element_begin()319 element_iterator element_begin() const { return ContainedTys; }
element_end()320 element_iterator element_end() const { return &ContainedTys[NumContainedTys];}
elements()321 ArrayRef<Type *> const elements() const {
322 return makeArrayRef(element_begin(), element_end());
323 }
324
325 /// Return true if this is layout identical to the specified struct.
326 bool isLayoutIdentical(StructType *Other) const;
327
328 /// Random access to the elements
getNumElements()329 unsigned getNumElements() const { return NumContainedTys; }
getElementType(unsigned N)330 Type *getElementType(unsigned N) const {
331 assert(N < NumContainedTys && "Element number out of range!");
332 return ContainedTys[N];
333 }
334 /// Given an index value into the type, return the type of the element.
335 Type *getTypeAtIndex(const Value *V) const;
getTypeAtIndex(unsigned N)336 Type *getTypeAtIndex(unsigned N) const { return getElementType(N); }
337 bool indexValid(const Value *V) const;
indexValid(unsigned Idx)338 bool indexValid(unsigned Idx) const { return Idx < getNumElements(); }
339
340 /// Methods for support type inquiry through isa, cast, and dyn_cast.
classof(const Type * T)341 static bool classof(const Type *T) {
342 return T->getTypeID() == StructTyID;
343 }
344 };
345
getStructName()346 StringRef Type::getStructName() const {
347 return cast<StructType>(this)->getName();
348 }
349
getStructNumElements()350 unsigned Type::getStructNumElements() const {
351 return cast<StructType>(this)->getNumElements();
352 }
353
getStructElementType(unsigned N)354 Type *Type::getStructElementType(unsigned N) const {
355 return cast<StructType>(this)->getElementType(N);
356 }
357
358 /// Class to represent array types.
359 class ArrayType : public Type {
360 /// The element type of the array.
361 Type *ContainedType;
362 /// Number of elements in the array.
363 uint64_t NumElements;
364
365 ArrayType(Type *ElType, uint64_t NumEl);
366
367 public:
368 ArrayType(const ArrayType &) = delete;
369 ArrayType &operator=(const ArrayType &) = delete;
370
getNumElements()371 uint64_t getNumElements() const { return NumElements; }
getElementType()372 Type *getElementType() const { return ContainedType; }
373
374 /// This static method is the primary way to construct an ArrayType
375 static ArrayType *get(Type *ElementType, uint64_t NumElements);
376
377 /// Return true if the specified type is valid as a element type.
378 static bool isValidElementType(Type *ElemTy);
379
380 /// Methods for support type inquiry through isa, cast, and dyn_cast.
classof(const Type * T)381 static bool classof(const Type *T) {
382 return T->getTypeID() == ArrayTyID;
383 }
384 };
385
getArrayNumElements()386 uint64_t Type::getArrayNumElements() const {
387 return cast<ArrayType>(this)->getNumElements();
388 }
389
390 /// Base class of all SIMD vector types
391 class VectorType : public Type {
392 /// A fully specified VectorType is of the form <vscale x n x Ty>. 'n' is the
393 /// minimum number of elements of type Ty contained within the vector, and
394 /// 'vscale x' indicates that the total element count is an integer multiple
395 /// of 'n', where the multiple is either guaranteed to be one, or is
396 /// statically unknown at compile time.
397 ///
398 /// If the multiple is known to be 1, then the extra term is discarded in
399 /// textual IR:
400 ///
401 /// <4 x i32> - a vector containing 4 i32s
402 /// <vscale x 4 x i32> - a vector containing an unknown integer multiple
403 /// of 4 i32s
404
405 /// The element type of the vector.
406 Type *ContainedType;
407
408 protected:
409 /// The element quantity of this vector. The meaning of this value depends
410 /// on the type of vector:
411 /// - For FixedVectorType = <ElementQuantity x ty>, there are
412 /// exactly ElementQuantity elements in this vector.
413 /// - For ScalableVectorType = <vscale x ElementQuantity x ty>,
414 /// there are vscale * ElementQuantity elements in this vector, where
415 /// vscale is a runtime-constant integer greater than 0.
416 const unsigned ElementQuantity;
417
418 VectorType(Type *ElType, unsigned EQ, Type::TypeID TID);
419
420 public:
421 VectorType(const VectorType &) = delete;
422 VectorType &operator=(const VectorType &) = delete;
423
424 /// Get the number of elements in this vector. It does not make sense to call
425 /// this function on a scalable vector, and this will be moved into
426 /// FixedVectorType in a future commit
427 LLVM_ATTRIBUTE_DEPRECATED(
428 inline unsigned getNumElements() const,
429 "Calling this function via a base VectorType is deprecated. Either call "
430 "getElementCount() and handle the case where Scalable is true or cast to "
431 "FixedVectorType.");
432
getElementType()433 Type *getElementType() const { return ContainedType; }
434
435 /// This static method is the primary way to construct an VectorType.
436 static VectorType *get(Type *ElementType, ElementCount EC);
437
get(Type * ElementType,unsigned NumElements,bool Scalable)438 static VectorType *get(Type *ElementType, unsigned NumElements,
439 bool Scalable) {
440 return VectorType::get(ElementType,
441 ElementCount::get(NumElements, Scalable));
442 }
443
get(Type * ElementType,const VectorType * Other)444 static VectorType *get(Type *ElementType, const VectorType *Other) {
445 return VectorType::get(ElementType, Other->getElementCount());
446 }
447
448 /// This static method gets a VectorType with the same number of elements as
449 /// the input type, and the element type is an integer type of the same width
450 /// as the input element type.
getInteger(VectorType * VTy)451 static VectorType *getInteger(VectorType *VTy) {
452 unsigned EltBits = VTy->getElementType()->getPrimitiveSizeInBits();
453 assert(EltBits && "Element size must be of a non-zero size");
454 Type *EltTy = IntegerType::get(VTy->getContext(), EltBits);
455 return VectorType::get(EltTy, VTy->getElementCount());
456 }
457
458 /// This static method is like getInteger except that the element types are
459 /// twice as wide as the elements in the input type.
getExtendedElementVectorType(VectorType * VTy)460 static VectorType *getExtendedElementVectorType(VectorType *VTy) {
461 assert(VTy->isIntOrIntVectorTy() && "VTy expected to be a vector of ints.");
462 auto *EltTy = cast<IntegerType>(VTy->getElementType());
463 return VectorType::get(EltTy->getExtendedType(), VTy->getElementCount());
464 }
465
466 // This static method gets a VectorType with the same number of elements as
467 // the input type, and the element type is an integer or float type which
468 // is half as wide as the elements in the input type.
getTruncatedElementVectorType(VectorType * VTy)469 static VectorType *getTruncatedElementVectorType(VectorType *VTy) {
470 Type *EltTy;
471 if (VTy->getElementType()->isFloatingPointTy()) {
472 switch(VTy->getElementType()->getTypeID()) {
473 case DoubleTyID:
474 EltTy = Type::getFloatTy(VTy->getContext());
475 break;
476 case FloatTyID:
477 EltTy = Type::getHalfTy(VTy->getContext());
478 break;
479 default:
480 llvm_unreachable("Cannot create narrower fp vector element type");
481 }
482 } else {
483 unsigned EltBits = VTy->getElementType()->getPrimitiveSizeInBits();
484 assert((EltBits & 1) == 0 &&
485 "Cannot truncate vector element with odd bit-width");
486 EltTy = IntegerType::get(VTy->getContext(), EltBits / 2);
487 }
488 return VectorType::get(EltTy, VTy->getElementCount());
489 }
490
491 // This static method returns a VectorType with a smaller number of elements
492 // of a larger type than the input element type. For example, a <16 x i8>
493 // subdivided twice would return <4 x i32>
getSubdividedVectorType(VectorType * VTy,int NumSubdivs)494 static VectorType *getSubdividedVectorType(VectorType *VTy, int NumSubdivs) {
495 for (int i = 0; i < NumSubdivs; ++i) {
496 VTy = VectorType::getDoubleElementsVectorType(VTy);
497 VTy = VectorType::getTruncatedElementVectorType(VTy);
498 }
499 return VTy;
500 }
501
502 /// This static method returns a VectorType with half as many elements as the
503 /// input type and the same element type.
getHalfElementsVectorType(VectorType * VTy)504 static VectorType *getHalfElementsVectorType(VectorType *VTy) {
505 auto EltCnt = VTy->getElementCount();
506 assert(EltCnt.isKnownEven() &&
507 "Cannot halve vector with odd number of elements.");
508 return VectorType::get(VTy->getElementType(),
509 EltCnt.divideCoefficientBy(2));
510 }
511
512 /// This static method returns a VectorType with twice as many elements as the
513 /// input type and the same element type.
getDoubleElementsVectorType(VectorType * VTy)514 static VectorType *getDoubleElementsVectorType(VectorType *VTy) {
515 auto EltCnt = VTy->getElementCount();
516 assert((EltCnt.getKnownMinValue() * 2ull) <= UINT_MAX &&
517 "Too many elements in vector");
518 return VectorType::get(VTy->getElementType(), EltCnt * 2);
519 }
520
521 /// Return true if the specified type is valid as a element type.
522 static bool isValidElementType(Type *ElemTy);
523
524 /// Return an ElementCount instance to represent the (possibly scalable)
525 /// number of elements in the vector.
526 inline ElementCount getElementCount() const;
527
528 /// Methods for support type inquiry through isa, cast, and dyn_cast.
classof(const Type * T)529 static bool classof(const Type *T) {
530 return T->getTypeID() == FixedVectorTyID ||
531 T->getTypeID() == ScalableVectorTyID;
532 }
533 };
534
getNumElements()535 unsigned VectorType::getNumElements() const {
536 ElementCount EC = getElementCount();
537 #ifdef STRICT_FIXED_SIZE_VECTORS
538 assert(!EC.isScalable() &&
539 "Request for fixed number of elements from scalable vector");
540 #else
541 if (EC.isScalable())
542 WithColor::warning()
543 << "The code that requested the fixed number of elements has made the "
544 "assumption that this vector is not scalable. This assumption was "
545 "not correct, and this may lead to broken code\n";
546 #endif
547 return EC.getKnownMinValue();
548 }
549
550 /// Class to represent fixed width SIMD vectors
551 class FixedVectorType : public VectorType {
552 protected:
FixedVectorType(Type * ElTy,unsigned NumElts)553 FixedVectorType(Type *ElTy, unsigned NumElts)
554 : VectorType(ElTy, NumElts, FixedVectorTyID) {}
555
556 public:
557 static FixedVectorType *get(Type *ElementType, unsigned NumElts);
558
get(Type * ElementType,const FixedVectorType * FVTy)559 static FixedVectorType *get(Type *ElementType, const FixedVectorType *FVTy) {
560 return get(ElementType, FVTy->getNumElements());
561 }
562
getInteger(FixedVectorType * VTy)563 static FixedVectorType *getInteger(FixedVectorType *VTy) {
564 return cast<FixedVectorType>(VectorType::getInteger(VTy));
565 }
566
getExtendedElementVectorType(FixedVectorType * VTy)567 static FixedVectorType *getExtendedElementVectorType(FixedVectorType *VTy) {
568 return cast<FixedVectorType>(VectorType::getExtendedElementVectorType(VTy));
569 }
570
getTruncatedElementVectorType(FixedVectorType * VTy)571 static FixedVectorType *getTruncatedElementVectorType(FixedVectorType *VTy) {
572 return cast<FixedVectorType>(
573 VectorType::getTruncatedElementVectorType(VTy));
574 }
575
getSubdividedVectorType(FixedVectorType * VTy,int NumSubdivs)576 static FixedVectorType *getSubdividedVectorType(FixedVectorType *VTy,
577 int NumSubdivs) {
578 return cast<FixedVectorType>(
579 VectorType::getSubdividedVectorType(VTy, NumSubdivs));
580 }
581
getHalfElementsVectorType(FixedVectorType * VTy)582 static FixedVectorType *getHalfElementsVectorType(FixedVectorType *VTy) {
583 return cast<FixedVectorType>(VectorType::getHalfElementsVectorType(VTy));
584 }
585
getDoubleElementsVectorType(FixedVectorType * VTy)586 static FixedVectorType *getDoubleElementsVectorType(FixedVectorType *VTy) {
587 return cast<FixedVectorType>(VectorType::getDoubleElementsVectorType(VTy));
588 }
589
classof(const Type * T)590 static bool classof(const Type *T) {
591 return T->getTypeID() == FixedVectorTyID;
592 }
593
getNumElements()594 unsigned getNumElements() const { return ElementQuantity; }
595 };
596
597 /// Class to represent scalable SIMD vectors
598 class ScalableVectorType : public VectorType {
599 protected:
ScalableVectorType(Type * ElTy,unsigned MinNumElts)600 ScalableVectorType(Type *ElTy, unsigned MinNumElts)
601 : VectorType(ElTy, MinNumElts, ScalableVectorTyID) {}
602
603 public:
604 static ScalableVectorType *get(Type *ElementType, unsigned MinNumElts);
605
get(Type * ElementType,const ScalableVectorType * SVTy)606 static ScalableVectorType *get(Type *ElementType,
607 const ScalableVectorType *SVTy) {
608 return get(ElementType, SVTy->getMinNumElements());
609 }
610
getInteger(ScalableVectorType * VTy)611 static ScalableVectorType *getInteger(ScalableVectorType *VTy) {
612 return cast<ScalableVectorType>(VectorType::getInteger(VTy));
613 }
614
615 static ScalableVectorType *
getExtendedElementVectorType(ScalableVectorType * VTy)616 getExtendedElementVectorType(ScalableVectorType *VTy) {
617 return cast<ScalableVectorType>(
618 VectorType::getExtendedElementVectorType(VTy));
619 }
620
621 static ScalableVectorType *
getTruncatedElementVectorType(ScalableVectorType * VTy)622 getTruncatedElementVectorType(ScalableVectorType *VTy) {
623 return cast<ScalableVectorType>(
624 VectorType::getTruncatedElementVectorType(VTy));
625 }
626
getSubdividedVectorType(ScalableVectorType * VTy,int NumSubdivs)627 static ScalableVectorType *getSubdividedVectorType(ScalableVectorType *VTy,
628 int NumSubdivs) {
629 return cast<ScalableVectorType>(
630 VectorType::getSubdividedVectorType(VTy, NumSubdivs));
631 }
632
633 static ScalableVectorType *
getHalfElementsVectorType(ScalableVectorType * VTy)634 getHalfElementsVectorType(ScalableVectorType *VTy) {
635 return cast<ScalableVectorType>(VectorType::getHalfElementsVectorType(VTy));
636 }
637
638 static ScalableVectorType *
getDoubleElementsVectorType(ScalableVectorType * VTy)639 getDoubleElementsVectorType(ScalableVectorType *VTy) {
640 return cast<ScalableVectorType>(
641 VectorType::getDoubleElementsVectorType(VTy));
642 }
643
644 /// Get the minimum number of elements in this vector. The actual number of
645 /// elements in the vector is an integer multiple of this value.
getMinNumElements()646 uint64_t getMinNumElements() const { return ElementQuantity; }
647
classof(const Type * T)648 static bool classof(const Type *T) {
649 return T->getTypeID() == ScalableVectorTyID;
650 }
651 };
652
getElementCount()653 inline ElementCount VectorType::getElementCount() const {
654 return ElementCount::get(ElementQuantity, isa<ScalableVectorType>(this));
655 }
656
657 /// Class to represent pointers.
658 class PointerType : public Type {
659 explicit PointerType(Type *ElType, unsigned AddrSpace);
660
661 Type *PointeeTy;
662
663 public:
664 PointerType(const PointerType &) = delete;
665 PointerType &operator=(const PointerType &) = delete;
666
667 /// This constructs a pointer to an object of the specified type in a numbered
668 /// address space.
669 static PointerType *get(Type *ElementType, unsigned AddressSpace);
670
671 /// This constructs a pointer to an object of the specified type in the
672 /// generic address space (address space zero).
getUnqual(Type * ElementType)673 static PointerType *getUnqual(Type *ElementType) {
674 return PointerType::get(ElementType, 0);
675 }
676
getElementType()677 Type *getElementType() const { return PointeeTy; }
678
679 /// Return true if the specified type is valid as a element type.
680 static bool isValidElementType(Type *ElemTy);
681
682 /// Return true if we can load or store from a pointer to this type.
683 static bool isLoadableOrStorableType(Type *ElemTy);
684
685 /// Return the address space of the Pointer type.
getAddressSpace()686 inline unsigned getAddressSpace() const { return getSubclassData(); }
687
688 /// Implement support type inquiry through isa, cast, and dyn_cast.
classof(const Type * T)689 static bool classof(const Type *T) {
690 return T->getTypeID() == PointerTyID;
691 }
692 };
693
getExtendedType()694 Type *Type::getExtendedType() const {
695 assert(
696 isIntOrIntVectorTy() &&
697 "Original type expected to be a vector of integers or a scalar integer.");
698 if (auto *VTy = dyn_cast<VectorType>(this))
699 return VectorType::getExtendedElementVectorType(
700 const_cast<VectorType *>(VTy));
701 return cast<IntegerType>(this)->getExtendedType();
702 }
703
getWithNewBitWidth(unsigned NewBitWidth)704 Type *Type::getWithNewBitWidth(unsigned NewBitWidth) const {
705 assert(
706 isIntOrIntVectorTy() &&
707 "Original type expected to be a vector of integers or a scalar integer.");
708 Type *NewType = getIntNTy(getContext(), NewBitWidth);
709 if (auto *VTy = dyn_cast<VectorType>(this))
710 NewType = VectorType::get(NewType, VTy->getElementCount());
711 return NewType;
712 }
713
getPointerAddressSpace()714 unsigned Type::getPointerAddressSpace() const {
715 return cast<PointerType>(getScalarType())->getAddressSpace();
716 }
717
718 } // end namespace llvm
719
720 #endif // LLVM_IR_DERIVEDTYPES_H
721