Ruby sin omverden

Kommandolinje argumenter

ruby [
            opsjoner
            ] [--] [
            programfil
            ] [
            argumenter
            ]

% ruby -w - "Hello World"

Kommandolinje opsjoner

-0[oktal]

' Nummer ``0'' flagget spesifierer tegnet som skal brukes for å separere poster fra hverandre (\0, hvis det ikke følger flere sifre). -00 indikerer paragrafmodus: postene separeres av to påfølgende standard postseparatortegn. -0777 leser hele filen på en gang (siden det er et ulovlig tegn). Setter $/ variabelen.

-a

' Automatisk oppdelingsmodus når brukt i sammenheng med -n eller -p. Det er ekvivalent til å utføre $F=$_.split før hver iterasjon.

-C katalog

' Endrer arbeidskatalog til katalog før programmet kjøres.

-c

' Sjekker kun syntaksen. Kjører ikke programmet.

--copyright

Skriver ut en notis om opphavsretten og avslutter.

-d, --debug

' Setter $DEBUG variabelen til sann (true). Dette kan du bruke i programmene dine for å slå på ekstra sporing av programutførelsen.

-e 'kommando'

' Utfører kommando som en linje av Ruby kildekode. Flere -e'er er tillatt og behandles som om de var flere linjer i et og samme program. Dersom programfil er utelatt når -e brukes, stoppes all utføring etter at alle -e kommandoene har blitt kjørt.

-F mønster

' Angir innput feltseparatoren ($;) som skal brukes som standard for split() (påvirker -a).

-h, --help

' Viser en kort "hjelp" side.

-I kataloger

' Spesifiserer kataloger som må settes inn på fronten av $LOAD_PATH ($:). Man kan ha flere -I opsjoner, samt ha flere kataloger spesifiser i hver -I. Katalogene separeres med ``:'' på Unix-lignende systemer og med ``;'' på DOS/Windows systemer.

-i [endelse]

' Endrer selve filene angitt i ARGV. For hver fil navngitt i ARGV, vil det du skriver til standard utput bli lagret tilbake som innholdet i den filen. En sikkerhetskopi av den gamle filen vil bli laget dersom endelse er angitt.

% ruby -pi.bak -e "gsub(/Perl/, 'Ruby')" *.txt

-K kcode

' Spesiferer tegnsettet som skal brukes. Denne opsjonen er nyttigst når Ruby brukes for prosessering i forbindelse med japansk. kcode kan være en av: e, E for EUC; s, S for SJIS; u, U for UTF-8; eller a, A, n, N for ASCII.

-l

' Slår på automatisk prosessering av linje endene. Setter $\ til verdien i $/ og fjerner linjeskift tegn av innput linjene automatisk.

-n

' Antar at du ønsker en ``while gets; ...; end'' løkke rundt programmet ditt. For eksempek kunne en enkel grep komando implementeres som:

% ruby -n -e "print if /wombat/"  *.txt

-p

' Plasserer programkoden din inne i løkken ``while gets; ...; print; end.''

% ruby -p -e "$_.downcase!" *.txt

-r library

' require det angitte biblioteket før kjøring starter.

-S

' Leter etter progframfilen ved hjelp av miljøvariablen RUBYPATH eller PATH.

-s

' Eventuelle kommandolinje opsjoner som kommer etter programfilen, men før eventuelle filnavn argumenter eller en --, fjernes i fra ARGV og settes inn i en global variabel med navnet til opsjonen. I det følgende eksempel, vil effekten være at variabelen $opt settes til ``electric''.

% ruby -s prog -opt=electric ./mydata

-T[level]

' Setter trygghetsnivået, hvilket blant annet slår på 'tainted' sjekking (se side 257. Setter $SAFE variabelen.

-v, --verbose

' Slår på ordrik(??) modus og skriver ut versjonsnummeret. I ordrik modus blir kompileringsadvarsler skrevet ut. Hvis det ikke er noe programfilnavn på kommandolinjen, avslutter Ruby.

--version

Viser versjonsnummeret til Ruby og avslutter.

-w

' Slår på ordrik modus. I motsetning til -v, leses programmet fra standard innput dersom det ikke angis noen programfiler på kommandolinjen. We anbefaler deg å kjøre Ruby programmene dine med -w.

-X katalog

' Endrer arbeidskatalogen til katalog før utførelse. Samme som -C katalog.

-x [katalog]

' Fjerner teksten før #!ruby linjen og endrer arbeidskatalogen til katalog dersom den er gitt.

-y, --yydebug

' Slår på yacc debugging i parseren (dette gir alt for mye informasjon).

ARGV

% ruby -w ptest "Hello World" a1 1.6180

Program terminering

Miljøvariabler

Miljøvariabler som Ruby bruker Variabelnavn Beskrivelse RUBYOPT Ytterlige kommandolinje opsjoner til Ruby. Ruby ser her etter etter at de virkelige kommandolinje opsjonene har blitt lest inn ($SAFE må være 0). RUBYLIB Ytterlige søkestier for Ruby programmer ($SAFE må være 0). RUBYPATH Sammen med -S opsjonen, søkesti for Ruby programmer (PATH er standard). RUBYSHELL Skall som skal brukes når en prosess startes; hvis denne ikke er satt, vil Ruby også sjekke SHELL eller COMSPEC. DLN_LIBRARY_PATH Søkesti for dynamisk lasting av moduler. RUBYLIB_PREFIX (Kun Windows) Radbrekk RUBYLIB søkestien ved å prefikse denne strengen på hver komponent.

Skriving til miljøvariabler

puts "In parent, term = #{ENV['TERM']}"
fork do
  puts "Start of child 1, term = #{ENV['TERM']}"
  ENV['TERM'] = "ansi"
  fork do
    puts "Start of child 2, term = #{ENV['TERM']}"
  end
  Process.wait
  puts "End of child 1, term = #{ENV['TERM']}"
end
Process.wait
puts "Back in parent, term = #{ENV['TERM']}"

In parent, term = xterm
Start of child 1, term = xterm
Start of child 2, term = ansi
End of child 1, term = ansi
Back in parent, term = xterm

Hvor finner Ruby sine moduler?

% ruby -e 'puts $:'

/usr/local/lib/ruby/site_ruby/1.6/i686-linux
/usr/local/lib/ruby/site_ruby/1.6
/usr/local/lib/ruby/site_ruby
/usr/local/lib/ruby/1.6/i686-linux
/usr/local/lib/ruby/1.6
.

Kompilering- og lenkingsmiljø

$Log: rubyworld.xml,v $
Revision 1.8  2002/08/11 06:48:45  kent
Første oversettelseskladd ferdig.

Revision 1.7  2002/08/10 16:24:24  kent
Nesten frem til Build Environment.

Revision 1.6  2002/08/10 14:30:31  kent
Frem til ARGV.

Revision 1.5  2002/08/10 13:59:14  kent
Fikset noen tag feil og fortsatte litt til.

Revision 1.4  2002/08/10 12:48:43  kent
Påbegynt oversettelse.