Assigns Kotlin identifier names to avoid collisions, keywords, and invalid characters. To use, first create an instance and allocate all of the names that you need. Typically this is a mix of user-supplied names and constants:

val nameAllocator = NameAllocator()
for (property in properties) {
nameAllocator.newName(, property)
nameAllocator.newName("sb", "string builder")

Pass a unique tag object to each allocation. The tag scopes the name, and can be used to look up the allocated name later. Typically the tag is the object that is being named. In the above example we use property for the user-supplied property names, and "string builder" for our constant string builder.

Once we've allocated names we can use them when generating code:

val builder = FunSpec.builder("toString")

builder.addStatement("val %N = %T()",
nameAllocator.get("string builder"), StringBuilder::class)

for (property in properties) {
nameAllocator.get("string builder"), nameAllocator.get(property))
builder.addStatement("return %N.toString()", nameAllocator.get("string builder"))

The above code generates unique names if presented with conflicts. Given user-supplied properties with names ab and sb this generates the following:

override fun toString(): kotlin.String {
val sb_ = java.lang.StringBuilder()
return sb_.toString()

The underscore is appended to sb to avoid conflicting with the user-supplied sb property. Underscores are also prefixed for names that start with a digit, and used to replace name-unsafe characters like space or dash.

When dealing with multiple independent inner scopes, use a copy of the NameAllocator used for the outer scope to further refine name allocation for a specific inner scope.


Link copied to clipboard
constructor(preallocateKeywords: Boolean)


Link copied to clipboard

Create a deep copy of this NameAllocator. Useful to create multiple independent refinements of a NameAllocator to be used in the respective definition of multiples, independently-scoped, inner code blocks.

Link copied to clipboard
operator fun get(tag: Any): String

Retrieve a name created with NameAllocator.newName.

Link copied to clipboard
fun newName(suggestion: String, tag: Any = UUID.randomUUID().toString()): String

Return a new name using suggestion that will not be a Java identifier or clash with other names. The returned value can be queried multiple times by passing tag to NameAllocator.get.