# DrbgParameters.Instantiation

Added in[API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# Instantiation

```
class Instantiation : SecureRandomParameters
```

|---|------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                           ||
| ↳ | [java.security.DrbgParameters.Instantiation](https://developer.android.com/reference/kotlin/java/security/DrbgParameters.Instantiation#) |

DRBG parameters for instantiation.

When used in[SecureRandom.getInstance(String, SecureRandomParameters)](https://developer.android.com/reference/kotlin/java/security/SecureRandom#getInstance(kotlin.String,%20java.security.SecureRandomParameters))or one of the other similar`getInstance`calls that take a`SecureRandomParameters`parameter, it means the requested instantiate parameters the newly created`SecureRandom`object must minimally support. When used as the return value of the[SecureRandom.getParameters()](https://developer.android.com/reference/kotlin/java/security/SecureRandom#getParameters())method, it means the effective instantiate parameters of the`SecureRandom`object.

## Summary

|                                                                                                                                                         Public methods                                                                                                                                                         ||
|----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [DrbgParameters.Capability](https://developer.android.com/reference/kotlin/java/security/DrbgParameters.Capability)! | [getCapability](https://developer.android.com/reference/kotlin/java/security/DrbgParameters.Instantiation#getCapability())`()` Returns the capability.                                                   |
| [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/index.html)!                             | [getPersonalizationString](https://developer.android.com/reference/kotlin/java/security/DrbgParameters.Instantiation#getPersonalizationString())`()` Returns the personalization string as a byte array. |
| [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)                                           | [getStrength](https://developer.android.com/reference/kotlin/java/security/DrbgParameters.Instantiation#getStrength())`()` Returns the security strength in bits.                                        |
| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)                                     | [toString](https://developer.android.com/reference/kotlin/java/security/DrbgParameters.Instantiation#toString())`()` Returns a Human-readable string representation of this`Instantiation`.              |

## Public methods

### getCapability

Added in[API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun getCapability(): DrbgParameters.Capability!
```

Returns the capability.

|                                                                                                                                                         Return                                                                                                                                                         ||
|----------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [DrbgParameters.Capability](https://developer.android.com/reference/kotlin/java/security/DrbgParameters.Capability)! | If used in`getInstance`, returns the minimum capability requested. If used in`getParameters`, returns information on the effective prediction resistance flag and whether it supports reseeding. |

### getPersonalizationString

Added in[API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun getPersonalizationString(): ByteArray!
```

Returns the personalization string as a byte array.

|                                                                                                                                                                                        Return                                                                                                                                                                                        ||
|------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/index.html)! | If used in`getInstance`, returns the requested personalization string as a newly allocated array, or`null`if no personalization string is requested. The same string should be returned in`getParameters`as a new copy, or`null`if no personalization string is requested in`getInstance`. |

### getStrength

Added in[API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun getStrength(): Int
```

Returns the security strength in bits.

|                                                                                                                                                                         Return                                                                                                                                                                         ||
|----------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | If used in`getInstance`, returns the minimum strength requested, or -1 if there is no specific request on the strength. If used in`getParameters`, returns the effective strength. The effective strength must be greater than or equal to the minimum strength requested. |

### toString

Added in[API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
fun toString(): String
```

Returns a Human-readable string representation of this`Instantiation`.

|                                                   Return                                                    ||
|----------------------------------------------------------------------------------|---------------------------|
| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | the string representation |