dmcs - Online in de Cloud

PROGRAMMA:

NAAM

mcs - Mono C#-compiler

KORTE INHOUD

mcs [optie] [bronbestanden]

PRODUCTBESCHRIJVING

mcs is de Mono C#-compiler, een implementatie van de ECMA-334-taalspecificatie.
U kunt een of meer opties doorgeven om de compiler aan te sturen, en een set bronbestanden. Extra
opties of argumenten kunnen worden verstrekt in een antwoordbestand. Naar responsbestanden wordt verwezen door
door het @-symbool voor de bestandsnaam van het antwoord te plaatsen.

De mcs compiler wordt gebruikt om te compileren tegen de nieuwste Mono Base Class Library-versie en
implementeert volledig C# 1.0, 2.0, 3.0 en 4.0 specificaties.

Zie het gedeelte over pakketten voor meer informatie.

De Mono C#-compiler accepteert dezelfde opdrachtregelopties als de Microsoft C#-compiler
doet. Die opties kunnen beginnen met een schuine streep of een streepje (/checked is hetzelfde als -checked).
Bovendien worden enkele GNU-achtige opties ondersteund, die beginnen met "--". Allemaal MCS-specifiek
vlaggen die niet beschikbaar zijn in de Microsoft C#-compiler zijn alleen beschikbaar met de
Opties in GNU-stijl.

C#-bronbestanden moeten eindigen met de extensie ".cs". Compilatie van C#-broncode vereist
alle bestanden waaruit een bibliotheek, module of uitvoerbaar bestand bestaat die op de opdracht moeten worden verstrekt
lijn. Er is geen ondersteuning voor gedeeltelijke compilatie. Om de voordelen van gedeeltelijk te bereiken
compileren, moet u programma's compileren in hun eigen samenstellingen en latere referentie
ze met de vlag "-r".

De Mono C#-compiler genereert afbeeldingen (.exe-bestanden) die CIL-bytecode kunnen bevatten
uitgevoerd door elk systeem dat een virtuele Common Language Infrastructure-machine implementeert
zoals de Microsoft .NET runtime engine op Windows of de Mono runtime engine op Unix
systemen. Uitvoerbare bestanden zijn niet gebonden aan een specifieke CPU of besturingssysteem.

De Mono C#-compiler verwijst standaard alleen naar drie assembly's: mscorlib.dll, System.dll
en System.Xml.dll. Als u naar extra bibliotheken wilt verwijzen, moet u dit handmatig opgeven
ze met behulp van de -pkg: opdrachtregeloptie of de -r: opdrachtregeloptie. Alternatief als
Als u alle systeembibliotheken wilt ophalen, kunt u de opdrachtregel -pkg:dotnet gebruiken
optie.

OPTIES

--over
Geeft informatie weer over de Mono C#-compiler

--module toevoegen:MODULE1[,MODULE2]
Bevat de gespecificeerde modules in de resulterende samenstelling. Modules worden gemaakt door
de compiler aanroepen met de optie -target:module

-gecontroleerd, -gecontroleerd+
Stelt de standaard compilatiemodus in op `aangevinkt'. Dit maakt alle wiskundige bewerkingen
aangevinkt (de standaard is uitgevinkt).

-gecontroleerd-
Stelt de standaard compilatiemodus in op `niet aangevinkt'. Dit maakt alle wiskunde
bewerkingen niet aangevinkt (dit is de standaard).

-clscheck-, -clcheck+
Schakelt de Common Language Specification (CLS)-controles in of uit (deze is ingeschakeld
standaard).

De Common Language Specification (CLS) definieert een interoperabele subset van typen als
evenals conventies waaraan compilers (CLS-producenten) en ontwikkelaars zich moeten houden
stel code bloot aan andere programmeertalen (CLS-consumenten).

-codepagina:ID
Specificeert de codepagina die wordt gebruikt om de invoerbestanden te verwerken vanaf het punt waar het is
gespecificeerd op. Bestanden worden standaard omgevingsafhankelijk verwerkt
native codepagina. De compiler zal ook automatisch Unicode-bestanden detecteren die
hebben een ingesloten bytemarkering aan het begin.

Andere populaire coderingen zijn 28591 (Latin1), 1252 (iso-8859-1) en 65001 (UTF-8).

MCS ondersteunt een aantal afkortingen: "utf8" kan worden gebruikt om utf-8 te specificeren in plaats van
het gebruik van de cryptische 65001 en "reset" herstelt de automatische afhandeling van codepagina's.
Deze afkortingen zijn niet beschikbaar in de Microsoft-compiler.

-definieer:SYMLIJST, -d:SYMLIJST
Definieert het symbool dat wordt weergegeven door de door puntkomma's gescheiden lijst SYMLIST SYMBOL. Dit
kan worden getest in de broncode door de pre-processor, of kan worden gebruikt door methoden
die zijn getagd met het voorwaardelijke attribuut.

-debuggen, -debuggen+
Foutopsporingsinformatie genereren. Om stacktraceringen met foutopsporingsinformatie te verkrijgen,
je moet de mono runtime aanroepen met de vlag `--debug'. Het debuggen
informatie wordt opgeslagen in een MDB-bestand in dezelfde uitvoermap als geproduceerd
bijeenkomst.

-debuggen-
Genereer geen foutopsporingsinformatie.

-vertragingsteken+
Sluit alleen de publieke sleutel van de sterke naam in de assembly in. De eigenlijke ondertekening moet zijn
in een later stadium gedaan met behulp van de SN-tool. Dit is handig om de privésleutel te beschermen
tijdens de ontwikkeling. Houd er rekening mee dat het uitstellen van ondertekening alleen kan worden gedaan met behulp van een sterke naamsleutel
bestand (geen sleutelcontainer). De optie komt overeen met het opnemen van [montage:
AssemblyDelaySign (true)] in uw broncode. De compileroptie heeft voorrang
boven de attributen.

-vertragingsteken-
Standaard. Strongname (onderteken) de assembly met behulp van het strongname-sleutelbestand (of
opvangbak). De optie is gelijk aan het opnemen van [assembly: AssemblyDelaySign
(false)] in uw broncode. De compileroptie heeft voorrang op de attributen.

-doc:BESTAND
Haalt de C#/XML-documentatie uit de broncode en slaat deze op in de gegeven
HET DOSSIER.

-foutenrapport
Deze vlag wordt genegeerd door de C#-compiler van Mono en is alleen aanwezig om MCS mogelijk te maken
gebruikt als CSC-vervanging voor msbuild/xbuild.

-- fataal
Dit wordt gebruikt voor het debuggen van de compiler. Hierdoor genereert de foutemissie een
uitzondering die kan worden opgevangen door een debugger.

-bestand uitlijnen
Deze vlag wordt genegeerd door de C#-compiler van Mono en is alleen aanwezig om MCS mogelijk te maken
gebruikt als CSC-vervanging voor msbuild/xbuild.

-volledigepaden
Elke broncodefout of waarschuwing uitgegeven door de compiler bevat alleen de bestandsnaam door
standaard. Deze optie zorgt ervoor dat de compiler in plaats daarvan een absoluut bestandspad geeft.

-sleutelbestand:SLEUTELBESTAND
Strongname (onderteken) de output-assembly met behulp van het sleutelpaar dat aanwezig is in de opgegeven
sterk naamsleutelbestand (snk). Standaard is een volledig sleutelpaar vereist (of bij gebruik van
vertragingsteken-). Een bestand dat alleen de openbare sleutel bevat, kan worden gebruikt met delaysign+. De
optie is gelijk aan het opnemen van [assembly: AssemblyKeyFile ("KEYFILE")] in uw
broncode. De compileroptie heeft voorrang op de attributen.

-sleutelcontainer:CONTAINER
Strongname (onderteken) de output-assembly met behulp van het sleutelpaar dat aanwezig is in de opgegeven
container. Merk op dat delaysign+ wordt genegeerd bij het gebruik van sleutelcontainers. De optie is
gelijk aan het opnemen van [assembly: AssemblyKeyName ("CONTAINER")] in uw bron
code. De compileroptie heeft voorrang op de attributen.

-langversie:TEXT
De optie specificeert de versie van de te gebruiken taal. De functieset is
verschillend in elke C#-versie. Deze schakelaar kan worden gebruikt om de compiler te forceren
slechts een subset van de functies toestaan. De mogelijke waarden zijn:

Standaard
Instrueer de compiler om de nieuwste versie te gebruiken. Equivalent is het weglaten van de
schakelaar (dit is momenteel standaard de C# 4.0-taalspecificatie).

ISO-1 Beperk de compiler om alleen de eerste ISO-gestandaardiseerde functies te gebruiken. Het gebruik van
functies zoals generieke geneesmiddelen, statische klassen en anonieme methoden zullen leiden tot
fout.

ISO-2 Beperk de compiler om alleen de tweede ISO-gestandaardiseerde functies te gebruiken. Dit
maakt het gebruik van generieke, statische klassen, iterators en anonieme methoden mogelijk
bijvoorbeeld.

3 Beperk de compiler om alleen de functies te gebruiken die beschikbaar zijn in C# 3.0 (a
superset van ISO-1 en ISO-2).

4 Beperk de compiler om alleen de functies te gebruiken die beschikbaar zijn in C# 4.0
specificatie.

experimenteel
Schakelt onstabiele functies van aankomende versies van de taal in.

Merk op dat deze vlag alleen de taalfuncties beperkt die beschikbaar zijn voor de
programmeur. Een versie van geproduceerde samenstellingen kan worden beheerd met behulp van SDK optie.

-lib: PATHLIJST
Elk pad dat is opgegeven in de door komma's gescheiden lijst, geeft de compiler de opdracht om te zoeken
voor bibliotheken in dat opgegeven pad.

-L PATH
Geeft de compiler opdracht om naar bibliotheken in het opgegeven pad te zoeken. Meerdere paden
kan worden verstrekt door de optie meerdere keren te gebruiken.

-hoofd: KLASSE
Vertelt de compiler welke CLASS het ingangspunt bevat. Handig als je dat bent
het compileren van verschillende klassen met een methode Main.

-nostlib, -nostlib+
Gebruik deze vlag als u de kernbibliotheek wilt compileren. Dit maakt de compiler
laad de interne typen van de assembly die wordt gecompileerd.

-noconfig, -noconfig+
Schakelt het laden van de standaard compilerconfiguratie uit. Standaard de compiler
heeft verwijzingen naar de systeemassemblages.

-nowarn: WARNLIJST
Zorgt ervoor dat de compiler waarschuwingen negeert die zijn opgegeven in de door komma's gescheiden lijst WARNLIST>

-optimaliseren, -optimaliseren+, -optimaliseren-
Beheert optimaliseringen voor het genereren van compilercodes op de code. Gebruik -optimaliseren of
-optimize+ schakelt optimalisaties in, -optimize- zet het uit. De standaard in
mcs is optimaliseren-. De optie kan worden gemengd met -debug, maar voor de beste debugging
ervaring is het aan te raden om de opties uit te laten.

-uit:FNAME, -o FNAAM
Benoemt het te genereren uitvoerbestand.

--ontleden
Gebruikt voor benchmarking. De compiler analyseert alleen de invoerbestanden.

-pkg:pakket1[,pakketN]
Referentie-assemblages voor de gegeven pakketten.

De compiler zal pkg-config --libs aanroepen op de set pakketten gespecificeerd op de
opdrachtregel om bibliotheken en mappen te verkrijgen om de code te compileren.

Dit wordt meestal gebruikt met componenten van derden, zoals deze:

$ mcs -pkg:gtk-sharp demo.cs

-pkg:dotnet
Dit zal de compiler instrueren om naar de System.*-bibliotheken te verwijzen
beschikbaar op een typische dotnet-frameworkinstallatie, merk op dat dit het geval is
bevatten niet alle Mono-bibliotheken, alleen de System.*-bibliotheken. Dit is een
handige snelkoppeling voor die porteringscode.

-platform: ARCH
Wordt gebruikt om het doelplatform op te geven. De mogelijke waarden zijn: anycpu,
elke cpu32bit heeft de voorkeur, arm, x86, x64 of itanium. De standaardoptie is anycpu.

-bron:BRON[,ID]
Ingesloten in het gegeven bronbestand. De optionele ID kan worden gebruikt om een ​​andere te geven
naam aan de bron. Indien niet gespecificeerd, zal de bronnaam de bestandsnaam zijn.

-linkresource:BRON[,ID]
Koppelingen naar de opgegeven RESOURCE. De optionele ID kan worden gebruikt om een ​​naam te geven aan het
gekoppelde bron.

-r:ASSEMBLAGE1[,ASSEMBLAGE2], -referentie MONTAGE1[,MONTAGE2]
Verwijs naar de benoemde samenstellingen. Gebruik dit om klassen van de benoemde assembly in te gebruiken
jouw programma. De assembly wordt geladen vanuit de systeemdirectory waar
alle samenstellingen live, of vanaf het pad dat expliciet is opgegeven met de optie -L.

U kunt ook een puntkomma gebruiken om de samenstellingen te scheiden in plaats van een komma.

-referentie:ALIAS=MONTAGE
Ondersteuning voor externe aliasreferenties voor C#.

Als u verschillende assembly's hebt die dezelfde typen bieden, wordt de externe alias
ondersteuning stelt u in staat namen op te geven die uw software kan gebruiken om die te vertellen
appart. De typen van ASSEMBLY worden weergegeven als ALIAS en vervolgens op de C#-bron
code, je moet doen:

externe alias ALIAS;
Om het in uw naamruimte te brengen. Bijvoorbeeld om met twee grafische bibliotheken om te gaan
die "Graphics.Point" definiëren, één in "OpenGL.dll" en één in "Postscript.dll", u
zou de compiler als volgt aanroepen:

mcs -r:Postscript=Postscript.dll -r:OpenGL=OpenGL.dll

En in je broncode zou je schrijven:

externe alias Postscript;
externe alias OpenGL;

klasse X {
// Dit is een Graphics.Point van Postscript.dll
Postscript.Point p = nieuw Postscript.Point ();

// Dit is een Graphics.Point van OpenGL.dll
OpenGL.Point p = nieuw OpenGL.Point ();
}

-recurse: PATROON, --recursie PATROON
Voert recursieve compilatie uit met behulp van het opgegeven patroon. In Unix zal de shell dat wel doen
voer globbing uit, dus misschien wilt u het als volgt gebruiken:

$ mcs -recursie:'*.cs'

-sdk: VERSIE
Wordt gebruikt om de versie van de Base Class Library-assembly's op te geven die voor compilatie worden gebruikt.
De volgende vooraf gedefinieerde waarden zijn geldig: 2, 4 (standaard) en elke aangepaste waarde.
Het voorgedefinieerde versienummer geeft aan welke aangepaste waarde is opgegeven die mcs zal proberen
vind Base Class Libraries in de mono geïnstalleerde locatie PREFIX/lib/mono/ .

--schelp
Start de compiler in interactieve modus en biedt een C#-shell voor instructies en
uitdrukkingen. Een snelkoppeling is om de scherp opdracht direct.

--stacktrace
Genereert een stacktracering op het moment dat de fout wordt gerapporteerd, handig voor het debuggen van het
compiler.

-doel: SOORT, -t: SOORT
Gebruikt om het gewenste doel te specificeren. De mogelijke waarden zijn: exe (plain
uitvoerbaar), winexe (Windows.Forms uitvoerbaar), bibliotheek (componentbibliotheken) en
module (gedeeltelijke bibliotheek).

--tijdstempel
Nog een foutopsporingsvlag. Wordt gebruikt om de tijden op verschillende punten in de tijd weer te geven
compilatie proces.

-onveilig, -onveilig+
Maakt compilatie van onveilige code mogelijk.

-v Foutopsporing. Schakelt uitgebreide yacc-parsing in.

--versie
Toont de compilerversie.

-waarschuwing voor een fout, -waarschuwingsfout+
Alle compilerswaarschuwingen worden gerapporteerd als fouten.

-waarschuwingsfout:W1,[Wn], -warnaserror+:W1,[Wn]
Behandelt een of meer compilerwaarschuwingen als fouten.

-warnaserror-:W1,[Wn]
Stelt een of meer compilerwaarschuwingen in om altijd als waarschuwingen te worden bedreigd. Wordt
nuttig in combinatie met -warnaserror.

-waarschuwing: NIVEAU
Stelt het waarschuwingsniveau in. 0 is het laagste waarschuwingsniveau en 4 is het hoogste. De
standaard is 4.

-win32res:BESTAND
Specificeert een Win32-resourcebestand (.res) dat moet worden gebundeld in de resulterende assembly.

-win32icon:BESTAND
Voegt het pictogram toe dat is opgegeven in FILE op de uitvoer in de resulterende assembly.

-- Gebruik dit om het parseren van opties te stoppen en toe te staan ​​dat op opties lijkende parameters worden doorgegeven
op de opdrachtregel.

PAKKETJES EN BIBLIOTHEKEN

Wanneer naar een assembly wordt verwezen en de naam van de assembly een pad is, zal de compiler het proberen
om de assembly te laden die in het pad is opgegeven. Als dit niet het geval is, zal de compiler het proberen
het laden van de assembly vanuit de huidige map, de basismap van de compiler en als het
assembly wordt niet gevonden op een van die plaatsen in de mappen die zijn opgegeven als argumenten voor
het -lib: opdrachtargument.

De compiler gebruikt het bibliotheekpad om bibliotheken te lokaliseren en kan naar bibliotheken verwijzen
uit een bepaald pakket als die map wordt gebruikt. Om het gebruik van pakketten te vereenvoudigen, is de
De C#-compiler bevat de opdrachtregeloptie -pkg: die wordt gebruikt om specifiek te laden
collecties van bibliotheken.

Bibliotheken die zichtbaar zijn voor de compiler, worden opgeslagen ten opzichte van het installatievoorvoegsel eronder
PREFIX/lib/mono/ heet de PACKAGEBASE en de standaardinstellingen voor mcs, gmcs en smcs zijn als
volgt:

mcs Verwijst naar de map PACKAGEBASE/1.0

gmc's Verwijst naar de map PACKAGEBASE/2.0

smc's Verwijst naar de map PACKAGEBASE/2.1

Dat zijn de enige runtime-profielen die er zijn. Hoewel er andere mappen bestaan ​​(zoals
3.0 en 3.5) dat zijn niet echt runtime-profielen, het zijn slechts tijdelijke aanduidingen voor extra's
bibliotheken die voortbouwen op de 2.0-basis.

Softwareleveranciers zullen software distribueren die ten opzichte van de PACKAGEBASE is geïnstalleerd
map. Deze is geïntegreerd in de gacutil tool die niet alleen public
assemblies in de Global Assembly Cache (GAC) maar installeert ze ook in de
PACKAGEBASE/PKG-directory (waarbij PKG de naam is die wordt doorgegeven aan de vlag -package aan gacutil).

Als je als ontwikkelaar de Gtk#-bibliotheken wilt gebruiken, moet je de compiler aanroepen
soortgelijk:

$ mcs -pkg:gtk-sharp-2.0 main.cs

De optie -pkg: instrueert de compiler om de definities voor gtk-sharp-2.0 op te halen van
pkg-config, dit komt overeen met het doorgeven aan de C#-compiler van de uitvoer van:

$ pkg-config --libs gtk-sharp-2.0

Gewoonlijk verwijst dit alleen naar de bibliotheken van PACKAGEBASE/PKG.

Hoewel er mapnamen zijn voor 3.0 en 3.5, betekent dat niet dat er ook 3.0 zijn
en 3.5 compileredities of -profielen. Dat zijn slechts nieuwe bibliotheken die moeten zijn
handmatig verwezen met de juiste -pkg: aanroeping, of door te verwijzen naar de
bibliotheken rechtstreeks.

. DEFINIERT

De SPOOR en DEBUG Definities hebben een speciale betekenis voor de compiler.

Aanroepen van methoden en eigenschappen in de klasse System.Diagnostics.Trace zijn dat standaard niet
gegenereerd tenzij het TRACE-symbool is gedefinieerd (hetzij via een "#define TRACE") in uw
broncode, of met behulp van de --definiëren SPOOR in de opdrachtregel.

Aanroepen van methoden en eigenschappen in de klasse System.Diagnostics.Debug zijn dat standaard niet
gegenereerd tenzij het DEBUG-symbool is gedefinieerd (hetzij via een "#define DEBUG") in uw
broncode, of met behulp van de --definiëren DEBUG in de opdrachtregel.

Merk op dat het effect van het definiëren van TRACE en DEBUG een globale instelling is, zelfs als dat zo is
alleen gedefinieerd in een enkel bestand.

DEBUGEN ONDERSTEUNING

Bij gebruik van de vlag "-debug" zal MCS een bestand genereren met de extensie .mdb dat
bevat de foutopsporingsinformatie voor de gegenereerde assembly. Dit bestand wordt gebruikt door
de Mono debugger (mdb).

MILIEU VARIABELEN

MCS_COLORS
Als deze variabele is ingesteld, bevat deze een tekenreeks in de vorm "voorgrond,achtergrond"
dat specificeert welke kleur moet worden gebruikt om fouten op sommige terminals weer te geven.

De achtergrond is optioneel en is standaard ingesteld op de huidige achtergrond van uw terminal. De
mogelijke kleuren voor de voorgrond zijn: zwart, rood, fel rood, groen, Fel groen,
geel, fel geel, blauw, helderblauw, magenta, heldermagenta, cyaan, heldercyaan,
grijs, wit en helderwit.

De mogelijke achtergrondkleuren zijn: zwart, rood, groen, geel, blauw, magenta,
cyaan, grijs en wit.

U kunt bijvoorbeeld deze variabele vanuit uw shell instellen:
MCS_COLORS exporteren
MCS_COLORS=errors=helderwit,rood

U kunt het ingebouwde kleurenschema uitschakelen door deze variabele in te stellen op "uitschakelen".

OPMERKINGEN

Tijdens het compileren definieert de MCS-compiler het __MonoCS__-symbool, dit kan worden gebruikt door
pre-processor instructies om Mono C# compiler-specifieke code te compileren. Houd er rekening mee dat
dit symbool is alleen bedoeld om de compiler te testen en is niet nuttig om onderscheid te maken tussen compilatie
of implementatieplatforms.

AUTEURS

De Mono C# Compiler is geschreven door Miguel de Icaza, Ravi Pratap, Martin Baulig, Marek
Safar en Raja Harinath. De ontwikkeling werd gefinancierd door Ximian, Novell en Marek Safar.

Gebruik dmcs online met behulp van onworks.net-services