Ruby - Integrierte Funktionen

abort

Beendet das Programm. Wenn eine Ausnahme ausgelöst wird (dh $! Ist nicht Null), wird die Fehlermeldung angezeigt.

Array( obj)

Gibt obj zurück, nachdem es mit to_ary oder to_a in ein Array konvertiert wurde.

at_exit {...}

Registriert einen Block zur Ausführung, wenn das Programm beendet wird. Ähnlich wie bei der END-Anweisung, jedoch registriert die END-Anweisung den Block nur einmal.

autoload( classname, file)

Registriert einen Klassenklassennamen, der bei der ersten Verwendung aus der Datei geladen werden soll. Klassenname kann eine Zeichenfolge oder ein Symbol sein.

binding

Gibt die aktuellen Variablen- und Methodenbindungen zurück. Das zurückgegebene Bindungsobjekt kann als zweites Argument an die eval- Methode übergeben werden.

block_given?

Gibt true zurück, wenn die Methode mit einem Block aufgerufen wurde .

callcc {| c|...}

Übergibt ein Continuation- Objekt c an den Block und führt den Block aus. callcc kann für das globale Exit- oder Loop-Konstrukt verwendet werden.

caller([ n])

Gibt den aktuellen Ausführungsstapel in einem Array der Zeichenfolgen in der Formulardatei zurück : line . Wenn n angegeben ist, werden Stapeleinträge ab der n-ten Ebene zurückgegeben.

catch( tag) {...}

Fängt einen nichtlokalen Ausgang durch einen Wurf ab, der während der Ausführung seines Blocks aufgerufen wird.

chomp([ rs = $/])

Gibt den Wert der Variablen zurück $_ with the ending newline removed, assigning the result back to $_. Der Wert der Zeilenumbruchzeichenfolge kann mit rs angegeben werden.

chomp!([ rs = $/])

Entfernt Zeilenumbrüche aus $ _ und ändert die vorhandene Zeichenfolge.

chop

Gibt den Wert von zurück $_ with its last character (one byte) removed, assigning the result back to $_.

chop!

Entfernt das letzte Zeichen aus $ _ und ändert die vorhandene Zeichenfolge.

eval( str[, scope[, file, line]])

Führt str als Ruby-Code aus. Die Bindung, in der die Bewertung durchgeführt werden soll, kann mit Umfang angegeben werden . Der Dateiname und die Zeilennummer des zu kompilierenden Codes können mit Datei und Zeile angegeben werden .

exec( cmd[, arg...])

Ersetzt den aktuellen Prozess durch Ausführen des Befehls cmd . Wenn mehrere Argumente angegeben werden, wird der Befehl ohne Shell-Erweiterung ausgeführt.

exit([ result = 0])

Beendet das Programm mit dem Ergebnis als zurückgegebenem Statuscode.

exit!([ result = 0])

Beendet das Programm unter Umgehung der Exit-Behandlung, z. B. Sicherstellen usw.

fail(...)

Siehe erhöhen (...)

Float( obj)

Gibt obj zurück, nachdem es in einen Float konvertiert wurde. Numerische Objekte werden direkt konvertiert. nil wird in 0.0 umgewandelt; Zeichenfolgen werden unter Berücksichtigung des Radix-Präfixes 0x, 0b konvertiert. Der Rest wird mit obj.to_f konvertiert.

fork

fork {...}

Erstellt einen untergeordneten Prozess. Im untergeordneten Prozess wird nil zurückgegeben, und die ID (Ganzzahl) des untergeordneten Prozesses wird im übergeordneten Prozess zurückgegeben. Wenn ein Block angegeben wird, wird er im untergeordneten Prozess ausgeführt.

format( fmt[, arg...])

Siehe sprintf.

gets([ rs = $/])

Liest den in der Befehlszeile oder einer Zeile angegebenen Dateinamen von der Standardeingabe. Die Datensatztrennzeichenfolge kann explizit mit rs angegeben werden.

global_variables

Gibt ein Array globaler Variablennamen zurück.

gsub( x, y)

gsub( x) {...}

Ersetzt alle Zeichenfolgen, die mit x in übereinstimmen $_ with y. If a block is specified, matched strings are replaced with the result of the block. The modified result is assigned to $_.

gsub!( x, y)

gsub!( x) {...}

Führt die gleiche Ersetzung wie gsub durch, außer dass die Zeichenfolge an Ort und Stelle geändert wird.

Integer( obj)

Gibt obj zurück, nachdem es in eine Ganzzahl konvertiert wurde. Numerische Objekte werden direkt konvertiert. nil wird in 0 umgewandelt; Zeichenfolgen werden unter Berücksichtigung des Radix-Präfixes 0x, 0b konvertiert. Der Rest wird mit obj.to_i konvertiert.

lambda {| x|...}

proc {| x|...}

lambda

proc

Konvertiert einen Block in ein Proc- Objekt. Wenn kein Block angegeben ist, wird der der aufrufenden Methode zugeordnete Block konvertiert.

load( file[, private = false])

Lädt ein Ruby-Programm aus einer Datei . Im Gegensatz zu require werden keine Erweiterungsbibliotheken geladen. Wenn privat ist wahr , wird das Programm in eine anonyme Modul geladen, so dass der Namensraum des rufenden Programms zu schützen.

local_variables

Gibt ein Array lokaler Variablennamen zurück.

loop {...}

Wiederholt einen Codeblock.

open( path[, mode = "r"])

open( path[, mode = "r"]) {| f|...}

Öffnet eine Datei . Wenn ein Block angegeben wird, wird der Block mit dem geöffneten Stream ausgeführt, der als Argument übergeben wird. Die Datei wird automatisch geschlossen, wenn der Block beendet wird. Wenn der Pfad mit einer Pipe | beginnt, wird die folgende Zeichenfolge als Befehl ausgeführt und der diesem Prozess zugeordnete Stream wird zurückgegeben.

p( obj)

Zeigt obj mit seiner Inspect-Methode an (häufig zum Debuggen verwendet).

print([ arg...])

Druckt arg auf $ defout . Wenn keine Argumente angegeben werden, wird der Wert von $ _ gedruckt.

printf( fmt[, arg...])

Formatiert arg gemäß fmt mit sprintf und druckt das Ergebnis in $ defout . Einzelheiten zur Formatierung finden Sie unter sprintf.

proc {| x|...}

proc

Siehe Lamda.

putc( c)

Druckt ein Zeichen in die Standardausgabe ( $ defout ).

puts([ str])

Druckt eine Zeichenfolge in die Standardausgabe ( $ defout ). Wenn die Zeichenfolge nicht mit einer neuen Zeile endet, wird eine neue Zeile an die Zeichenfolge angehängt.

raise(...)

fail(...)

Löst eine Ausnahme aus. Geht davon aus Runtime wenn keine Ausnahmeklasse angegeben wird. Das Aufrufen von raise ohne Argumente in einer Rettungsklausel löst die Ausnahme erneut aus. Wenn Sie dies außerhalb einer Rettungsklausel tun, wird ein RuntimeError ohne Nachricht ausgelöst .fail ist ein veralteter Name für Raise.

rand([ max = 0])

Erzeugt eine Pseudozufallszahl größer oder gleich 0 und kleiner als max. Wenn max entweder nicht angegeben oder auf 0 gesetzt ist, wird eine Zufallszahl als Gleitkommazahl größer oder gleich 0 und kleiner als 1 zurückgegeben. Mit srand kann ein Pseudozufallsstrom initialisiert werden.

readline([ rs = $/])

Entspricht get, außer dass beim Lesen von EOF eine EOFError-Ausnahme ausgelöst wird.

readlines([ rs = $/])

Gibt ein Array von Zeichenfolgen zurück, die entweder die als Befehlszeilenargumente angegebenen Dateinamen oder den Inhalt der Standardeingabe enthalten.

require( lib)

Lädt die Bibliothek (einschließlich der Erweiterungsbibliotheken) lib, wenn sie zum ersten Mal aufgerufen wird. require lädt dieselbe Bibliothek nicht mehr als einmal. Wenn in lib keine Erweiterung angegeben ist , müssen Sie versuchen, .rb, .so usw. hinzuzufügen.

scan( re)

scan( re) {|x|...}

Entspricht $ _. Scan.

select( reads[, writes = nil[, excepts = nil[, timeout = nil]]])

Überprüft, ob sich der Status von drei Arten von E / A-Objekten ändert, die als Arrays von E / A-Objekten übergeben werden. nil wird für Argumente übergeben, die nicht überprüft werden müssen. Ein Array mit drei Elementen, das Arrays der E / A-Objekte enthält, für die sich der Status geändert hat, wird zurückgegeben. Bei Zeitüberschreitung wird nil zurückgegeben.

set_trace_func( proc)

Legt einen Handler für die Ablaufverfolgung fest. proc kann eine Zeichenfolge oder ein proc- Objekt sein. set_trace_func wird vom Debugger und Profiler verwendet.

sleep([ sec])

Unterbricht die Programmausführung für Sekunden. Wenn sec nicht angegeben ist, wird das Programm für immer angehalten.

split([ sep[, max]])

Entspricht $ _. Split.

sprintf( fmt[, arg...])

format( fmt[, arg...])

Gibt eine Zeichenfolge zurück, in der arg gemäß fmt formatiert ist. Die Formatierungsspezifikationen sind im Wesentlichen dieselben wie für sprintf in der Programmiersprache C. Konvertierungsspezifizierer (% gefolgt von Konvertierungsfeldspezifizierer) in fmt werden durch eine formatierte Zeichenfolge des entsprechenden Arguments ersetzt. Eine Liste der eingereichten Konvertierungen finden Sie weiter unten im nächsten Abschnitt.

srand([ seed])

Initialisiert ein Array von Zufallszahlen. Wenn Samen nicht angegeben ist, eine Initialisierung durchgeführt für die Saat , die Zeit und andere Systeminformationen.

String( obj)

Gibt obj zurück, nachdem es mit obj.to_s in einen String konvertiert wurde.

syscall( sys[, arg...])

Ruft eine durch die Nummer sys angegebene Aufruffunktion des Betriebssystems auf . Die Anzahl und Bedeutung von sys ist systemabhängig.

system( cmd[, arg...])

Führt cmd als Aufruf an die Befehlszeile. Wenn mehrere Argumente angegeben werden, wird der Befehl direkt ohne Shell-Erweiterung ausgeführt. Gibt true zurück, wenn der Rückgabestatus 0 ist (Erfolg).

sub( x, y)

sub( x) {...}

Ersetzt die erste Zeichenfolge, die mit x in $ _ übereinstimmt, durch y. Wenn ein Block angegeben wird, werden übereinstimmende Zeichenfolgen durch das Ergebnis des Blocks ersetzt. Das geänderte Ergebnis wird $ _ zugewiesen.

sub!( x, y)

sub!( x) {...}

Führt den gleichen Austausch wie sub durch, außer dass die Zeichenfolge an Ort und Stelle geändert wird.

test( test, f1[, f2])

Führt verschiedene Datei - Tests durch das Zeichen angegeben Test . Um die Lesbarkeit zu verbessern, sollten Sie anstelle dieser Funktion Dateiklassenmethoden (z. B. File :: readable?) Verwenden. Eine Liste der Argumente finden Sie weiter unten im nächsten Abschnitt.

throw( tag[, value = nil])

Springt zur Catch-Funktion, die mit dem Symbol oder dem String- Tag wartet . value ist der Rückgabewert, der von catch verwendet werden soll .

trace_var( var, cmd)

trace_var( var) {...}

Legt die Ablaufverfolgung für eine globale Variable fest. Der Variablenname wird als Symbol angegeben. cmd kann eine Zeichenfolge oder ein Proc-Objekt sein.

trap( sig, cmd)

trap( sig) {...}

Legt einen Signalhandler fest. sig kann eine Zeichenfolge (wie SIGUSR1) oder eine Ganzzahl sein. SIG kann im Signalnamen weggelassen werden. Der Signalhandler für das EXIT-Signal oder die Signalnummer 0 wird unmittelbar vor dem Beenden des Prozesses aufgerufen.

untrace_var( var[, cmd])

Entfernt die Ablaufverfolgung für eine globale Variable. Wenn cmd angegeben ist, wird nur dieser Befehl entfernt.

n + num

n - num

n * num

n / num

Führt arithmetische Operationen aus: Addition, Subtraktion, Multiplikation und Division.

n % num

Gibt den Modul von n zurück.

n ** num

Potenzierung.

n.abs

Gibt den absoluten Wert von n zurück.

n.ceil

Gibt die kleinste Ganzzahl zurück, die größer oder gleich n ist.

n.coerce( num)

Gibt ein Array zurück, das num und n enthält, die möglicherweise in einen Typ konvertiert wurden, mit dem sie gegenseitig bearbeitet werden können. Wird bei der automatischen Typkonvertierung in numerischen Operatoren verwendet.

n.divmod( num)

Gibt ein Array zurück, das den Quotienten und den Modul enthält, indem n durch num geteilt wird.

n.floor

Gibt die größte Ganzzahl zurück, die kleiner oder gleich n ist.

n.integer?

Gibt true zurück, wenn n eine Ganzzahl ist.

n.modulo( num)

Gibt den Modul zurück, der durch Teilen von n durch num und Runden des Quotienten mit dem Boden erhalten wird

n.nonzero?

Gibt n zurück, wenn es nicht Null ist, andernfalls Null.

n.remainder( num)

Gibt den durch Teilen erhaltenen Rest zurück n durch numund Entfernen von Dezimalstellen aus dem Quotienten. Dasresult und n habe immer das gleiche Zeichen.

n.round

Gibt n auf die nächste Ganzzahl gerundet zurück.

n.truncate

Gibt n als Ganzzahl mit entfernten Dezimalstellen zurück.

n.zero?

Gibt Null zurück, wenn n 0 ist.

n & num

n | num

n ^ num

Bitweise Operationen: AND, OR, XOR und Inversion.

n << num

n >> num

Bitweise Links- und Rechtsverschiebung.

n[num]

Gibt den Wert von zurück numth Bit vom niedrigstwertigen Bit, das n [0] ist.

n.chr

Gibt eine Zeichenfolge zurück, die das Zeichen für den Zeichencode enthält n.

n.next

n.succ

Gibt die nächste Ganzzahl nach n zurück. Entspricht n + 1.

n.size

Gibt die Anzahl der Bytes in der Maschinendarstellung von zurück n.

n.step( upto, step) {|n| ...}

Iteriert den Block von n zu upto, inkrementierend um step jedes Mal.

n.times {|n| ...}

Iteriert den Block n mal.

n.to_f

Konvertiert nin eine Gleitkommazahl. Bei der Float-Konvertierung können Präzisionsinformationen verloren gehen.

n.to_int

Kehrt zurück n nach der Umwandlung in eine Interger-Nummer.

Float::induced_from(num)

Gibt das Ergebnis der Konvertierung von num in eine Gleitkommazahl zurück.

f.finite?

Gibt true zurück, wenn f nicht unendlich ist und f.nan false ist.

f.infinite?

Gibt 1 zurück, wenn f eine positive Unendlichkeit ist, -1, wenn eine negative Unendlichkeit vorliegt, oder Null, wenn etwas anderes.

f.nan?

Gibt true zurück, wenn f keine gültige IEEE-Gleitkommazahl ist.

atan2( x, y)

Berechnet die Bogentangente.

cos( x)

Berechnet den Cosinus von x.

exp( x)

Berechnet eine Exponentialfunktion (e erhöht auf die Potenz von x).

frexp( x)

Gibt ein Array mit zwei Elementen zurück, das den nominalisierten Bruch und den Exponenten von x enthält.

ldexp( x, exp)

Gibt den Wert von x mal 2 hoch von exp zurück.

log( x)

Berechnet den natürlichen Logarithmus von x.

log10( x)

Berechnet den Logarithmus zur Basis 10 von x.

sin( x)

Berechnet den Sinus von x.

sqrt( x)

Gibt die Quadratwurzel von x zurück. x muss positiv sein.

tan( x)

Berechnet die Tangente von x.

b

Binäre Ganzzahl

c

Einzelzeichen

d,i

Dezimalzahl

e

Exponentielle Notation (z. B. 2.44e6)

E

Exponentielle Notation (z. B. 2.44E6)

f

Gleitkommazahl (z. B. 2,44)

g

Verwenden Sie% e, wenn der Exponent kleiner als -4 ist, andernfalls% f

G

Verwenden Sie% E, wenn der Exponent kleiner als -4 ist, andernfalls% f

o

Oktale Ganzzahl

s

String oder ein beliebiges Objekt, das mit to_s konvertiert wurde

u

Dezimalzahl ohne Vorzeichen

x

Hexadezimale Ganzzahl (z. B. 39ff)

X

Hexadezimale Ganzzahl (z. B. 39FF)