File Manager

003 File Manager

Current Path: /usr/src/contrib/llvm-project/clang/include/clang/Basic

usr / src / contrib / llvm-project / clang / include / clang / Basic /

📁 ..
📄 AArch64SVEACLETypes.def(7.09 KB)
📄 ABI.h(5.95 KB)
📄 ASTNode.td(120 B)
📄 AddressSpaces.h(2.59 KB)
📄 AlignedAllocation.h(1.38 KB)
📄 AllDiagnostics.h(1.44 KB)
📄 Attr.td(122.78 KB)
📄 AttrDocs.td(197.8 KB)
📄 AttrKinds.h(929 B)
📄 AttrSubjectMatchRules.h(957 B)
📄 AttributeCommonInfo.h(7.02 KB)
📄 Attributes.h(1.35 KB)
📄 BitmaskEnum.h(749 B)
📄 Builtins.def(71.64 KB)
📄 Builtins.h(9.13 KB)
📄 BuiltinsAArch64.def(14.31 KB)
📄 BuiltinsAMDGPU.def(13.1 KB)
📄 BuiltinsARM.def(18.6 KB)
📄 BuiltinsBPF.def(1016 B)
📄 BuiltinsHexagon.def(6.15 KB)
📄 BuiltinsHexagonDep.def(117.26 KB)
📄 BuiltinsHexagonMapCustomDep.def(8.56 KB)
📄 BuiltinsLe64.def(728 B)
📄 BuiltinsMips.def(35.51 KB)
📄 BuiltinsNEON.def(814 B)
📄 BuiltinsNVPTX.def(27.63 KB)
📄 BuiltinsPPC.def(21.53 KB)
📄 BuiltinsSVE.def(786 B)
📄 BuiltinsSystemZ.def(19.7 KB)
📄 BuiltinsWebAssembly.def(10.17 KB)
📄 BuiltinsX86.def(140.49 KB)
📄 BuiltinsX86_64.def(6.79 KB)
📄 BuiltinsXCore.def(846 B)
📄 CapturedStmt.h(662 B)
📄 CharInfo.h(6.52 KB)
📄 CodeGenOptions.def(21.65 KB)
📄 CodeGenOptions.h(14.14 KB)
📄 CommentNodes.td(1.04 KB)
📄 CommentOptions.h(1.1 KB)
📄 Cuda.h(2.3 KB)
📄 DebugInfoOptions.h(1.72 KB)
📄 DeclNodes.td(4.72 KB)
📄 Diagnostic.h(55.73 KB)
📄 Diagnostic.td(5.29 KB)
📄 DiagnosticAST.h(903 B)
📄 DiagnosticASTKinds.td(29.35 KB)
📄 DiagnosticAnalysis.h(933 B)
📄 DiagnosticAnalysisKinds.td(405 B)
📄 DiagnosticCategories.h(757 B)
📄 DiagnosticCategories.td(480 B)
📄 DiagnosticComment.h(927 B)
📄 DiagnosticCommentKinds.td(6.18 KB)
📄 DiagnosticCommonKinds.td(14.32 KB)
📄 DiagnosticCrossTU.h(927 B)
📄 DiagnosticCrossTUKinds.td(889 B)
📄 DiagnosticDocs.td(1.96 KB)
📄 DiagnosticDriver.h(921 B)
📄 DiagnosticDriverKinds.td(25.54 KB)
📄 DiagnosticError.h(1.98 KB)
📄 DiagnosticFrontend.h(933 B)
📄 DiagnosticFrontendKinds.td(13.86 KB)
📄 DiagnosticGroups.td(59.71 KB)
📄 DiagnosticIDs.h(12.83 KB)
📄 DiagnosticLex.h(903 B)
📄 DiagnosticLexKinds.td(38.36 KB)
📄 DiagnosticOptions.def(4.58 KB)
📄 DiagnosticOptions.h(4.21 KB)
📄 DiagnosticParse.h(915 B)
📄 DiagnosticParseKinds.td(68.47 KB)
📄 DiagnosticRefactoring.h(951 B)
📄 DiagnosticRefactoringKinds.td(1.33 KB)
📄 DiagnosticSema.h(909 B)
📄 DiagnosticSemaKinds.td(546.17 KB)
📄 DiagnosticSerialization.h(962 B)
📄 DiagnosticSerializationKinds.td(18.08 KB)
📄 ExceptionSpecificationType.h(2.48 KB)
📄 ExpressionTraits.h(1.18 KB)
📄 FPOptions.def(1.16 KB)
📄 Features.def(11.55 KB)
📄 FileManager.h(16.39 KB)
📄 FileSystemOptions.h(924 B)
📄 FileSystemStatCache.h(3.26 KB)
📄 FixedPoint.h(8.6 KB)
📄 IdentifierTable.h(33.75 KB)
📄 JsonSupport.h(3.69 KB)
📄 LLVM.h(2.43 KB)
📄 Lambda.h(1.37 KB)
📄 LangOptions.def(21.96 KB)
📄 LangOptions.h(18.78 KB)
📄 LangStandard.h(3.87 KB)
📄 LangStandards.def(6.8 KB)
📄 Linkage.h(4.13 KB)
📄 MSP430Target.def(7.04 KB)
📄 MacroBuilder.h(1.34 KB)
📄 Module.h(24.09 KB)
📄 ObjCRuntime.h(14.36 KB)
📄 OpenCLExtensionTypes.def(1.59 KB)
📄 OpenCLExtensions.def(4.38 KB)
📄 OpenCLImageTypes.def(4.1 KB)
📄 OpenCLOptions.h(4.42 KB)
📄 OpenMPKinds.def(4.58 KB)
📄 OpenMPKinds.h(9.66 KB)
📄 OperatorKinds.def(6.56 KB)
📄 OperatorKinds.h(1.55 KB)
📄 OperatorPrecedence.h(1.82 KB)
📄 PartialDiagnostic.h(12.96 KB)
📄 PlistSupport.h(4.02 KB)
📄 PragmaKinds.h(1.21 KB)
📄 PrettyStackTrace.h(1.26 KB)
📄 SanitizerBlacklist.h(1.73 KB)
📄 SanitizerSpecialCaseList.h(1.81 KB)
📄 Sanitizers.def(6.41 KB)
📄 Sanitizers.h(6.57 KB)
📄 SourceLocation.h(15.56 KB)
📄 SourceManager.h(71.11 KB)
📄 SourceManagerInternals.h(4.27 KB)
📄 Specifiers.h(12.68 KB)
📄 Stack.h(1.94 KB)
📄 StmtNodes.td(10.92 KB)
📄 SyncScope.h(4.87 KB)
📄 TargetBuiltins.h(9.18 KB)
📄 TargetCXXABI.h(12.49 KB)
📄 TargetInfo.h(54.4 KB)
📄 TargetOptions.h(3 KB)
📄 TemplateKinds.h(2.22 KB)
📄 TokenKinds.def(33.83 KB)
📄 TokenKinds.h(3.99 KB)
📄 TypeNodes.td(5.48 KB)
📄 TypeTraits.h(2.67 KB)
📄 Version.h(2.23 KB)
📄 Visibility.h(4.4 KB)
📄 X86Target.def(5.21 KB)
📄 XRayInstr.h(1.92 KB)
📄 XRayLists.h(1.73 KB)
📄 arm_bf16.td(590 B)
📄 arm_cde.td(9.29 KB)
📄 arm_fp16.td(5.79 KB)
📄 arm_mve.td(70.85 KB)
📄 arm_mve_defs.td(24.52 KB)
📄 arm_neon.td(90.63 KB)
📄 arm_neon_incl.td(13.64 KB)
📄 arm_sve.td(162.48 KB)

Editing: ObjCRuntime.h

//===- ObjCRuntime.h - Objective-C Runtime Configuration --------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
//
/// \file
/// Defines types useful for describing an Objective-C runtime.
//
//===----------------------------------------------------------------------===//

#ifndef LLVM_CLANG_BASIC_OBJCRUNTIME_H
#define LLVM_CLANG_BASIC_OBJCRUNTIME_H

#include "clang/Basic/LLVM.h"
#include "llvm/ADT/StringRef.h"
#include "llvm/ADT/Triple.h"
#include "llvm/Support/ErrorHandling.h"
#include "llvm/Support/VersionTuple.h"
#include <string>

namespace clang {

/// The basic abstraction for the target Objective-C runtime.
class ObjCRuntime {
public:
  /// The basic Objective-C runtimes that we know about.
  enum Kind {
    /// 'macosx' is the Apple-provided NeXT-derived runtime on Mac OS
    /// X platforms that use the non-fragile ABI; the version is a
    /// release of that OS.
    MacOSX,

/// 'macosx-fragile' is the Apple-provided NeXT-derived runtime on
    /// Mac OS X platforms that use the fragile ABI; the version is a
    /// release of that OS.
    FragileMacOSX,

/// 'ios' is the Apple-provided NeXT-derived runtime on iOS or the iOS
    /// simulator;  it is always non-fragile.  The version is a release
    /// version of iOS.
    iOS,

/// 'watchos' is a variant of iOS for Apple's watchOS. The version
    /// is a release version of watchOS.
    WatchOS,

/// 'gcc' is the Objective-C runtime shipped with GCC, implementing a
    /// fragile Objective-C ABI
    GCC,

/// 'gnustep' is the modern non-fragile GNUstep runtime.
    GNUstep,

/// 'objfw' is the Objective-C runtime included in ObjFW
    ObjFW
  };

private:
  Kind TheKind = MacOSX;
  VersionTuple Version;

public:
  /// A bogus initialization of the runtime.
  ObjCRuntime() = default;
  ObjCRuntime(Kind kind, const VersionTuple &version)
      : TheKind(kind), Version(version) {}

void set(Kind kind, VersionTuple version) {
    TheKind = kind;
    Version = version;
  }

Kind getKind() const { return TheKind; }
  const VersionTuple &getVersion() const { return Version; }

/// Does this runtime follow the set of implied behaviors for a
  /// "non-fragile" ABI?
  bool isNonFragile() const {
    switch (getKind()) {
    case FragileMacOSX: return false;
    case GCC: return false;
    case MacOSX: return true;
    case GNUstep: return true;
    case ObjFW: return true;
    case iOS: return true;
    case WatchOS: return true;
    }
    llvm_unreachable("bad kind");
  }

/// The inverse of isNonFragile():  does this runtime follow the set of
  /// implied behaviors for a "fragile" ABI?
  bool isFragile() const { return !isNonFragile(); }

/// The default dispatch mechanism to use for the specified architecture
  bool isLegacyDispatchDefaultForArch(llvm::Triple::ArchType Arch) {
    // The GNUstep runtime uses a newer dispatch method by default from
    // version 1.6 onwards
    if (getKind() == GNUstep && getVersion() >= VersionTuple(1, 6)) {
      if (Arch == llvm::Triple::arm ||
          Arch == llvm::Triple::x86 ||
          Arch == llvm::Triple::x86_64)
        return false;
    }
    else if ((getKind() ==  MacOSX) && isNonFragile() &&
             (getVersion() >= VersionTuple(10, 0)) &&
             (getVersion() < VersionTuple(10, 6)))
        return Arch != llvm::Triple::x86_64;
    // Except for deployment target of 10.5 or less,
    // Mac runtimes use legacy dispatch everywhere now.
    return true;
  }

/// Is this runtime basically of the GNU family of runtimes?
  bool isGNUFamily() const {
    switch (getKind()) {
    case FragileMacOSX:
    case MacOSX:
    case iOS:
    case WatchOS:
      return false;
    case GCC:
    case GNUstep:
    case ObjFW:
      return true;
    }
    llvm_unreachable("bad kind");
  }

/// Is this runtime basically of the NeXT family of runtimes?
  bool isNeXTFamily() const {
    // For now, this is just the inverse of isGNUFamily(), but that's
    // not inherently true.
    return !isGNUFamily();
  }

/// Does this runtime allow ARC at all?
  bool allowsARC() const {
    switch (getKind()) {
    case FragileMacOSX:
      // No stub library for the fragile runtime.
      return getVersion() >= VersionTuple(10, 7);
    case MacOSX: return true;
    case iOS: return true;
    case WatchOS: return true;
    case GCC: return false;
    case GNUstep: return true;
    case ObjFW: return true;
    }
    llvm_unreachable("bad kind");
  }

/// Does this runtime natively provide the ARC entrypoints?
  ///
  /// ARC cannot be directly supported on a platform that does not provide
  /// these entrypoints, although it may be supportable via a stub
  /// library.
  bool hasNativeARC() const {
    switch (getKind()) {
    case FragileMacOSX: return getVersion() >= VersionTuple(10, 7);
    case MacOSX: return getVersion() >= VersionTuple(10, 7);
    case iOS: return getVersion() >= VersionTuple(5);
    case WatchOS: return true;

case GCC: return false;
    case GNUstep: return getVersion() >= VersionTuple(1, 6);
    case ObjFW: return true;
    }
    llvm_unreachable("bad kind");
  }

/// Does this runtime provide ARC entrypoints that are likely to be faster
  /// than an ordinary message send of the appropriate selector?
  ///
  /// The ARC entrypoints are guaranteed to be equivalent to just sending the
  /// corresponding message.  If the entrypoint is implemented naively as just a
  /// message send, using it is a trade-off: it sacrifices a few cycles of
  /// overhead to save a small amount of code.  However, it's possible for
  /// runtimes to detect and special-case classes that use "standard"
  /// retain/release behavior; if that's dynamically a large proportion of all
  /// retained objects, using the entrypoint will also be faster than using a
  /// message send.
  ///
  /// When this method returns true, Clang will turn non-super message sends of
  /// certain selectors into calls to the correspond entrypoint:
  ///   retain => objc_retain
  ///   release => objc_release
  ///   autorelease => objc_autorelease
  bool shouldUseARCFunctionsForRetainRelease() const {
    switch (getKind()) {
    case FragileMacOSX:
      return false;
    case MacOSX:
      return getVersion() >= VersionTuple(10, 10);
    case iOS:
      return getVersion() >= VersionTuple(8);
    case WatchOS:
      return true;
    case GCC:
      return false;
    case GNUstep:
      return false;
    case ObjFW:
      return false;
    }
    llvm_unreachable("bad kind");
  }

/// Does this runtime provide entrypoints that are likely to be faster
  /// than an ordinary message send of the "alloc" selector?
  ///
  /// The "alloc" entrypoint is guaranteed to be equivalent to just sending the
  /// corresponding message.  If the entrypoint is implemented naively as just a
  /// message send, using it is a trade-off: it sacrifices a few cycles of
  /// overhead to save a small amount of code.  However, it's possible for
  /// runtimes to detect and special-case classes that use "standard"
  /// alloc behavior; if that's dynamically a large proportion of all
  /// objects, using the entrypoint will also be faster than using a message
  /// send.
  ///
  /// When this method returns true, Clang will turn non-super message sends of
  /// certain selectors into calls to the corresponding entrypoint:
  ///   alloc => objc_alloc
  ///   allocWithZone:nil => objc_allocWithZone
  bool shouldUseRuntimeFunctionsForAlloc() const {
    switch (getKind()) {
    case FragileMacOSX:
      return false;
    case MacOSX:
      return getVersion() >= VersionTuple(10, 10);
    case iOS:
      return getVersion() >= VersionTuple(8);
    case WatchOS:
      return true;

case GCC:
      return false;
    case GNUstep:
      return false;
    case ObjFW:
      return false;
    }
    llvm_unreachable("bad kind");
  }

/// Does this runtime provide the objc_alloc_init entrypoint? This can apply
  /// the same optimization as objc_alloc, but also sends an -init message,
  /// reducing code size on the caller.
  bool shouldUseRuntimeFunctionForCombinedAllocInit() const {
    switch (getKind()) {
    case MacOSX:
      return getVersion() >= VersionTuple(10, 14, 4);
    case iOS:
      return getVersion() >= VersionTuple(12, 2);
    case WatchOS:
      return getVersion() >= VersionTuple(5, 2);
    default:
      return false;
    }
  }

/// Does this runtime supports optimized setter entrypoints?
  bool hasOptimizedSetter() const {
    switch (getKind()) {
      case MacOSX:
        return getVersion() >= VersionTuple(10, 8);
      case iOS:
        return (getVersion() >= VersionTuple(6));
      case WatchOS:
        return true;
      case GNUstep:
        return getVersion() >= VersionTuple(1, 7);
      default:
        return false;
    }
  }

/// Does this runtime allow the use of __weak?
  bool allowsWeak() const {
    return hasNativeWeak();
  }

/// Does this runtime natively provide ARC-compliant 'weak'
  /// entrypoints?
  bool hasNativeWeak() const {
    // Right now, this is always equivalent to whether the runtime
    // natively supports ARC decision.
    return hasNativeARC();
  }

/// Does this runtime directly support the subscripting methods?
  ///
  /// This is really a property of the library, not the runtime.
  bool hasSubscripting() const {
    switch (getKind()) {
    case FragileMacOSX: return false;
    case MacOSX: return getVersion() >= VersionTuple(10, 11);
    case iOS: return getVersion() >= VersionTuple(9);
    case WatchOS: return true;

// This is really a lie, because some implementations and versions
    // of the runtime do not support ARC.  Probably -fgnu-runtime
    // should imply a "maximal" runtime or something?
    case GCC: return true;
    case GNUstep: return true;
    case ObjFW: return true;
    }
    llvm_unreachable("bad kind");
  }

/// Does this runtime allow sizeof or alignof on object types?
  bool allowsSizeofAlignof() const {
    return isFragile();
  }

/// Does this runtime allow pointer arithmetic on objects?
  ///
  /// This covers +, -, ++, --, and (if isSubscriptPointerArithmetic()
  /// yields true) [].
  bool allowsPointerArithmetic() const {
    switch (getKind()) {
    case FragileMacOSX:
    case GCC:
      return true;
    case MacOSX:
    case iOS:
    case WatchOS:
    case GNUstep:
    case ObjFW:
      return false;
    }
    llvm_unreachable("bad kind");
  }

/// Is subscripting pointer arithmetic?
  bool isSubscriptPointerArithmetic() const {
    return allowsPointerArithmetic();
  }

/// Does this runtime provide an objc_terminate function?
  ///
  /// This is used in handlers for exceptions during the unwind process;
  /// without it, abort() must be used in pure ObjC files.
  bool hasTerminate() const {
    switch (getKind()) {
    case FragileMacOSX: return getVersion() >= VersionTuple(10, 8);
    case MacOSX: return getVersion() >= VersionTuple(10, 8);
    case iOS: return getVersion() >= VersionTuple(5);
    case WatchOS: return true;
    case GCC: return false;
    case GNUstep: return false;
    case ObjFW: return false;
    }
    llvm_unreachable("bad kind");
  }

/// Does this runtime support weakly importing classes?
  bool hasWeakClassImport() const {
    switch (getKind()) {
    case MacOSX: return true;
    case iOS: return true;
    case WatchOS: return true;
    case FragileMacOSX: return false;
    case GCC: return true;
    case GNUstep: return true;
    case ObjFW: return true;
    }
    llvm_unreachable("bad kind");
  }

/// Does this runtime use zero-cost exceptions?
  bool hasUnwindExceptions() const {
    switch (getKind()) {
    case MacOSX: return true;
    case iOS: return true;
    case WatchOS: return true;
    case FragileMacOSX: return false;
    case GCC: return true;
    case GNUstep: return true;
    case ObjFW: return true;
    }
    llvm_unreachable("bad kind");
  }

bool hasAtomicCopyHelper() const {
    switch (getKind()) {
    case FragileMacOSX:
    case MacOSX:
    case iOS:
    case WatchOS:
      return true;
    case GNUstep:
      return getVersion() >= VersionTuple(1, 7);
    default: return false;
    }
  }

/// Is objc_unsafeClaimAutoreleasedReturnValue available?
  bool hasARCUnsafeClaimAutoreleasedReturnValue() const {
    switch (getKind()) {
    case MacOSX:
    case FragileMacOSX:
      return getVersion() >= VersionTuple(10, 11);
    case iOS:
      return getVersion() >= VersionTuple(9);
    case WatchOS:
      return getVersion() >= VersionTuple(2);
    case GNUstep:
      return false;
    default:
      return false;
    }
  }

/// Are the empty collection symbols available?
  bool hasEmptyCollections() const {
    switch (getKind()) {
    default:
      return false;
    case MacOSX:
      return getVersion() >= VersionTuple(10, 11);
    case iOS:
      return getVersion() >= VersionTuple(9);
    case WatchOS:
      return getVersion() >= VersionTuple(2);
    }
  }

/// Returns true if this Objective-C runtime supports Objective-C class
  /// stubs.
  bool allowsClassStubs() const {
    switch (getKind()) {
    case FragileMacOSX:
    case GCC:
    case GNUstep:
    case ObjFW:
      return false;
    case MacOSX:
    case iOS:
    case WatchOS:
      return true;
    }
    llvm_unreachable("bad kind");
  }

/// Does this runtime supports direct dispatch
  bool allowsDirectDispatch() const {
    switch (getKind()) {
    case FragileMacOSX: return false;
    case MacOSX: return true;
    case iOS: return true;
    case WatchOS: return true;
    case GCC: return false;
    case GNUstep: return false;
    case ObjFW: return false;
    }
    llvm_unreachable("bad kind");
  }

/// Try to parse an Objective-C runtime specification from the given
  /// string.
  ///
  /// \return true on error.
  bool tryParse(StringRef input);

std::string getAsString() const;

friend bool operator==(const ObjCRuntime &left, const ObjCRuntime &right) {
    return left.getKind() == right.getKind() &&
           left.getVersion() == right.getVersion();
  }

friend bool operator!=(const ObjCRuntime &left, const ObjCRuntime &right) {
    return !(left == right);
  }

friend llvm::hash_code hash_value(const ObjCRuntime &OCR) {
    return llvm::hash_combine(OCR.getKind(), OCR.getVersion());
  }
};

raw_ostream &operator<<(raw_ostream &out, const ObjCRuntime &value);

} // namespace clang

#endif // LLVM_CLANG_BASIC_OBJCRUNTIME_H

003 File Manager

Editing: ObjCRuntime.h

Upload File

Create Folder