User's Guide
Reference Manual
Release Notes
PDF
Top

ASN.1
Reference Manual
Version 2.0.2

Expand All
Contract All

Table of Contents

- asn1ct
  - Top of manual page
  - compile/1
  - compile/2
  - encode/3
  - decode/3
  - value/2
  - test/1
  - test/2
  - test/3
- asn1rt
  - Top of manual page
  - decode/3
  - encode/3
  - info/1
  - utf8_binary_to_list/1
  - utf8_list_to_binary/1

# asn1rt

### MODULE

asn1rt

### MODULE SUMMARY

ASN.1 runtime support functions

### DESCRIPTION

This module is the interface module for the ASN.1 runtime support functions. To encode and decode ASN.1 types in runtime the functions in this module should be used.

### EXPORTS

decode(Module,Type,Bytes) -> {ok,Value}|{error,Reason}

Types:

Module = Type = atom()
Value = Reason = term()
Bytes = binary

Decodes Type from Module from the binary Bytes. Returns {ok,Value} if successful.

encode(Module,Type,Value)-> {ok,Bytes} | {error,Reason}

Types:

Module = Type = atom()
Value = term()
Bytes = binary
Reason = term()

Encodes Value of Type defined in the ASN.1 module Module. Returns a possibly nested list of bytes and or binaries if successful. To get as fast execution as possible the encode function only performs rudimentary tests that the input Value is a correct instance of Type. The length of strings is for example not always checked.

Note

Starting in R16, Bytes is always a binary.

info(Module) -> {ok,Info} | {error,Reason}

Types:

Module = atom()
Info = list()
Reason = term()

info/1 returns the version of the asn1 compiler that was used to compile the module. It also returns the compiler options that was used.

utf8_binary_to_list(UTF8Binary) -> {ok,UnicodeList} | {error,Reason}

Types:

UTF8Binary = binary()
UnicodeList = [integer()]
Reason = term()

utf8_binary_to_list/1 Transforms a UTF8 encoded binary to a list of integers, where each integer represents one character as its unicode value. The function fails if the binary is not a properly encoded UTF8 string.

utf8_list_to_binary(UnicodeList) -> {ok,UTF8Binary} | {error,Reason}

Types:

UnicodeList = [integer()]
UTF8Binary = binary()
Reason = term()

utf8_list_to_binary/1 Transforms a list of integers, where each integer represents one character as its unicode value, to a UTF8 encoded binary.