Функции получения данных из хранилища данных аккаунта

Подробнее о хранилище данных аккаунта

Название	Описание	Сложность
getBinary(Address|Alias, String): ByteVector|Unit	Получает массив байтов по ключу	10
getBinary(String): ByteVector|Unit	Получает массив байтов по ключу из собственного хранилища данных	10
getBinaryValue(Address|Alias, String): ByteVector	Получает массив байтов по ключу. Завершается ошибкой, если данных нет	10
getBinaryValue(String): ByteVector	Получает массив байтов по ключу из собственного хранилища данных. Завершается ошибкой, если данных нет	10
getBoolean(Address|Alias, String): Boolean|Unit	Получает логическое значение по ключу	10
getBoolean(String): Boolean|Unit	Получает логическое значение по ключу из собственного хранилища данных	10
getBooleanValue(Address|Alias, String): Boolean	Получает логическое значение по ключу. Завершается ошибкой, если данных нет	10
getBooleanValue(String): Boolean	Получает логическое значение по ключу из собственного хранилища данных. Завершается ошибкой, если данных нет	10
getInteger(Address|Alias, String): Int|Unit	Получает целое число по ключу	10
getInteger(String): Int|Unit	Получает целое число по ключу из собственного хранилища данных	10
getIntegerValue(Address|Alias, String): Int	Получает целое число по ключу. Завершается ошибкой, если данных нет	10
getIntegerValue(String): Int	Получает целое число по ключу из собственного хранилища данных. Завершается ошибкой, если данных нет	10
getString(Address|Alias, String): String|Unit	Получает строку по ключу	10
getString(String): String|Unit	Получает строку по ключу из собственного хранилища данных	10
getStringValue(Address|Alias, String): String	Получает строку по ключу. Завершается ошибкой, если данных нет	10
getStringValue(String): String	Получает строку по ключу из собственного хранилища данных. Завершается ошибкой, если данных нет	10
isDataStorageUntouched(Address|Alias): Boolean	Проверяет, что хранилище данных указанного аккаунта никогда не содержало записей	10

getBinary(Address|Alias, String): ByteVector|Unit

Получает массив байтов по ключу.

getBinary(addressOrAlias: Address|Alias, key: String): ByteVector|Unit

Параметры

Параметр	Описание
addressOrAlias: Address|Alias	Адрес или псевдоним аккаунта
key: String	Ключ записи

Пример

let address = Address(base58'3N4iKL6ikwxiL7yNvWQmw7rg3wGna8uL6LU')
let t = address.getBinary("bin")
match t {
   case v: ByteVector => v.toBase64String() 
   case _ => throw("No entry with the 'bin' key")
}
# Возвращает "SGVsbG8gV2F2ZXM="

getBinary(String): ByteVector|Unit

Получает массив байтов по ключу из собственного хранилища данных аккаунта, к которому прикреплен скрипт.

getBinary(key: String): ByteVector|Unit

Параметры

Параметр	Описание
key: String	Ключ записи

getBinaryValue(Address|Alias, String): ByteVector

Получает массив байтов по ключу. Завершается ошибкой, если данных нет.

getBinaryValue(addressOrAlias: Address|Alias, key: String): ByteVector

Параметры

Параметр	Описание
addressOrAlias: Address|Alias	Адрес или псевдоним аккаунта
key: String	Ключ записи

Пример

let address = Address(base58'3N4iKL6ikwxiL7yNvWQmw7rg3wGna8uL6LU')
let b = address.getBinaryValue("bin").toBase64String()          # "SGVsbG8gV2F2ZXM="
address.getBinaryValue("nosuchkey").toBase64String()            # Завершается ошибкой

getBinaryValue(String): ByteVector

Получает массив байтов по ключу из собственного хранилища данных аккаунта, к которому прикреплен скрипт. Завершается ошибкой, если данных нет.

getBinaryValue(key: String): ByteVector

Параметры

Параметр	Описание
key: String	Ключ записи

getBoolean(Address|Alias, String): Boolean|Unit

Получает логическое значение по ключу.

getBoolean(addressOrAlias: Address|Alias, key: String): Boolean|Unit

Параметры

Параметр	Описание
addressOrAlias: Address|Alias	Адрес или псевдоним аккаунта
key: String	Ключ записи

Пример

let address = Address(base58'3N4iKL6ikwxiL7yNvWQmw7rg3wGna8uL6LU')
let t = address.getBoolean("bool")        # true
let u = address.getBoolean("nosuchkey")   # unit
let v = address.getBoolean("int")         # unit

getBoolean(String): Boolean|Unit

Получает массив байтов по ключу из собственного хранилища данных аккаунта, к которому прикреплен скрипт.

getBoolean(key: String): Boolean|Unit

Параметры

Параметр	Описание
key: String	Ключ записи

getBooleanValue(Address|Alias, String): Boolean

Получает логическое значение по ключу. Завершается ошибкой, если данных нет.

getBooleanValue(addressOrAlias: Address|Alias, key: String): Boolean

Параметры

Параметр	Описание
addressOrAlias: Address|Alias	Адрес или псевдоним аккаунта
key: String	Ключ записи

Пример

let address = Address(base58'3N4iKL6ikwxiL7yNvWQmw7rg3wGna8uL6LU')
let t = address.getBooleanValue("bool")       # true
address.getBooleanValue("str")                # Завершается ошибкой

getBooleanValue(String): Boolean

Получает логическое значение по ключу из собственного хранилища данных аккаунта, к которому прикреплен скрипт. Завершается ошибкой, если данных нет.

getBooleanValue(key: String): Boolean

Параметры

Параметр	Описание
key: String	Ключ записи

getInteger(Address|Alias, String): Int|Unit

Получает целое число по ключу.

getInteger(addressOrAlias: Address|Alias, key: String): Int|Unit

Параметры

Параметр	Описание
addressOrAlias: Address|Alias	Адрес или псевдоним аккаунта
key: String	Ключ записи

Пример

let address = Address(base58'3N4iKL6ikwxiL7yNvWQmw7rg3wGna8uL6LU')
let t = address.getInteger("int")         # 1234567
let u = address.getInteger("nosuchkey")   # unit
let v = address.getInteger("str")         # unit

getInteger(String): Int|Unit

Получает целое число по ключу из собственного хранилища данных аккаунта, к которому прикреплен скрипт.

getInteger(key: String): Int|Unit

Параметры

Параметр	Описание
key: String	Ключ записи

getIntegerValue(Address|Alias, String): Int

Получает целое число по ключу. Завершается ошибкой, если данных нет.

getIntegerValue(addressOrAlias: Address|Alias, key: String): Int

Параметры

Параметр	Описание
addressOrAlias: Address|Alias	Адрес или псевдоним аккаунта
key: String	Ключ записи

Пример

let address = Address(base58'3N4iKL6ikwxiL7yNvWQmw7rg3wGna8uL6LU')
let t = address.getIntegerValue("int")         # 1234567
address.getIntegerValue("nosuchkey")           # Завершается ошибкой

getIntegerValue(String): Int

Получает массив байтов по ключу из собственного хранилища данных аккаунта, к которому прикреплен скрипт. Завершается ошибкой, если данных нет.

getIntegerValue(key: String): Int

Параметры

Параметр	Описание
key: String	Ключ записи

getString(Address|Alias, String): String|Unit

Получает строку по ключу.

getString(addressOrAlias: Address|Alias, key: String): String|Unit

Параметры

Параметр	Описание
addressOrAlias: Address|Alias	Адрес или псевдоним аккаунта
key: String	Ключ записи

Пример

let address = Address(base58'3N4iKL6ikwxiL7yNvWQmw7rg3wGna8uL6LU')
let t = address.getString("str")         # "some text"
let u = address.getString("nosuchkey")   # unit
let v = address.getString("int")         # unit

getString(String): String|Unit

Получает строку по ключу из собственного хранилища данных аккаунта, к которому прикреплен скрипт.

getString(key: String): String|Unit

Параметры

Параметр	Описание
key: String	Ключ записи

getStringValue(Address|Alias, String): String

Получает строку по ключу. Завершается ошибкой, если данных нет.

getStringValue(addressOrAlias: Address|Alias, key: String): String

Параметры

Параметр	Описание
addressOrAlias: Address|Alias	Адрес или псевдоним аккаунта
key: String	Ключ записи

Example

let address = Address(base58'3N4iKL6ikwxiL7yNvWQmw7rg3wGna8uL6LU')
let t = address.getStringValue("str")         # "some text"
address.getStringValue("bool")                # Завершается ошибкой

getStringValue(String): String

Получает строку по ключу из собственного хранилища данных аккаунта, к которому прикреплен скрипт. Завершается ошибкой, если данных нет.

getStringValue(key: String): String

Параметры

Параметр	Описание
key: String	Ключ записи

isDataStorageUntouched(Address|Alias): Boolean

Проверяет, что хранилище данных указанного аккаунта никогда не содержало записей.

Возвращает false, если в хранилище данных была хотя бы одна запись, даже если она удалена.

isDataStorageUntouched(addressOrAlias: Address|Alias): Boolean

Параметры

Параметр	Описание
addressOrAlias: Address|Alias	Адрес или псевдоним аккаунта

Пример

let addr = Address(base58'3N4iKL6ikwxiL7yNvWQmw7rg3wGna8uL6LU')

isDataStorageUntouched(addr) # Возвращает false