Share this page

# lr_encrypt_ex

Encrypts a string.

## C Language

    char* lr_encrypt_ex(const char* plaintext);

## Java

    String lr.encrypt_ex( String plaintext);

## Arguments

Name | Comments
--- | ---
plaintext | The string to encrypt.

The lr_encrypt_ex function is used to encrypt messages. Encryption is based on the AES-256-GCM algorithm and is compliant with FIPS requirements. The encrypted string can be decrypted by lr_decrypt_ex.

The AES key must be set before this function can be used. For details, see Add an AES key in the Help Center.

Tip: You can encrypt a string in the script using the same encryption method, by right-clicking the string and selecting Encrypt String (Stronger Encryption). The string is encrypted and inserted as an argument of lr_decrypt_ex.

## Return Values

This function returns an encrypted string.

## Parameterization

The argument plaintext can be parameterized.

## Examples

C

Copy code

    Action()
    {
        char* ciphertext;
        char* plaintext;

        ciphertext = lr_encrypt_ex("hello world!");
        plaintext = lr_decrypt_ex(ciphertext);

        lr_output_message("ciphertext is %s", ciphertext);
        lr_output_message("plaintext is %s", plaintext);

        return 0;
    }

Java

Copy code

    import lrapi.lr;

    public class Actions
    {

        public int init() throws Throwable {
            return 0;
        }//end of init

        public int action() throws Throwable {
            String ciphertext = "Hello World!";
            String encrypted = lr.encrypt_ex(ciphertext);
            String decrypted = lr.decrypt_ex(encrypted);
            lr.output_message(decrypted);
            return 0;
        }//end of action

        public int end() throws Throwable {
            return 0;
        }//end of end

Tips to improve your search results... VuGen Function Reference Version 25.1-25.3 Function Reference 25.1-25.3 All View Local Help Center View Online Help Center Version: