Stay organized with collections
Save and categorize content based on your preferences.
Instantiation
class Instantiation : SecureRandomParameters
DRBG parameters for instantiation.
When used in SecureRandom.getInstance(String, 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() method, it means the effective instantiate parameters of the SecureRandom object.
Summary
| Public methods |
| DrbgParameters.Capability! |
Returns the capability.
|
| ByteArray! |
Returns the personalization string as a byte array.
|
| Int |
Returns the security strength in bits.
|
| String |
Returns a Human-readable string representation of this Instantiation.
|
Public methods
getCapability
fun getCapability(): DrbgParameters.Capability!
Returns the capability.
| Return |
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
fun getPersonalizationString(): ByteArray!
Returns the personalization string as a byte array.
| Return |
ByteArray! |
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
fun getStrength(): Int
Returns the security strength in bits.
| Return |
Int |
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
fun toString(): String
Returns a Human-readable string representation of this Instantiation.
| Return |
String |
the string representation |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[null,null,["Last updated 2025-02-10 UTC."],[],[],null,["# DrbgParameters.Instantiation\n\nAdded in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)\n\nInstantiation\n=============\n\n```\nclass Instantiation : SecureRandomParameters\n```\n\n|---|-------------------------------------------------|\n| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html) ||\n| ↳ | [java.security.DrbgParameters.Instantiation](#) |\n\nDRBG parameters for instantiation.\n\nWhen used in [SecureRandom.getInstance(String, SecureRandomParameters)](/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()](/reference/kotlin/java/security/SecureRandom#getParameters()) method, it means the effective instantiate parameters of the `SecureRandom` object.\n\nSummary\n-------\n\n| Public methods ||\n|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|\n| [DrbgParameters.Capability](/reference/kotlin/java/security/DrbgParameters.Capability)! | [getCapability](#getCapability())`()` Returns the capability. |\n| [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/index.html)! | [getPersonalizationString](#getPersonalizationString())`()` Returns the personalization string as a byte array. |\n| [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html) | [getStrength](#getStrength())`()` Returns the security strength in bits. |\n| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [toString](#toString())`()` Returns a Human-readable string representation of this `Instantiation`. |\n\nPublic methods\n--------------\n\n### getCapability\n\nAdded in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nfun getCapability(): DrbgParameters.Capability!\n```\n\nReturns the capability.\n\n| Return ||\n|-----------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [DrbgParameters.Capability](/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. |\n\n### getPersonalizationString\n\nAdded in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nfun getPersonalizationString(): ByteArray!\n```\n\nReturns the personalization string as a byte array.\n\n| Return ||\n|------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [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`. |\n\n### getStrength\n\nAdded in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nfun getStrength(): Int\n```\n\nReturns the security strength in bits.\n\n| Return ||\n|----------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [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. |\n\n### toString\n\nAdded in [API level 35](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nfun toString(): String\n```\n\nReturns a Human-readable string representation of this `Instantiation`.\n\n| Return ||\n|----------------------------------------------------------------------------------|---------------------------|\n| [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | the string representation |"]]
