1 //===-- llvm/ADT/Triple.h - Target triple helper class ----------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 #ifndef LLVM_ADT_TRIPLE_H
11 #define LLVM_ADT_TRIPLE_H
17 /// Triple - Helper class for working with target triples.
19 /// Target triples are strings in the format of:
20 /// ARCHITECTURE-VENDOR-OPERATING_SYSTEM
22 /// ARCHITECTURE-VENDOR-OPERATING_SYSTEM-ENVIRONMENT
24 /// This class is used for clients which want to support arbitrary
25 /// target triples, but also want to implement certain special
26 /// behavior for particular targets. This class isolates the mapping
27 /// from the components of the target triple to well known IDs.
29 /// See autoconf/config.guess for a glimpse into what they look like
39 x86_64, // amd64, x86_64
61 /// The parsed arch type (or InvalidArch if uninitialized).
62 mutable ArchType Arch;
64 /// The parsed vendor type.
65 mutable VendorType Vendor;
67 /// The parsed OS type.
70 bool isInitialized() const { return Arch != InvalidArch; }
74 /// @name Constructors
77 Triple() : Data(""), Arch(InvalidArch) {}
78 explicit Triple(const char *Str) : Data(Str), Arch(InvalidArch) {}
79 explicit Triple(const char *ArchStr, const char *VendorStr, const char *OSStr)
80 : Data(ArchStr), Arch(InvalidArch) {
88 /// @name Typed Component Access
91 /// getArch - Get the parsed architecture type of this triple.
92 ArchType getArch() const {
93 if (!isInitialized()) Parse();
97 /// getVendor - Get the parsed vendor type of this triple.
98 VendorType getVendor() const {
99 if (!isInitialized()) Parse();
103 /// getOS - Get the parsed operating system type of this triple.
104 OSType getOS() const {
105 if (!isInitialized()) Parse();
109 /// hasEnvironment - Does this triple have the optional environment
110 /// (fourth) component?
111 bool hasEnvironment() const {
112 return getEnvironmentName() != "";
116 /// @name Direct Component Access
119 const std::string &getTriple() const { return Data; }
121 // FIXME: Invent a lightweight string representation for these to
124 /// getArchName - Get the architecture (first) component of the
126 std::string getArchName() const;
128 /// getVendorName - Get the vendor (second) component of the triple.
129 std::string getVendorName() const;
131 /// getOSName - Get the operating system (third) component of the
133 std::string getOSName() const;
135 /// getEnvironmentName - Get the optional environment (fourth)
136 /// component of the triple, or "" if empty.
137 std::string getEnvironmentName() const;
139 /// getOSAndEnvironmentName - Get the operating system and optional
140 /// environment components as a single string (separated by a '-'
141 /// if the environment component is present).
142 std::string getOSAndEnvironmentName() const;
148 /// setArch - Set the architecture (first) component of the triple
150 void setArch(ArchType Kind);
152 /// setVendor - Set the vendor (second) component of the triple to a
154 void setVendor(VendorType Kind);
156 /// setOS - Set the operating system (third) component of the triple
158 void setOS(OSType Kind);
160 /// setTriple - Set all components to the new triple \arg Str.
161 void setTriple(const std::string &Str);
163 /// setArchName - Set the architecture (first) component of the
165 void setArchName(const std::string &Str);
167 /// setVendorName - Set the vendor (second) component of the triple
169 void setVendorName(const std::string &Str);
171 /// setOSName - Set the operating system (third) component of the
173 void setOSName(const std::string &Str);
175 /// setEnvironmentName - Set the optional environment (fourth)
176 /// component of the triple by name.
177 void setEnvironmentName(const std::string &Str);
179 /// setOSAndEnvironmentName - Set the operating system and optional
180 /// environment components with a single string.
181 void setOSAndEnvironmentName(const std::string &Str);
184 /// @name Static helpers for IDs.
187 /// getArchTypeName - Get the canonical name for the \arg Kind
189 static const char *getArchTypeName(ArchType Kind);
191 /// getVendorTypeName - Get the canonical name for the \arg Kind
193 static const char *getVendorTypeName(VendorType Kind);
195 /// getOSTypeName - Get the canonical name for the \arg Kind vendor.
196 static const char *getOSTypeName(OSType Kind);
201 } // End llvm namespace