Struct PdfString

pub struct PdfString(pub Vec<u8>);

PDF String object - Text data in PDF files.

PDF strings can contain arbitrary binary data and use various encodings. They can be written as literal strings (text) or hexadecimal strings <48656C6C6F>.

Encoding

String encoding depends on context:

• Text strings: Usually PDFDocEncoding or UTF-16BE
• Font strings: Encoding specified by the font
• Binary data: No encoding, raw bytes

Example

use oxidize_pdf_core::parser::objects::PdfString;

// Create from UTF-8
let string = PdfString::new(b"Hello World".to_vec());
 
// Try to decode as UTF-8
if let Ok(text) = string.as_str() {
    println!("Text: {}", text);
}

Tuple Fields

0: Vec<u8>

Implementations

impl PdfString

pub fn new(data: Vec<u8>) -> Self

Create a new PDF string

pub fn as_str(&self) -> Result<&str, Utf8Error>

Get as UTF-8 string if possible.

Attempts to decode the string bytes as UTF-8. Note that PDF strings may use other encodings.

Returns

Ok(&str) if valid UTF-8, Err otherwise.

Example

use oxidize_pdf_core::parser::objects::PdfString;

let string = PdfString::new(b"Hello".to_vec());
assert_eq!(string.as_str(), Ok("Hello"));

let binary = PdfString::new(vec![0xFF, 0xFE]);
assert!(binary.as_str().is_err());

pub fn as_bytes(&self) -> &[u8]

Get as bytes

Trait Implementations

impl Clone for PdfString

fn clone(&self) -> PdfString

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PdfString

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

Formats the value using the given formatter.

impl PartialEq for PdfString

fn eq(&self, other: &PdfString) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PdfString