Sub

 

 

Description

The - function subtracts forms the difference between a variety of numeric data types and a complex number as shown in the examples below.

When to use

The - function is used to form the difference between numeric data types where at least one of the subtrahends is complex. Do not use if an immediate type, such as a real number, would suffice. Since complex numbers are heap objects, they require more space and operations on these types are slower than on immediate types.

 

Syntax

(- num ...)

Name Description AIS Types
num ... One or more NumbersNumber

Returns:

A numeric complex number holding the value of N1 less than the value of N2, N3, etc.

 

Examples

Here are a number of links to Lambda coding examples which contain this instruction in various use cases.

Example_Complex_(sym)sub_002

The difference of a variety of data types and a complex number is shown here. The result of the operation is shown in the comment. The first double shown is the real part of the result. The second number shown is the imaginary part of the result.

Example_Complex_(sym)sub_003

The nsub function is tested here with Complex Number arguments.

 

Argument Types

Here are the links to the data types of the function arguments.

Number Integer Complex

Here are also a number of links to functions having arguments with any of these data types.

++(Symbol) +=(Symbol) +(Complex) +(Number)
/=(Symbol) /(Complex) /(Number) *(Complex)
*(Number) --(Symbol) -=(Symbol) -(Complex)
-(Number) abs(Complex) abs(Number) acos(Number)
add1(Number) addMethod(BitVector) addMethod(Boolean) addMethod(Brick)
addMethod(Character) addMethod(CpxVector) addMethod(Date) addMethod(Dictionary)
addMethod(Directory) addMethod(FltVector) addMethod(Function) addMethod(IntVector)
addMethod(List) addMethod(Matrix) addMethod(NumMatrix) addMethod(NumVector)
addMethod(Number) addMethod(ObjVector) addMethod(ObjectRepository) addMethod(Pair)
addMethod(PcodeVector) addMethod(ShortVector) addMethod(String) addMethod(Structure)
addMethod(Symbol) addMethod(Vector) addMethod(Void) addi(Number)
argument(Complex) arithmetic(Number) asin(Number) atan(Number)
avg(CpxVector) avg(Number) badd(Boolean) balance(Lambda)
bdiv(Boolean) binaryInsert(CpxVector) binaryInsert(FltVector) binaryInsert(IntVector)
binaryInsert(Matrix) binaryInsert(NumMatrix) binaryInsert(NumVector) binaryInsert(ShortVector)
binaryInsert(Structure) binaryInsert(Vector) binaryNand(Integer) binaryNor(Integer)
binaryNot(Integer) binaryNxor(Integer) binarySearch(CpxVector) binarySearch(Dictionary)
binarySearch(FltVector) binarySearch(IntVector) binarySearch(Matrix) binarySearch(NumMatrix)
binarySearch(NumVector) binarySearch(ObjVector) binarySearch(ShortVector) binarySearch(Structure)
binarySearch(Vector) bitwiseAnd(Integer) bitwiseNand(Integer) bitwiseNor(Integer)
bitwiseNot(Integer) bitwiseNxor(Integer) bitwiseOr(Integer) bitwiseShiftLeft(Integer)
bitwiseShiftRight(Integer) bitwiseXor(Integer) bmod(Boolean) bmul(Boolean)
boolean(Boolean) cadd(Character) cdiv(Character) char(String)
character(Character) cmod(Character) cmul(Character) code(String)
compareEQ(BitVector) compareEQ(Boolean) compareEQ(Brick) compareEQ(Character)
compareEQ(Complex) compareEQ(CpxVector) compareEQ(Date) compareEQ(Dictionary)
compareEQ(Directory) compareEQ(FltVector) compareEQ(Function) compareEQ(IntVector)
compareEQ(Lambda) compareEQ(List) compareEQ(Matrix) compareEQ(NumMatrix)
compareEQ(NumVector) compareEQ(Number) compareEQ(ObjVector) compareEQ(ObjectRepository)
compareEQ(Pair) compareEQ(ShortVector) compareEQ(String) compareEQ(Structure)
compareEQ(Symbol) compareEQ(Vector) compareEQ(Void) compareGE(BitVector)
compareGE(Boolean) compareGE(Brick) compareGE(Character) compareGE(Complex)
compareGE(CpxVector) compareGE(Date) compareGE(Dictionary) compareGE(Directory)
compareGE(Function) compareGE(IntVector) compareGE(Lambda) compareGE(List)
compareGE(Matrix) compareGE(NumMatrix) compareGE(Number) compareGE(ObjVector)
compareGE(ObjectRepository) compareGE(Pair) compareGE(ShortVector) compareGE(String)
compareGE(Structure) compareGE(Symbol) compareGE(Vector) compareGE(Void)
compareGT(BitVector) compareGT(Boolean) compareGT(Brick) compareGT(Character)
compareGT(Complex) compareGT(CpxVector) compareGT(Date) compareGT(Dictionary)
compareGT(Directory) compareGT(Function) compareGT(IntVector) compareGT(Lambda)
compareGT(List) compareGT(Matrix) compareGT(NumMatrix) compareGT(NumVector)
compareGT(Number) compareGT(ObjVector) compareGT(ObjectRepository) compareGT(Pair)
compareGT(ShortVector) compareGT(String) compareGT(Structure) compareGT(Symbol)
compareGT(Vector) compareGT(Void) compareLE(BitVector) compareLE(Boolean)
compareLE(Brick) compareLE(Character) compareLE(Complex) compareLE(CpxVector)
compareLE(Date) compareLE(Dictionary) compareLE(Directory) compareLE(FltVector)
compareLE(Function) compareLE(IntVector) compareLE(Lambda) compareLE(List)
compareLE(Matrix) compareLE(NumMatrix) compareLE(NumVector) compareLE(Number)
compareLE(ObjVector) compareLE(ObjectRepository) compareLE(Pair) compareLE(ShortVector)
compareLE(String) compareLE(Structure) compareLE(Symbol) compareLE(Vector)
compareLE(Void) compareLT(BitVector) compareLT(Boolean) compareLT(Brick)
compareLT(Character) compareLT(Complex) compareLT(CpxVector) compareLT(Date)
compareLT(Dictionary) compareLT(Directory) compareLT(FltVector) compareLT(Function)
compareLT(IntVector) compareLT(Lambda) compareLT(List) compareLT(Matrix)
compareLT(NumMatrix) compareLT(NumVector) compareLT(Number) compareLT(ObjVector)
compareLT(ObjectRepository) compareLT(Pair) compareLT(ShortVector) compareLT(String)
compareLT(Structure) compareLT(Symbol) compareLT(Vector) compareLT(Void)
compareNE(BitVector) compareNE(Boolean) compareNE(Brick) compareNE(Character)
compareNE(Complex) compareNE(CpxVector) compareNE(Date) compareNE(Dictionary)
compareNE(Directory) compareNE(FltVector) compareNE(Function) compareNE(IntVector)
compareNE(Lambda) compareNE(List) compareNE(Matrix) compareNE(NumMatrix)
compareNE(NumVector) compareNE(Number) compareNE(ObjVector) compareNE(ObjectRepository)
compareNE(Pair) compareNE(ShortVector) compareNE(String) compareNE(Structure)
compareNE(Symbol) compareNE(Vector) compareNE(Void) compare(BitVector)
compare(Boolean) compare(Brick) compare(Character) compare(Complex)
compare(CpxVector) compare(Date) compare(Dictionary) compare(Directory)
compare(FltVector) compare(Function) compare(IntVector) compare(Lambda)
compare(List) compare(Matrix) compare(NumMatrix) compare(NumVector)
compare(Number) compare(ObjVector) compare(ObjectRepository) compare(Pair)
compare(ShortVector) compare(String) compare(Structure) compare(Symbol)
compare(Vector) compare(Void) complex(Complex) conjugate(Complex)
cons(Pair) cos(Complex) cos(Number) cosh(Number)
count(Dictionary) count(Directory) count(List) count(Matrix)
count(NumMatrix) count(Pair) count(Structure) count(Vector)
csub(Character) date(Date) day(Date) days360(Date)
debugDialog(String) decode(ByteVector) deg(Number) deleteRows(Brick)
delete(Dictionary) delete(Directory) delete(FltVector) delete(IntVector)
delete(List) delete(Matrix) delete(NumMatrix) delete(NumVector)
delete(ObjVector) delete(ObjectRepository) delete(Pair) delete(ShortVector)
delete(Structure) delete(Vector) display(ByteVector) display(FileIO)
divi(Number) evalInSyncLocalContext(Context) exp(Complex) exp(Number)
exportTab(Lambda) exportTab(ObjectRepository) expt(Complex) expt(Number)
fact(Integer) fact(Number) fdisplay(ByteVector) fdisplay(Text)
fileClose(ByteVector) fileClose(Text) fileDisplay(ByteVector) fileDisplay(Text)
fileErase(ByteVector) fileErase(Text) fileOpen(ByteVector) fileOpen(Text)
fileReadRecord(ByteVector) fileReadRecord(String) fileReadRecord(Text) fileRead(ByteVector)
fileRead(Text) fileResize(ByteVector) fileResize(String) fileResize(Text)
fileSeek(ByteVector) fileSeek(String) fileSeek(Text) fileWrite(ByteVector)
fileWrite(String) fileWrite(Text) filewriteln(ByteVector) filewriteln(String)
filewriteln(Text) findBlock(BitVector) find(String) floor(Number)
fraction(Number) freeBlock(BitVector) gcd(Integer) gcd(Number)
getContextPtr(Context) getHttp(String) getHttp(Text) getTickCount(Date)
hashString(String) hashString(Symbol) hour(Date) iadd(Integer)
icompareEQ(Integer) icompareGE(Integer) icompareGT(Integer) icompareLE(Integer)
icompareLT(Integer) icompareNE(Integer) idiv(Integer) imaginary(Complex)
imod(Integer) importTab(Lambda) importTab(ObjectRepository) imul(Number)
insertRows(Brick) insert(Dictionary) insert(Directory) insert(FltVector)
insert(IntVector) insert(Matrix) insert(NumMatrix) insert(NumVector)
insert(ObjVector) insert(ShortVector) insert(Structure) insert(Vector)
inside(BitVector) inside(Dictionary) inside(Directory) inside(IntVector)
inside(List) inside(Matrix) inside(NumMatrix) inside(NumVector)
inside(ShortVector) inside(Structure) inside(Vector) inspect(Context)
inspect(Lambda) inspect(ObjectRepository) integer(Integer) isAtom(BitVector)
isAtom(Brick) isAtom(Dictionary) isAtom(Directory) isAtom(FltVector)
isAtom(IntVector) isAtom(List) isAtom(Matrix) isAtom(NumMatrix)
isAtom(NumVector) isAtom(ObjVector) isAtom(Pair) isAtom(PcodeVector)
isAtom(ShortVector) isAtom(Structure) isAtom(Vector) isBitVector(BitVector)
isBoolean(Boolean) isBound(Dictionary) isBound(Directory) isBound(Structure)
isByteVector(ByteVector) isChar(String) isCharacter(Character) isComplex(Complex)
isDate(Date) isDictionary(Dictionary) isDirectory(Directory) isEqual(BitVector)
isEqual(Boolean) isEqual(Brick) isEqual(Character) isEqual(Complex)
isEqual(Date) isEqual(Dictionary) isEqual(Directory) isEqual(FltVector)
isEqual(Function) isEqual(IntVector) isEqual(List) isEqual(Matrix)
isEqual(NumMatrix) isEqual(NumVector) isEqual(Number) isEqual(ObjVector)
isEqual(Pair) isEqual(ShortVector) isEqual(String) isEqual(Structure)
isEqual(Vector) isEqual(Void) isError(Error) isEven(Number)
isExact(Number) isFloatVector(FltVector) isIdentical(BitVector) isIdentical(Boolean)
isIdentical(Brick) isIdentical(Character) isIdentical(Complex) isIdentical(Date)
isIdentical(Dictionary) isIdentical(Directory) isIdentical(Error) isIdentical(FltVector)
isIdentical(Function) isIdentical(IntVector) isIdentical(List) isIdentical(Matrix)
isIdentical(NumMatrix) isIdentical(NumVector) isIdentical(Number) isIdentical(ObjVector)
isIdentical(ObjectRepository) isIdentical(Pair) isIdentical(PcodeVector) isIdentical(ShortVector)
isIdentical(Structure) isIdentical(Vector) isIdentical(Void) isInexact(Number)
isInside(BitVector) isInside(Dictionary) isInside(Directory) isInside(IntVector)
isInside(List) isInside(Matrix) isInside(NumMatrix) isInside(NumVector)
isInside(ObjVector) isInside(Pair) isInside(ShortVector) isInside(Structure)
isInside(Vector) isIntegerVector(IntVector) isInteger(Integer) isMatrix(Matrix)
isMember(BitVector) isMember(Dictionary) isMember(Directory) isMember(IntVector)
isMember(List) isMember(Matrix) isMember(NumMatrix) isMember(NumVector)
isMember(ObjVector) isMember(Pair) isMember(ShortVector) isMember(Structure)
isMember(Vector) isMoney(Number) isNegative(Number) isNull(Number)
isNull(Void) isNumberMatrix(NumMatrix) isNumberVector(NumVector) isNumber(Number)
isObjectVector(ObjVector) isObject(BitVector) isObject(Brick) isObject(ByteVector)
isObject(Dictionary) isObject(Directory) isObject(FltVector) isObject(IntVector)
isObject(List) isObject(Matrix) isObject(NumMatrix) isObject(NumVector)
isObject(ObjVector) isObject(Pair) isObject(PcodeVector) isObject(ShortVector)
isObject(String) isObject(Structure) isObject(Symbol) isObject(Vector)
isOdd(Number) isPair(List) isPair(Pair) isPcodeVector(PcodeVector)
isPositive(Number) isString(String) isStructure(Structure) isSymbol(Symbol)
isText(String) isType(BitVector) isType(Boolean) isType(Brick)
isType(Character) isType(Complex) isType(Date) isType(Dictionary)
isType(Directory) isType(FltVector) isType(Function) isType(IntVector)
isType(Matrix) isType(NumMatrix) isType(NumVector) isType(Number)
isType(ObjVector) isType(ObjectRepository) isType(Pair) isType(ShortVector)
isType(String) isType(Structure) isType(Symbol) isType(Vector)
isType(Void) isVector(Vector) isZero(Number) isub(Integer)
julian(Date) kurtosis(Number) lcm(Integer) left(String)
length(BitVector) length(Brick) length(Dictionary) length(Directory)
length(FltVector) length(IntVector) length(List) length(Matrix)
length(NumMatrix) length(NumVector) length(ObjVector) length(ObjectRepository)
length(Pair) length(PcodeVector) length(ShortVector) length(String)
length(Structure) length(Symbol) length(Vector) list(List)
log10(Complex) log10(Number) log2(Complex) log2(Number)
log(Complex) log(Number) logbase(Complex) logbase(Number)
macroReplace(String) makeQuotedList(List) max(Number) median(Number)
member(BitVector) member(Dictionary) member(Directory) member(IntVector)
member(List) member(Matrix) member(NumMatrix) member(NumVector)
member(ObjVector) member(ShortVector) member(Structure) member(Vector)
mid(String) min(Number) minute(Date) mod(Complex)
mod(Number) modi(Number) money(Number) month(Date)
muli(Number) nadd(Number) ncompareEQ(Number) ncompareGE(Number)
ncompareGT(Number) ncompareLE(Number) ncompareLT(Number) ncompareNE(Number)
ndiv(Number) new(BitVector) new(Brick) new(ByteVector)
new(CpxVector) new(Dictionary) new(Directory) new(FltVector)
new(IntVector) new(Lambda) new(Matrix) new(NumMatrix)
new(NumVector) new(ObjVector) new(ObjectRepository) new(PcodeVector)
new(ShortVector) new(String) new(Structure) new(Symbol)
new(Vector) nmod(Number) nmul(Number) now(Date)
nsub(Number) number(Number) objectToMatrix(Matrix) objectToNumMatrix(NumMatrix)
objectToNumVector(NumVector) pair(Pair) parse(String) pi(Number)
postHttp(String) postHttp(Text) preAllocateFixedMemoryBlocks(Context) product(Number)
rad(Number) random(Number) randomize(Number) range(Number)
rank(Matrix) rank(NumMatrix) readHtmlPage(String) readHtmlPage(Text)
real(Complex) refAttributes(Dictionary) refAttributes(Directory) refAttributes(Structure)
refAttributes(Vector) refValues(Dictionary) refValues(Directory) refValues(Structure)
refValues(Vector) ref(BitVector) ref(Boolean) ref(Brick)
ref(Character) ref(Complex) ref(Date) ref(Dictionary)
ref(Directory) ref(FltVector) ref(Function) ref(IntVector)
ref(Lambda) ref(List) ref(Matrix) ref(NumMatrix)
ref(NumVector) ref(Number) ref(ObjVector) ref(ObjectRepository)
ref(PcodeVector) ref(ShortVector) ref(String) ref(Structure)
ref(Symbol) ref(Vector) ref(Void) remove(BitVector)
remove(Dictionary) remove(Directory) remove(IntVector) remove(Matrix)
remove(NumMatrix) remove(NumVector) remove(ObjVector) remove(ShortVector)
remove(Structure) remove(Vector) replace(String) rept(String)
requestHttp(String) requestHttp(Text) resize(BitVector) resize(Dictionary)
resize(Directory) resize(FltVector) resize(IntVector) resize(Matrix)
resize(NumMatrix) resize(NumVector) resize(ObjVector) resize(ShortVector)
resize(Structure) resize(Vector) right(String) round(Number)
saveObject(ByteVector) saveObject(Integer) saveRepository(ObjectRepository) second(Date)
send(BitVector) send(Boolean) send(Brick) send(Character)
send(CpxVector) send(Date) send(Dictionary) send(Directory)
send(FltVector) send(Function) send(IntVector) send(Lambda)
send(List) send(Matrix) send(NumMatrix) send(NumVector)
send(Number) send(ObjectRepository) send(Pair) send(ShortVector)
send(String) send(Structure) send(Symbol) send(Vector)
send(Void) setAttributes(Dictionary) setAttributes(Directory) setAttributes(Structure)
setAttributes(Vector) setBlock(BitVector) setCar(List) setCar(Pair)
setCdr(BitVector) setCdr(Brick) setCdr(Dictionary) setCdr(Directory)
setCdr(FltVector) setCdr(IntVector) setCdr(List) setCdr(Matrix)
setCdr(NumMatrix) setCdr(NumVector) setCdr(ObjVector) setCdr(Pair)
setCdr(ShortVector) setCdr(Structure) setCdr(Vector) setLastCdr(BitVector)
setLastCdr(FltVector) setLastCdr(IntVector) setLastCdr(List) setLastCdr(Matrix)
setLastCdr(NumMatrix) setLastCdr(NumVector) setLastCdr(ObjVector) setLastCdr(Structure)
setLastCdr(Vector) setq(BitVector) setq(Boolean) setq(Brick)
setq(Character) setq(Date) setq(Dictionary) setq(Directory)
setq(FltVector) setq(IntVector) setq(Lambda) setq(List)
setq(Matrix) setq(NumVector) setq(Number) setq(ObjVector)
setq(ObjectRepository) setq(PcodeVector) setq(ShortVector) setq(String)
setq(Structure) setq(Symbol) setq(Vector) setq(Void)
sign(Number) sin(Complex) sin(Number) sinh(Number)
sizeof(BitVector) sizeof(Boolean) sizeof(Brick) sizeof(ByteVector)
sizeof(Character) sizeof(Complex) sizeof(Date) sizeof(Dictionary)
sizeof(Directory) sizeof(FltVector) sizeof(Function) sizeof(IntVector)
sizeof(List) sizeof(Matrix) sizeof(NumMatrix) sizeof(NumVector)
sizeof(Number) sizeof(ObjVector) sizeof(ObjectRepository) sizeof(Pair)
sizeof(PcodeVector) sizeof(ShortVector) sizeof(String) sizeof(Structure)
sizeof(Symbol) sizeof(Vector) sizeof(Void) skew(Number)
sort(BitVector) sort(Dictionary) sort(Directory) sort(FltVector)
sort(IntVector) sort(List) sort(Matrix) sort(NumMatrix)
sort(NumVector) sort(ObjVector) sort(ShortVector) sort(Structure)
sort(Vector) sqrt(Complex) sqrt(Number) srandom(Number)
stdev(Number) stdevp(Number) string(Complex) string(String)
sub1(Number) subi(Number) submit(Context) subscribe(Context)
substitute(String) substring(String) sum(Complex) sum(Number)
sumsqr(Complex) sumsqr(Number) svmRegression(Vector) system(ByteVector)
system(Text) tan(Complex) tan(Number) tanh(Number)
testFunction(Structure) text(String) time(Date) type(BitVector)
type(Boolean) type(Brick) type(ByteVector) type(Character)
type(Complex) type(Date) type(Dictionary) type(Directory)
type(FltVector) type(Function) type(IntVector) type(Lambda)
type(Matrix) type(NumMatrix) type(NumVector) type(Number)
type(ObjVector) type(ObjectRepository) type(Pair) type(PcodeVector)
type(ShortVector) type(String) type(Structure) type(Symbol)
type(Vector) type(Void) uniqueInsert(FltVector) uniqueInsert(IntVector)
uniqueInsert(Matrix) uniqueInsert(NumMatrix) uniqueInsert(NumVector) uniqueInsert(ObjVector)
uniqueInsert(ShortVector) uniqueInsert(Structure) uniqueInsert(Vector) var(Number)
varp(Number) vectorBinaryInnerProduct(NumVector) vectorBipolarInnerProduct(NumVector) vectorCosineInnerProduct(NumVector)
vectorCubeInnerProduct(NumVector) vectorDelete(Directory) vectorExpInnerProduct(NumVector) vectorFill(BitVector)
vectorFill(FltVector) vectorFill(IntVector) vectorFill(Matrix) vectorFill(NumMatrix)
vectorFill(NumVector) vectorFill(ObjVector) vectorFill(ShortVector) vectorFill(Vector)
vectorInnerProduct(NumVector) vectorLogInnerProduct(NumVector) vectorQuartInnerProduct(NumVector) vectorQuintInnerProduct(NumVector)
vectorSigmoidInnerProduct(NumVector) vectorSineInnerProduct(NumVector) vectorSquareInnerProduct(NumVector) vectorTanInnerProduct(NumVector)
vectorTanhInnerProduct(NumVector) writeln(ByteVector) writeln(String) writeln(Text)
year(Date)

How do I contact the AIS team?

You can always talk with the AIS at aiserver.sourceforge.net.