Struct FormatRfc5424Sd

pub struct FormatRfc5424Sd { /* private fields */ }

A RFC5424 SD-ELEMENT of the STRUCTURED-DATA.

i.e [exampleSDID@32473 iut=“3” eventSource=“Application” eventID=“1011”]

RFC:

SD-IDs are case-sensitive and uniquely identify the type and purpose of the SD-ELEMENT. The same SD-ID MUST NOT exist more than once in a message.

There are two formats for SD-ID names:

• • Names that do not contain an at-sign (“@”, ABNF %d64) are reserved to be assigned by IETF
• • Anyone can define additional SD-IDs using names in the format name@, e.g., “ourSDID@32473”. The format of the part preceding the at-sign is not specified; sd_id

RFC:

Each SD-PARAM consists of a name, referred to as PARAM-NAME, and a value, referred to as PARAM-VALUE. PARAM-NAME is case-sensitive. To support international characters, the PARAM-VALUE field MUST be encoded using UTF-8. vals

Implementations

impl FormatRfc5424Sd

pub fn new(sd_id: &'static str, vals_cnt: usize) -> SyRes<Self>

Creates the second type of the SD-ID in format of name@, e.g., “ourSDID@32473”.

RFC5424:

The format of the part preceding the at-sign is not specified;
however, these names MUST be printable US-ASCII strings, and MUST
NOT contain an at-sign ('@', ABNF %d64), an equal-sign ('=', ABNF
%d61), a closing brace (']', ABNF %d93), a quote-character ('"',
ABNF %d34), whitespace, or control characters.  The part following
the at-sign MUST be a private enterprise number as specified in
Section 7.2.2.  Please note that throughout this document the
value of 32473 is used for all private enterprise numbers.  This
value has been reserved by IANA to be used as an example number in
documentation.  Implementors will need to use their own private
enterprise number for the enterpriseId parameter, and when
creating locally extensible SD-ID names.

Arguments

• sd_id - a sd_id which is stored with static lifetime.

• vals_cnt - amount of the values to be added.

Returns

A Result in form of SyRes is returned.

pub fn push( &mut self, key: Cow<'static, str>, val: Cow<'static, str>, ) -> SyRes<()>

Inserts the SD-PARAM into list. An SD-PARAM MAY be repeated multiple times inside an SD-ELEMENT.

Trait Implementations

impl Clone for FormatRfc5424Sd

fn clone(&self) -> FormatRfc5424Sd

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FormatRfc5424Sd

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for FormatRfc5424Sd

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.