ASN1_STRING_NEW(3ossl)

📦 version 3.5.0, in opensuse-leap 16.0

💅 ASN1_STRING_NEW — the OpenSSL manual, bestie edition

okay so this is the ASN1_STRING_NEW(3ossl) page from the OpenSSL manual, and it's literally all about the ASN1_STRING allocation functions. three little guys: one makes a string, one makes a string of a specific type, one yeets it into the void. let's get into it 🎀

✨ NAME ✨

ASN1_STRING_new, ASN1_STRING_type_new, ASN1_STRING_free — the ASN1_STRING allocation functions. that's it, that's the whole vibe: allocate, allocate-with-a-type, free. 💖

🦋 SYNOPSIS 🦋

#include <openssl/asn1.h>

ASN1_STRING *ASN1_STRING_new(void);
ASN1_STRING *ASN1_STRING_type_new(int type);
void ASN1_STRING_free(ASN1_STRING *a);

like hello?? include the header first, obviously. 🙈

🌸 DESCRIPTION 🌸

so here's the tea, bestie — three functions, each doing exactly one thing:

  • ASN1_STRING_new() — returns an allocated ASN1_STRING structure. and its type? undefined. literally undefined. it's giving "new phone who dis" energy, no type assigned yet. 💀
  • ASN1_STRING_type_new() — returns an allocated ASN1_STRING structure of type type. this one actually knows who it is. main character energy, it has a type. 👑
  • ASN1_STRING_free() — frees a. and if a is NULL, nothing is done. like, nothing at all. it just looks at the NULL and moves on with its life. no notes. 🫶

🧚 NOTES 🧚

okay this is the fun part — other string types call these ASN1_STRING functions. so like, the whole family is connected, iykyk. for example:

ASN1_OCTET_STRING_new() calls ASN1_STRING_type_new(V_ASN1_OCTET_STRING).

see?? it's a whole ecosystem. the octet string one is out here just vibing on top of ASN1_STRING_type_new with V_ASN1_OCTET_STRING as its personality. so iconic. ⭐

🔥 RETURN VALUES 🔥

  • ASN1_STRING_new() and ASN1_STRING_type_new() — return a valid ASN1_STRING structure, or NULL if an error occurred. so like, check for NULL, bestie, fr fr. 😭
  • ASN1_STRING_free() — does not return a value. it's void. it gives nothing back. and honestly? respect. 💅

🌈 SEE ALSO 🌈

  • ERR_get_error(3) — go look at your errors, you deserve to know what went wrong. 🦋

Copyright 2002-2023 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>.

real talk: that's not a vibe, that's a license. please actually comply with it, bestie. the Apache License 2.0 said what it said. 🎀

and that's the page!! mwah 💋 this was the 3.5.0 version of the OpenSSL manual, dated 2026-09-25 — no cap, that's the actual source and date, go off and allocate responsibly 🍓✨

📦 where this page comes from