prevnext   » Startseite » Haupt-Referenz » Funktions-Referenz » ref(), copyRef()

ref(), copyRef()

Eine Kopie einer Liste oder Map als Referenz erstellen.

Syntax:

var_type ref ( var )
var_type copyRef ( var )

Parameter:

var Eine Variable, die auch indiziert sein kann.

Beschreibung:

copyRef() ist eine historische Alternative zu ref().
Es wird eine Referenz eines Objektes erstellt. Diese Referenz sieht ersteinmal so aus wie eine Kopie. Änderungen dieser Kopie/Referenz ändern aber gleichzeitig die ursprüngliche Quelle.

Referenzen sind nur für Listen und Maps möglich. Bei allen anderen Datentypen wird eine echte Kopie erstellt. Die Anzahl der Referenzen kann durch die Funktion refCount() ermittelt werden.

Listen und Maps, die mitttels copyRef() an ein Makro übergeben werden, eignen sich auch zur Aufnahme von Rückgabewerten.

Funktionsergebnis:   var_type

Als Ergebnis wird der Inhalt der Variable var geliefert, entweder als Referenz (Liste oder Map) oder als Kopie (sonst).

Siehe auch:
 refCount()   move() 

Weitere ähnliche Funktionen:

Variablen
Funktion Kurzinfo
clear() Den Inhalt eines Ausdruckes bei Beibehaltung des Typs löschen.
copyRef() Eine Kopie einer Liste oder Map als Referenz erstellen.
def() Überprüfung auf dei Definition von Variablen.
defined() Überprüfung auf dei Definition von Variablen.
firstDef()
isEmpty() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und vom Typ NONE ist.
isFloat() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und vom Typ FLOAT ist.
isInt() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und eine Ganzzahl ist.
isInt32() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und vom Typ INT32 ist.
isInt64() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und vom Typ INT64 ist.
isList() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und vom Typ LIST ist.
isMap() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und vom Typ MAP ist.
isNum() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und eine Zahl ist.
isScalar() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und ein Skalar ist.
isString() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und vom Typ STRING ist.
isUtf16() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert, vom Typ STRING ist und gemäß UTF-16 kodiert ist.
isUtf32() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert, vom Typ STRING ist und gemäß UTF-32 kodiert ist.
isUtf8() Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert, vom Typ STRING ist und gemäß UTF-8 kodiert ist.
lastDef()
move() Den Inhalt einer Variable auf den Stack zur Weiterverarbeitung verschieben.
ref() Eine Kopie einer Liste oder Map als Referenz erstellen.
refCount() Die Anzahl der Referenzen auf eine Objekt ermitteln.
symbol()
type() Den type eines Ausdruckes ermitteln.
var() Den Namen einer Variable konstruieren.
varName() Den Namen einer Variable konstruieren.