append.gdsn {gdsfmt} | R Documentation

## Append data to a specified variable

### Description

Append new data to the data field of a GDS node.

### Usage

    append.gdsn(node, val, check=TRUE)

### Arguments

`node` | an object of class `gdsn.class`
`val` | R primitive data, like integer; or an object of class `gdsn.class`
`check` | whether a warning is given, when appended data can not match the capability of data field; if `val` is character-type, a warning will be shown if there is any `NA` in `val`

### Details

`storage.mode(val)` should be "integer", "double", "character" or "logical". GDS format does not support missing characters `NA`, and any `NA` will be converted to a blank string `""`.

### Value

None.

### Author(s)

Xiuwen Zheng

### References

http://github.com/zhengxwen/gdsfmt

### See Also

`read.gdsn`, `write.gdsn`, `add.gdsn`

### Examples

    # cteate a GDS file
    f <- createfn.gds("test.gds")

    # commom types
    n <- add.gdsn(f, "int", val=matrix(1:10000, nrow=100, ncol=100),
        compress="ZIP")

    # no warning, and add a new column
    append.gdsn(n, -1:-100)
    f

    # a warning
    append.gdsn(n, -1:-50)
    f

    # no warning here, and add a new column
    append.gdsn(n, -51:-100)
    f

    # you should call "readmode.gdsn" before reading, since compress="ZIP"
    readmode.gdsn(n)

    # check the last column
    read.gdsn(n, start=c(1, 102), count=c(-1, 1))

    # characters
    n <- add.gdsn(f, "string", val=as.character(1:100))
    append.gdsn(n, as.character(rep(NA, 25)))

    read.gdsn(n)

    # close the GDS file
    closefn.gds(f)

    # delete the temporary file
    unlink("test.gds", force=TRUE)

[Package gdsfmt version 1.20.0 Index]