dmcs - Online sa Cloud

PROGRAMA:

NAME

mcs - Mono C# Compiler

SINOPSIS

mcs [pagpipilian] [source-file]

DESCRIPTION

Ang mcs ay ang Mono C# compiler, isang pagpapatupad ng ECMA-334 na detalye ng wika.
Maaari kang magpasa ng isa o higit pang mga opsyon upang himukin ang compiler, at isang hanay ng mga source file. Dagdag
ang mga opsyon o argumento ay maaaring ibigay sa isang response file. Ang mga file ng tugon ay isinangguni ng
inilalagay ang @ simbolo sa pangalan ng file ng tugon.

Ang mcs Ang compiler ay ginagamit upang mag-compile laban sa pinakabagong bersyon ng Mono Base Class Library at
ganap na nagpapatupad ng mga detalye ng C# 1.0, 2.0, 3.0 at 4.0.

Tingnan ang seksyon sa mga pakete para sa higit pang impormasyon.

Ang Mono C# compiler ay tumatanggap ng parehong command line na opsyon na ang Microsoft C# compiler
ginagawa. Ang mga pagpipiliang iyon ay maaaring magsimula sa isang slash o isang gitling (/checked ay kapareho ng -checked).
Bukod pa rito, sinusuportahan ang ilang mga opsyon na tulad ng GNU, ang mga iyon ay nagsisimula sa "--". Lahat ng partikular sa MCS
ang mga flag na hindi available sa Microsoft C# compiler ay magagamit lamang sa
Mga opsyon sa istilo ng GNU.

Ang mga C# source file ay dapat magtapos sa isang ".cs" na extension. Kinakailangan ang pagsasama-sama ng C# source code
lahat ng mga file na bumubuo sa isang library, module o executable na ibibigay sa command
linya. Walang suporta para sa bahagyang compilation. Upang makamit ang mga benepisyo ng bahagyang
compilation, dapat kang mag-compile ng mga programa sa sarili nilang mga assemblies, at sa paglaon ay reference
sila na may bandilang "-r".

Ang Mono C# compiler ay bumubuo ng mga larawan (.exe file) na naglalaman ng CIL byte code na maaaring
ipinapatupad ng anumang system na nagpapatupad ng isang virtual machine ng Common Language Infrastructure
gaya ng Microsoft .NET runtime engine sa Windows o ang Mono runtime engine sa Unix
mga sistema. Ang mga executable ay hindi nakatali sa isang partikular na CPU o operating system.

Ang Mono C# compiler bilang default ay tumutukoy lamang sa tatlong assemblies: mscorlib.dll, System.dll
at System.Xml.dll. Kung nais mong sumangguni sa mga karagdagang aklatan dapat mong manu-manong tukuyin
sila gamit ang -pkg: command line na opsyon o ang -r: command line na opsyon. Bilang kahalili kung
gusto mong makuha ang lahat ng mga library ng System, maaari mong gamitin ang -pkg:dotnet command line
pagpipilian.

Opsyon

--tungkol sa
Nagpapakita ng impormasyon tungkol sa Mono C# compiler

--addmodule:MODULE1[,MODULE2]
Kasama ang tinukoy na mga module sa nagresultang pagpupulong. Ang mga module ay nilikha ng
pagtawag sa compiler gamit ang -target:module na opsyon

-nasuri, -tsek +
Itinatakda ang default na compilation mode sa `check'. Ginagawa nito ang lahat ng mga operasyon sa matematika
may check (ang default ay walang check).

-nasuri-
Itinatakda ang default na compilation mode sa `uncheck'. Ginagawa nito ang lahat ng matematika
walang check ang mga operasyon (ito ang default).

-clscheck-, -clscheck+
Hindi pinapagana o pinapagana ang mga pagsusuri sa Common Language Specification (CLS) (ito ay pinagana
bilang default).

Tinutukoy ng Common Language Specification (CLS) ang isang interoperable na subset ng mga uri bilang
pati na rin ang mga convention na dapat sundin ng mga compiler (mga producer ng CLS) at developer
ilantad ang code sa iba pang mga programming language (mga consumer ng CLS).

-codepage:ID
Tinutukoy ang pahina ng code na ginamit upang iproseso ang mga input file mula sa puntong ito
tinukoy sa. Bilang default, ipoproseso ang mga file sa nakadepende sa kapaligiran
pahina ng katutubong code. Awtomatiko ring makikita ng compiler ang mga Unicode file na iyon
may naka-embed na byte mark sa simula.

Ang iba pang sikat na pag-encode ay 28591 (Latin1), 1252 (iso-8859-1) at 65001 (UTF-8).

Sinusuportahan ng MCS ang ilang mga shorthand: "utf8" ay maaaring gamitin upang tukuyin ang utf-8 sa halip na
gamit ang cryptic 65001 at ang "reset" ay nagpapanumbalik ng awtomatikong pangangasiwa ng mga pahina ng code.
Ang mga shorthand na ito ay hindi magagamit sa Microsoft compiler.

-define:SYMLIST, -d:SYMLIST
Tinutukoy ang simbolo na nakalista sa pamamagitan ng semi-colon na pinaghiwalay na listahan na SYMLIST SYMBOL. Ito
maaaring masuri sa source code ng pre-processor, o maaaring gamitin ng mga pamamaraan
na na-tag ng Conditional attribute.

-debug, -debug+
Bumuo ng impormasyon sa pag-debug. Upang makakuha ng stack traces na may impormasyon sa pag-debug,
kailangan mong i-invoke ang mono runtime gamit ang `--debug' flag. Ang pag-debug
Ang impormasyon ay naka-imbak sa isang MDB file na matatagpuan sa parehong output folder bilang ginawa
pagpupulong.

-debug-
Huwag bumuo ng impormasyon sa pag-debug.

-delaysign+
I-embed lamang ang strongname na pampublikong key sa assembly. Ang aktwal na pagpirma ay dapat
tapos sa susunod na yugto gamit ang SN tool. Ito ay kapaki-pakinabang upang protektahan ang pribadong key
sa panahon ng pag-unlad. Tandaan na ang delay signing ay maaari lamang gawin gamit ang strongname key
file (hindi isang pangunahing lalagyan). Ang opsyon ay katumbas ng pagsasama ng [assembly:
AssemblyDelaySign (true)] sa iyong source code. Ang opsyon ng compiler ay nangunguna
higit sa mga katangian.

-delaysign-
Default. Strongname (pirmahan) ang assembly gamit ang strong name key file (o
lalagyan). Ang opsyon ay katumbas ng pagsasama ng [assembly: AssemblyDelaySign
(false)] sa iyong source code. Ang opsyon ng compiler ay nangunguna sa mga katangian.

-doc:FILE
Kinukuha ang dokumentasyon ng C#/XML mula sa source code at iniimbak sa ibinigay
FILE.

-ulat ng error
Ang flag na ito ay hindi pinapansin ng C# compiler ng Mono at naroroon lamang upang payagan ang MCS na maging
ginamit bilang kapalit ng CSC para sa msbuild/xbuild.

--nakamamatay
Ito ay ginagamit para sa pag-debug ng compiler. Ginagawa nitong ang paglabas ng error ay bumubuo ng isang
pagbubukod na maaaring makuha ng isang debugger.

-filealign
Ang flag na ito ay hindi pinapansin ng C# compiler ng Mono at naroroon lamang upang payagan ang MCS na maging
ginamit bilang kapalit ng CSC para sa msbuild/xbuild.

-fullpats
Ang anumang error sa source code o babala na ibinigay ng compiler ay kasama lamang ang pangalan ng file ni
default. Ang pagpipiliang ito ay nagdudulot sa compiler na mag-isyu ng absolute file path sa halip.

-keyfile:KEYFILE
Strongname (sign) ang output assembly gamit ang key pair na nasa tinukoy
malakas na name key file (snk). Ang isang buong key pair ay kinakailangan bilang default (o kapag ginagamit
delaysign-). Ang isang file na naglalaman lamang ng pampublikong susi ay maaaring gamitin sa delaysign+. Ang
ang opsyon ay katumbas ng pagsasama ng [assembly: AssemblyKeyFile ("KEYFILE")] sa iyong
source code. Ang opsyon ng compiler ay nangunguna sa mga katangian.

-keycontainer:CONTAINER
Strongname (sign) ang output assembly gamit ang key pair na nasa tinukoy
lalagyan. Tandaan na ang delaysign+ ay binabalewala kapag gumagamit ng mga pangunahing container. Ang pagpipilian ay
katumbas ng pagsasama ng [assembly: AssemblyKeyName ("CONTAINER")] sa iyong source
code. Ang opsyon ng compiler ay nangunguna sa mga katangian.

-langversion:TEXT
Tinutukoy ng opsyon ang bersyon ng wikang gagamitin. Ang feature set ay
naiiba sa bawat bersyon ng C#. Ang switch na ito ay maaaring gamitin upang pilitin ang compiler
payagan lamang ang isang subset ng mga tampok. Ang mga posibleng halaga ay:

default
Atasan ang compiler na gamitin ang pinakabagong bersyon. Ang katumbas ay ang pag-alis sa
switch (kasalukuyang nagde-default ito sa detalye ng wikang C# 4.0).

ISO-1 Limitahan ang compiler na gumamit lamang ng mga unang ISO standardized na feature. Ang paggamit ng
Ang mga tampok tulad ng mga generic, static na klase, hindi kilalang mga pamamaraan ay hahantong sa
error.

ISO-2 Paghigpitan ang compiler na gamitin lamang ang pangalawang ISO standardized na mga tampok. Ito
nagbibigay-daan sa paggamit ng mga generic, static na klase, iterator at hindi kilalang pamamaraan
halimbawa.

3 Limitahan ang compiler na gamitin lamang ang mga feature na available sa C# 3.0 (a
superset ng ISO-1 at ISO-2).

4 Limitahan ang compiler na gamitin lamang ang mga feature na available sa C# 4.0
pagtutukoy.

pagsubok
Pinapagana ang mga hindi matatag na feature mula sa paparating na mga bersyon ng wika.

Pansinin na ang flag na ito ay naghihigpit lamang sa mga feature ng wika na available sa
programmer. Maaaring kontrolin gamit ang isang bersyon ng mga ginawang pagtitipon SDK pagpipilian.

-lib:PATHLIST
Ang bawat landas na tinukoy sa listahan na pinaghihiwalay ng kuwit ay magdidirekta sa compiler upang tumingin
para sa mga aklatan sa tinukoy na landas.

-L PATH
Nagtuturo sa compiler na maghanap ng mga aklatan sa tinukoy na landas. Maramihang mga landas
maaaring ibigay sa pamamagitan ng paggamit ng opsyon nang maraming beses.

-pangunahing:KLASE
Sinasabi sa compiler kung aling CLASS ang naglalaman ng entry point. Kapaki-pakinabang kapag ikaw ay
pag-compile ng ilang klase na may Pangunahing pamamaraan.

-nostdlib, -nostdlib+
Gamitin ang flag na ito kung gusto mong i-compile ang core library. Ginagawa nito ang compiler
i-load ang mga panloob na uri nito mula sa pinagsama-samang pagpupulong.

-noconfig, -noconfig+
Hindi pinapagana ang default na configuration ng compiler na ilo-load. Ang compiler bilang default
ay may mga sanggunian sa mga pagtitipon ng system.

-nowarn:WARNLIST
Ginagawang balewalain ng compiler ang mga babala na tinukoy sa comma-separated list na WARNLIST>

-optimize, -optimize+, -optimize-
Kinokontrol ang compiler code generation optimizations sa code. Gamit ang -optimize o
I-on ng -optimize+ ang mga optimization, i-o-off ito ng -optimize-. Ang default sa
Ang mcs ay upang i-optimize-. Ang opsyon ay maaaring ihalo sa -debug ngunit para sa pinakamahusay na pag-debug
karanasan ito ay inirerekomenda iwanan ang mga opsyon off.

-out:FNAME, -o FNAME
Pangalanan ang output file na bubuuin.

--parse
Ginagamit para sa benchmarking. Ipapa-parse lang ng compiler ang mga input file nito.

-pkg:package1[,packageN]
Mga sanggunian na pagtitipon para sa mga ibinigay na pakete.

Tatawagin ng compiler ang pkg-config --libs sa set ng mga package na tinukoy sa
command line para makakuha ng mga library at direktoryo para i-compile ang code.

Karaniwan itong ginagamit sa mga bahagi ng third party, tulad nito:

$ mcs -pkg:gtk-sharp demo.cs

-pkg:dotnet
Ito ay magtuturo sa compiler na sumangguni sa System.* mga aklatan
magagamit sa isang karaniwang pag-install ng dotnet framework, pansinin na ginagawa nito
hindi isama ang lahat ng mga aklatan ng Mono, tanging ang mga System.*. Ito ay
maginhawang shortcut para sa mga porting code.

-platform:ARCH
Ginagamit upang tukuyin ang target na platform. Ang mga posibleng halaga ay: anycpu,
anycpu32bitpreferred, braso, x86, x64 o itanium. Ang default na opsyon ay anycpu.

-resource: RESOURCE[,ID]
Naka-embed sa ibinigay na resource file. Maaaring gamitin ang opsyonal na ID upang magbigay ng iba
pangalan sa mapagkukunan. Kung hindi tinukoy, ang pangalan ng mapagkukunan ay ang pangalan ng file.

-linkresource: RESOURCE[,ID]
Mga link sa tinukoy na RESOURCE. Maaaring gamitin ang opsyonal na ID para magbigay ng pangalan sa
naka-link na mapagkukunan.

-r:ASSEMBLY1[,ASSEMBLY2], -sanggunian ASSEMBLY1[,ASSEMBLY2]
Sanggunian ang pinangalanang mga asembliya. Gamitin ito upang magamit ang mga klase mula sa pinangalanang assembly sa
iyong programa. Ang pagpupulong ay mai-load mula sa alinman sa direktoryo ng system kung saan
live ang lahat ng mga assemblies, o mula sa landas na tahasang ibinigay kasama ang -L na opsyon.

Maaari ka ring gumamit ng semicolon upang paghiwalayin ang mga assemblies sa halip na isang kuwit.

-reference:ALIAS=ASSEMBLY
Suporta sa sangguniang panlabas na alias para sa C#.

Kung mayroon kang iba't ibang mga assemblies na nagbibigay ng parehong mga uri, ang panlabas na alias
nagbibigay-daan sa iyo ang suporta na magbigay ng mga pangalan na magagamit ng iyong software para sabihin ang mga iyon
appart. Ang mga uri mula sa ASSEMBLY ay malalantad bilang ALIAS, pagkatapos ay sa C# source
code, kailangan mong gawin:

panlabas na alias ALIAS;
Upang dalhin ito sa iyong namespace. Halimbawa, upang makayanan ang dalawang graphics library
na tumutukoy sa "Graphics.Point", isa sa "OpenGL.dll" at isa sa "Postscript.dll", ikaw
tatawagin ang compiler tulad nito:

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

At sa iyong source code, isusulat mo:

panlabas na alyas Postscript;
panlabas na alias OpenGL;

klase X {
// Ito ay isang Graphics.Point mula sa Postscrip.dll
Postscript.Point p = bagong Postscript.Point ();

// Ito ay isang Graphics.Point mula sa OpenGL.dll
OpenGL.Point p = bagong OpenGL.Point ();
}

-recurse:PATTERN, --recurse PATTERN
Gumagawa ba ng recursive compilation gamit ang tinukoy na pattern. Sa Unix ang shell ay
magsagawa ng globbing, kaya maaaring gusto mong gamitin ito tulad nito:

$ mcs -recurse:'*.cs'

-sdk:BERSYON
Ginamit upang tukuyin ang bersyon ng Base Class Library assemblies na ginagamit para sa compilation.
Ang mga sumusunod na paunang natukoy na halaga ay wasto: 2, 4 (default) pati na rin ang anumang custom na halaga.
Ang paunang natukoy na numero ng bersyon ay nangangahulugang kung aling custom na halaga ang tinukoy ng mcs ang susubukan
hanapin ang Base Class Libraries sa mono install na lokasyon PREFIX/lib/mono/ .

--shell
Sinisimulan ang compiler sa interactive na mode, na nagbibigay ng C# shell para sa mga pahayag at
mga ekspresyon. Ang isang shortcut ay ang paggamit ng csharp direktang utos.

--stacktrace
Bumubuo ng stack trace sa oras na maiulat ang error, kapaki-pakinabang para sa pag-debug ng
tagatala

-target:MABAIT, -t:MABAIT
Ginagamit upang tukuyin ang nais na target. Ang mga posibleng halaga ay: exe (plain
executable), winexe (Windows.Forms executable), library (component library) at
module (bahagyang aklatan).

--timestamp
Isa pang debugging flag. Ginagamit upang ipakita ang mga oras sa iba't ibang mga punto sa
proseso ng compilation.

-hindi ligtas, -hindi ligtas+
Pinapagana ang pagsasama-sama ng hindi ligtas na code.

-v Pag-debug. Ino-on ang verbose yacc parsing.

--bersyon
Ipinapakita ang bersyon ng compiler.

-warnaserror, -warnaserror+
Ang lahat ng mga babala ng compiler ay iuulat bilang mga error.

-warnaserror:W1,[Wn], -warnaserror+:W1,[Wn]
Tinatrato ang isa o higit pang mga babala ng compiler bilang mga error.

-warnaserror-:W1,[Wn]
Nagtatakda ng isa o higit pang mga babala ng compiler na palaging banta bilang mga babala. nagiging
kapaki-pakinabang kapag ginamit kasama ng -warnaserror.

-babala:LEVEL
Itinatakda ang antas ng babala. 0 ang pinakamababang antas ng babala, at 4 ang pinakamataas. Ang
ang default ay 4.

-win32res:FILE
Tinutukoy ang isang Win32 resource file (.res) na isasama sa magreresultang pagpupulong.

-win32icon:FILE
Inilalagay ang icon na tinukoy sa FILE sa output sa nagresultang pagpupulong.

-- Gamitin ito upang ihinto ang pag-parse ng opsyon, at payagan ang mga parameter na mukhang opsyon na maipasa
sa command line.

PAKIKITA AT LIBRARI

Kapag tinutukoy ang isang pagpupulong, kung ang pangalan ng pagpupulong ay isang landas, susubukan ng tagatala
upang i-load ang pagpupulong na tinukoy sa landas. Kung hindi, susubukan ng compiler
nilo-load ang pagpupulong mula sa kasalukuyang direktoryo, ang direktoryo ng base ng compiler at kung ang
Ang pagpupulong ay hindi matatagpuan sa alinman sa mga lugar na iyon sa mga direktoryo na tinukoy bilang mga argumento sa
ang -lib: command argument.

Ginagamit ng compiler ang path ng library para mahanap ang mga library, at nagagawa nitong mag-reference ng mga library
mula sa isang partikular na pakete kung ginamit ang direktoryong iyon. Upang gawing simple ang paggamit ng mga pakete, ang
Kasama sa C# compiler ang -pkg: command line na opsyon na ginagamit upang mag-load ng partikular
mga koleksyon ng mga aklatan.

Ang mga aklatan na nakikita ng compiler ay iniimbak na may kaugnayan sa prefix ng pag-install sa ilalim
PREFIX/lib/mono/ tinatawag na PACKAGEBASE at ang mga default para sa mcs, gmcs at smcs ay bilang
sumusunod:

mcs Tinutukoy ang direktoryo ng PACKAGEBASE/1.0

gmcs Tinutukoy ang direktoryo ng PACKAGEBASE/2.0

smcs Tinutukoy ang direktoryo ng PACKAGEBASE/2.1

Iyon lang ang mga runtime na profile na umiiral. Bagaman mayroong ibang mga direktoryo (tulad ng
3.0 at 3.5) ang mga iyon ay hindi talagang mga profile ng runtime, sila ay mga placeholder lamang para sa karagdagang
mga aklatan na nagtatayo sa 2.0 na pundasyon.

Ang mga provider ng software ay mamamahagi ng software na naka-install na may kaugnayan sa PACKAGEBASE
direktoryo. Ito ay isinama sa gacutil tool na hindi lamang nag-i-install sa publiko
assemblies sa Global Assembly Cache (GAC) ngunit ini-install din ang mga ito sa
Direktoryo ng PACKAGEBASE/PKG (kung saan ang PKG ay ang pangalan na ipinasa sa -package flag sa gacutil).

Bilang isang developer, kung gusto mong gamitin ang mga aklatan ng Gtk#, tatawagin mo ang compiler
ganito:

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

Ang -pkg: na opsyon ay nagtuturo sa compiler na kunin ang mga kahulugan para sa gtk-sharp-2.0 mula sa
pkg-config, ito ay katumbas ng pagpasa sa C# compiler ng output ng:

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

Kadalasan ito ay tumutukoy lamang sa mga aklatan mula sa PACKAGEBASE/PKG.

Bagama't may mga pangalan ng direktoryo para sa 3.0 at 3.5, hindi iyon nangangahulugan na mayroong 3.0
at 3.5 mga edisyon o profile ng compiler. Iyan ay mga bagong aklatan lamang na dapat
manu-manong isinangguni alinman sa wastong -pkg: invocation, o sa pamamagitan ng pagtukoy sa
direkta sa mga aklatan.

ESPESYAL TINUTUKOY

Ang TRACE at MGA DEBUG ang mga define ay may espesyal na kahulugan sa compiler.

Bilang default, ang mga tawag sa mga pamamaraan at katangian sa System.Diagnostics.Trace class ay hindi
nabuo maliban kung ang simbolo ng TRACE ay tinukoy (alinman sa pamamagitan ng isang "#define TRACE") sa iyong
source code, o sa pamamagitan ng paggamit ng --define TRACE sa command line.

Bilang default, ang mga tawag sa mga pamamaraan at katangian sa System.Diagnostics.Debug class ay hindi
nabuo maliban kung ang simbolo ng DEBUG ay tinukoy (alinman sa pamamagitan ng isang "#define DEBUG") sa iyong
source code, o sa pamamagitan ng paggamit ng --define MGA DEBUG sa command line.

Tandaan na ang epekto ng pagtukoy sa TRACE at DEBUG ay isang pandaigdigang setting, kahit na sila
tinukoy lamang sa isang file.

NAG-DEBUGG SUPORTA

Kapag ginagamit ang flag na "-debug," bubuo ang MCS ng file na may extension na .mdb na
naglalaman ng impormasyon sa pag-debug para sa nabuong pagpupulong. Ang file na ito ay ginagamit ng
ang Mono debugger (mdb).

Kapaligiran MGA VARIABLE

MCS_COLORS
Kung nakatakda ang variable na ito, naglalaman ito ng string sa anyong "foreground,background"
na tumutukoy kung aling kulay ang gagamitin upang magpakita ng mga error sa ilang mga terminal.

Opsyonal ang background at nagde-default sa kasalukuyang background ng iyong terminal. Ang
Ang mga posibleng kulay para sa foreground ay: itim, pula, matingkad na pula, berde, maliwanag na berde,
dilaw, maliwanag na dilaw, asul, brightblue, magenta, brightmagenta, cyan, brightcyan,
kulay abo, puti at maliwanag na puti.

Ang mga posibleng kulay para sa background ay: itim, pula, berde, dilaw, asul, magenta,
cyan, kulay abo at puti.

Halimbawa, maaari mong itakda ang mga variable na ito mula sa iyong shell:
i-export ang MCS_COLORS
MCS_COLORS=errors=maliwanag na puti, pula

Maaari mong i-disable ang built-in na color scheme sa pamamagitan ng pagtatakda ng variable na ito sa "disable".

NOTA

Sa panahon ng pagsasama-sama, tinutukoy ng MCS compiler ang simbolo na __MonoCS__, maaari itong gamitin ng
pre-processor na mga tagubilin para mag-compile ng Mono C# compiler specific code. Mangyaring tandaan na
ang simbolo na ito ay para lamang subukan ang compiler, at hindi kapaki-pakinabang para makilala ang compiler
o mga deployment platform.

MGA AUTHORS

Ang Mono C# Compiler ay isinulat nina Miguel de Icaza, Ravi Pratap, Martin Baulig, Marek
Safar at Raja Harinath. Ang pag-unlad ay pinondohan nina Ximian, Novell at Marek Safar.

Gumamit ng mga dmc online gamit ang mga serbisyo ng onworks.net