Learn R Programming

mRpostman (version 0.3.1)

check_args_fetch_msg_header: Header Fetch Arguments Check

Description

Internal helper function for checking arguments used in fetch functions.

Usage

check_args_fetch_msg_header(imapconf, msg_id, by, fields, negate_fields,
  peek, partial, write_to_disk, keep_in_mem, retries)

Arguments

imapconf

An object of class imapconf generated with configure_imap and with a mbox item added after a mailbox selection with select_mailbox.

msg_id

A numeric vetor containing one or more messages ids.

by

Which id (MSN or UID) to use when searching for messages. "MSN" or message squence number is a message's relative position to the older message in the mailbox. It may change after deleting or moving messages. For instance, if a message is deleted, message sequence numbers are reordered to fill the gap. "UID" or unique identifier is always the same during the life cycle of a message. Default is "MSN".

fields

A character vector specifying which field(s) to fetch from messages. See section_or_field_options

negate_fields

If TRUE, negates the search and seeks for "NOT in the field". Default is FALSE.

peek

If TRUE, it does not mark messages as "read" after fetching. Default is TRUE.

partial

NULL or a character string with format "startchar.endchar" indicating the size (in characters) of a message slice to fetch. Default is NULL, which fetchs the full specified content.

write_to_disk

If TRUE writes fetch content of each message to the disk as a text file in the working directory. Default is FALSE.

keep_in_mem

If TRUE keeps a copy of fetch results as an list in the R session when write_to_disk = TRUE. Default is FALSE. It can only be set TRUE when write_to_disk = TRUE.

retries

Number of attempts to connect and execute the command. Default is 2.

Value

NULL if arguments are correct.

See Also

Other fetch helper: check_args_fetch_full_msg, check_args_fetch_msg_metadata, check_args_fetch_msg_text, clean_fetch_results, decode_base64_text_if_needed

Other check args: check_args_add_replace_flags, check_args_copy_msg, check_args_custom_search, check_args_delete_msg, check_args_expunge, check_args_fetch_full_msg, check_args_fetch_msg_metadata, check_args_fetch_msg_text, check_args_get_attachments, check_args_get_max_min_id, check_args_list_attachments, check_args_move_msg, check_args_remove_flags, check_args_search_date, check_args_search_flag, check_args_search_period, check_args_search_size, check_args_search_string, check_args_search_within