SYNOPSIS
cc]]filer…
cxx]filer…
BESKRIVELSE
Kommandoerne cc og cxx fungerer som grænseflader til Microsoft C-kompileren (cl).Versioner 5.0 og højere af denne kompiler understøttes.cc er til kompilering af C-filer, mens cxx er til kompilering af C++-filer.
Bemærk:
Opførslen af cc afhænger af, om du arbejder i standardudviklingsmiljøet for MKS Toolkit eller udviklingsmiljøet, der er beregnet til brug med MKS Toolkit UNIX API’er.
cxx er kun tilgængelig i udviklingsmiljøet for PTC MKS Toolkit UNIX API’er.
Disse kommandoer er blot wrappere, der påkalder clutility.Hvis du bruger PTC MKS Toolkit for Professional Developers eller PTC MKS Toolkit for Developers, kontrolleres det under installationen, om der findes clin PATH.For andre Toolkit-produkter skal du selv sikre dig, at cl er i PATH.
Filer med et .c-suffiks anses for at være C-kildefiler, filer med en .cpp- eller .cxx-udvidelse anses for at være C++-kildefiler, og filer med en .asm-udvidelse anses for at være assembler-kildefiler.Tilstedeværelsen af kildefiler med en .cpp- eller .cxx medfører automatisk, at kildefilerne kompileres, som om kommandoencxx var blevet kaldt i stedet.
Kommandoerne cc og cxx indstiller implicit følgende Microsoft compiler-switches (kun for Intel-platforme):
/D_X86_/D_NUTC_=0x430 (Value changes with each release)/Zl/Qifdiv-
Bemærk:
Optionen /D_NUTC_=0x430 er kun indstillet, når der arbejdes i udviklingsmiljøet PTC MKS Toolkit UNIX API’er i PTC MKS Toolkit.
Optionen /Qifdiv- er kun indstillet, når der arbejdes i udviklingsmiljøet PTC MKS Toolkit UNIX API’er og er kun tilgængelig for Microsoft Visual Studio 2.1 eller senere.
Du kan bruge -W/optionflag til at videregive indstillinger direkte til cl.Når du gør dette, skal du være opmærksom på ikke at komme i konflikt med de indstillinger, som denne kommando sætter. F.eks. er standardcompilerensatorens advarselsniveau indstillet til/W3. Indstillingen -W/Wn kan bruges til at tilsidesætte denne standardindstilling.cl-indstillinger angivet med -W tilsidesættercl-indstillinger, der genereres af andre cc orcxx-indstillinger.
Optioner
-c
kompilerer kun – linker ikke.
Denne indstilling bliver til /c-indstillingen til cl.
-C
leder kommentarer igennem til præprocessorudgangen.
Denne indstilling bliver til /C-indstillingen til cl.
-Dname
definerer et præprocessorsymbol med en valgfri værdi.
Denne indstilling bliver /Dname=værdioptionen til cl.
-E
sender alt præprocessoroutput til standardudgangen.
Denne indstilling bliver /E-optionen til cl.
-e epsym
indstiller indgangspunktet (videregives til linker).
-ffloat
angiver de indstillinger for flydende komma, som compileren og linkeren bruger:
-f- no floating point required-f emulated floating point-fp hardware floating point (using 80x87 coprocessor)
Bemærk:
Denne indstilling er forældet og giver en advarsel. Den er til rådighed for bagudkompatibilitet og er ikke tilgængelig med cxxor, når der arbejdes i udviklingsmiljøet PTC MKS Toolkit UNIX API’er.
-g
producerer fejlfindingsoplysninger i de kompilerede objektmoduler.
Denne indstilling bliver til /Z7-indstillingen til cl.
-I directory
tilføjer directory til begyndelsen af listen over mapper, der skal gennemsøges for include-filer (værdien af miljøvariablen %Include%). Alle kataloger, der angives på kommandolinjen, søges først, i den rækkefølge de vises på kommandolinjen.
Denne indstilling bliver til /Idirectory-optionen til cl.
-l library
hvis der linkes, tilføjes det angivne bibliotek til listen over biblioteker, der skal søges i.Ved søgning efter biblioteker (f.eks. med -lfoo), søges der først i hver biblioteksmappe efter UNIX-arkivnavnet (dvs. libfoo.a) og derefter efter biblioteksnavnet i Windows-stil (dvs. foo.lib).
Denne indstilling sendes videre til linkeren.
-L directory
hvis der linkes, tilføjes mappen til begyndelsen af listen over mapper, som linkeren søger efter biblioteker i (værdien af %Lib%miljøvariablen). Alle mapper, der er angivet på kommandolinjen, søges først, i den rækkefølge de vises på kommandolinjen.
Denne indstilling sendes videre til linkeren.
-m
producerer et linkmap.
Denne indstilling sendes videre til linkeren.
-mmodel
angiver den hukommelsesmodel, som compileren og linkeren bruger.Modellerne kan omfatte:
-ms small model-mm medium model-ml large model-mf flat model (32-bit)-mc compact model-mh huge model
Bemærk:
Denne indstilling er forældet og giver en advarsel. Den leveres af hensyn til bagudkompatibilitet og er ikke tilgængelig med cxxor, når der arbejdes i udviklingsmiljøet PTC MKS Toolkit UNIX API’er.
-M
Informationer om flerdobbelt definerede symboler.
Bemærk:
Denne opførsel er kun tilgængelig, når der arbejdes i udviklingsmiljøet PTC MKS Toolkit UNIX API’er. Ellers er -M identisk med indstillingen -m.
-o output
angiver navnet på den outputfil, der genereres af linkeren. Denne indstilling sendes til linkeren.Hvis -c og -o begge er angivet, ignoreres-o indstillingen; du kan dog angive et navn for den objektfil, der genereres med -W/Foobj_file.
Bemærk:
Når der arbejdes i PTC MKS Toolkit UNIX APIs udviklingsmiljøet, ignoreres -ooptionen ikke. I stedet opfører den sig som -W/Foobj_file og angiver navnet på den objektfil, der genereres.
Filnavne, der er angivet med -W/Fo-indstillingen, skal have en .o- eller .obj-udvidelse. Hvis filnavnet ikke har en sådan udvidelse, erstattes dets nuværende udvidelse med .obj, før linkeren påkaldes. Når -cis også er angivet, er der dog ingen begrænsninger på den angivne filudvidelse.
-O
instruerer compileren til at generere optimeret kode.
Denne indstilling bliver til /Ox-indstillingen til cl.
-P
lagrer præprocessoroutput til en fil, hvor filnavnet fås ved at erstatte .c(eller .cpp)-udvidelsen med .i.
-s
hvis linking fjerner debugging-informationer fra outputfilen.
Denne indstilling sendes videre til linkeren.
-S
producerer en assemblerkodeliste. Suffikset for listefilen er .asm. Denne liste indeholder kildekode og samlekode.
Denne indstilling bliver til /FAs-indstillingen til cl.
-static
forespørger linkning mod de statiske C++-kørtidsbiblioteker.
Dette anbefales ikke.
Når denne indstilling ikke er angivet, er /MD tocl standard for C++, og der produceres DLL’er med flere tråde.
-u symname
Ved linkning tilføjes en udefineret reference til symname.
Denne indstilling sendes videre til linkeren.
-U symname
underdefinerer det angivne præprocessorsymbol.
Denne indstilling bliver /Usymnameoption til cl.
-VS num
passes videre til linkerindstillingen /VERSION.
-Wc++
forcerer C++-linking.
Denne indstilling sendes videre til linkeren.
Bemærk:
C++-biblioteksstierne er kun tilgængelige, når der arbejdes i udviklingsmiljøet for PTC MKS Toolkit UNIX-API’erne. Hvis du ikke arbejder i dette miljø, skal du angive disse biblioteksstier med indstillingen -L.
-Wv
vælger verbose-tilstand.
Denne indstilling videregives til linkeren.
-W/option
angiver en option, der skal videregives enten til C-kompileren eller til linkeren med det indledende -W fjernet.Optionerne – subsystem, def,base, entry, implib,machine, map, out,stack og dll – videregives til linkeren;alle andre videregives til kompileren.
-x
når der linkes, fjernes debugginginformationer relateret til lokale symboler fra outputfilen.
Denne indstilling sendes videre til linkeren.
-Xc
kompilerer med streng ANSI C-konformitet.Kun de symboler, der er specificeret i ANSI C-specifikationen, er synlige under kompilering.
Denne indstilling bliver /D__STRICT_ANSI=1 og/D__STDC__=1 til cl.
-Xa -Xs -Xt
kompilerer med ikke-strikt ANSI C-konformitet. Kun de symboler, der er angivet i ANSI C-specifikationen, er synlige under kompilering.
Denne indstilling bliver til /D__STDC__=0 tocl.
Mens denne referenceside beskriver cc som en grænseflade til Microsoft C-kompileren, er det ikke den fulde sandhed. I virkeligheden er cc en konfigurerbar grænseflade til enhver C-compiler og er designet til brug sammen med make. Teoretisk set kan du blot omdefinere cc på hvert system til at arbejde med det pågældende systems C-compiler, og ved blot at bruge cc i dine makefiler kan du bruge de samme makefiler på tværs af forskellige systemer.
cc bruger en kompileringskonfigurationsfil til at konvertere argumenter på en standardkommandolinje til argumenter for den kommando eller sekvens af kommandoer, der er nødvendig for at kalde din compiler ellerlinker. Hvis du vil ændre din compiler eller linker, skal du ændre den relevante konfigurationsfil; du må ikke ændre din makefile.
Den standardkonfigurationsfil for cc er
ROOTDIR/etc/compiler.ccg
Du kan vælge en anden konfigurationsfil ved at indstille miljøvariablen CCG til at pege på den ønskede fil.Grænseflader til andre compilere kan være tilgængelige fra MKS.
Hvis du ønsker, at cc midlertidigt skal bruge en anden compiler, kan du indstille miljøvariablen CCG til navnet på konfigurationsfilen for den ønskede compiler.
Hvis du omdøber den eksekverbare cc-fil, forsøger den at finde sin standardkonfiguration i en .ccg-fil med samme grundnavn som den omdøbte eksekverbare fil.Hvis du f.eks. omdøber cc.exe til c89.exe, søger c89 efter en standardkonfigurationsfil med navnetc89.ccg i ROOTDIR/etc.
Hvis du bruger en compiler, der ikke har en konfigurationsfil, kan du tilpasse en given konfigurationsfil til at bruge din compiler.Læs referencesiden cc diverse oplysninger omhyggeligt, og modificer en eksisterende konfiguration til at bruge din compiler.
ENVIRONMENT VARIABLES
CCG
identificerer konfigurationsfilen for den ønskede compiler.Hvis CCG indeholder -, læser cc standardkonfigurationen fra standardindgangen.Hvis CCG indeholder et filnavn, bruger cc denne fil som standardkonfigurationsfil. hvis CCG indeholder et mappenavn, leder cc efter standardkonfigurationen i filen cc.ccg i den pågældende mappe. hvis den eksekverbare fil er blevet omdøbt, leder den efter standardkonfigurationen i en .ccg-fil med samme navn som den eksekverbare fil. hvis cc.exe f.eks. er omdøbt til c89.exe, leder den efter standardkonfigurationen i $CCG/c89.ccg.
DIAGNOSTICS
Mulige værdier for afslutningsstatus er:
0
Succesfuld afslutning.
>0
Der opstod en fejl.
NOTAT
Hjælpeprogrammet cc starter faktisk, ligesom mange af de andre compilerrelateredekommandoer, et passendeCCG-script (se cc-miscellaneous-referencesiden) for atforbehandle de beskrevne indstillinger, før det kalder Microsoft-compileren for at udføre den egentlige kompilering.Det faktiske CCG-script, der køres, bestemmes af indstillingen af CCG-miljøvariablen (seENVIRONMENT VARIABLES), som kan variere afhængigt af, om du arbejder i NuTCRACKER Platform-udviklingsmiljøet eller ej.
For at ændre cc (f.eks. for at arbejde med en anden compiler), skal du blot ændre det CCG-script, som ccruns baseret på indstillingen af CCG-miljøvariablen.
BARHED
Kommandoen cc er tilgængelig med følgende produkter:
PTC MKS Toolkit for Developers
PTC MKS Toolkit for Interoperability
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition
PTC Windchill Requirements and Validation
Kommandoen cxx er tilgængelig med følgende produkter:
Den cxx er tilgængelig med følgende produkter:
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition
SØG OGSÅ
Kommandoer: ld, make Diverse: cc
PTC MKS Toolkit 10.3 Dokumentation Build 39.