stringintern

Documentation

Index

• func Intern(x ...interface{})

Functions

func Intern

func Intern(x ...interface{})

Intern will recursively traverse one or more objects and collapse all strings that are identical to the same pointer, saving memory. Inputs must be pointer types. String map keys are not interned. The path to all fields must be exported. It is not possible to modify unexported fields in a safe way. Example usage:

var x = ... some complicated type with strings
stringintern.Intern(&x)

Warning: This is a potentially dangerous operation.

Extreme care must be taken that no pointers exist to other structures that should not be modified.
This method is not thread safe.  No other threads should be reading or writing to x while it is being interned.

It is safest to use this code for testing purposes to see how much memory can be saved by interning but then do the interning explicitly:

sizeBefore := memsize.DeepSize(&x)
stringintern.Intern(&x)
sizeAfter := memsize.DeepSize(&x)