NetASCII_Str_to_IPv6

Convert a string of an IPv6 address in common-decimal notation to an IPv6 address.

Files

net_ascii.h/net_ascii.c

Prototype

          NET_IPv6_ADDR *NetASCII_Str_to_IPv6(CPU_CHAR  *p_addr_ip_ascii,
                                              NET_ERR   *p_err);

Arguments

p_addr_ip_ascii

Pointer to an ASCII string that contains a common-decimal IPv6 address.

Example: “fe80::1111:1111”

p_err

Pointer to variable that will receive the return error code from this function:

NET_ASCII_ERR_NONE
NET_ERR_FAULT_NULL_PTR
NET_ASCII_ERR_INVALID_STR_LEN
NET_ASCII_ERR_INVALID_CHAR
NET_ASCII_ERR_INVALID_CHAR_LEN
NET_ASCII_ERR_INVALID_CHAR_VAL
NET_ASCII_ERR_INVALID_CHAR_SEQ

Returned Value

Returns the IPv6 address, represented by the IPv6 address string, if no errors.

NET_IPv6_ADDR_NONE, otherwise.

Required Configuration

Available only if IPv6 is enabled, see IPv6 Layer Configuration

Notes / Warnings

None.