Learn R Programming

mRpostman (version 0.3.1)

loop_fetch_msg_text: Metadata Fetch Loop

Description

Internal helper function for loop execution used in fetch functions.

Usage

loop_fetch_msg_text(new_imapconf, msg_id, by, peek, partial, write_to_disk,
  keep_in_mem, try_b64decode, retries, handle)

Arguments

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".

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.

try_b64decode

If TRUE, tries to guess and decode the fetched text from base64 format to character. Default is FALSE.

retries

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

handle

A curl handle object.

imapconf

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

Value

A list or/and text files containing the fetch results.

See Also

Other fetch helpers: loop_fetch_full_msg, loop_fetch_msg_header, loop_fetch_msg_metadata

Other loop: loop_fetch_full_msg, loop_fetch_msg_header, loop_fetch_msg_metadata