doc/crypto/ASN1_STRING_new.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 ASN1_STRING_new, ASN1_STRING_type_new, ASN1_STRING_free -
   6 ASN1_STRING allocation functions
   7
   8 =head1 SYNOPSIS
   9
  10  #include <openssl/asn1.h>
  11
  12  ASN1_STRING * ASN1_STRING_new(void);
  13  ASN1_STRING * ASN1_STRING_type_new(int type);
  14  void ASN1_STRING_free(ASN1_STRING *a);
  15
  16 =head1 DESCRIPTION
  17
  18 ASN1_STRING_new() returns an allocated B<ASN1_STRING> structure. Its type
  19 is undefined.
  20
  21 ASN1_STRING_type_new() returns an allocated B<ASN1_STRING> structure of
  22 type B<type>.
  23
  24 ASN1_STRING_free() frees up B<a>.
  25 If B<a> is NULL nothing is done.
  26
  27 =head1 NOTES
  28
  29 Other string types call the B<ASN1_STRING> functions. For example
  30 ASN1_OCTET_STRING_new() calls ASN1_STRING_type(V_ASN1_OCTET_STRING).
  31
  32 =head1 RETURN VALUES
  33
  34 ASN1_STRING_new() and ASN1_STRING_type_new() return a valid
  35 ASN1_STRING structure or B<NULL> if an error occurred.
  36
  37 ASN1_STRING_free() does not return a value.
  38
  39 =head1 SEE ALSO
  40
  41 L<ERR_get_error(3)>
  42
  43 =head1 HISTORY
  44
  45 TBA
  46
  47 =cut