SourcePro® API Reference Guide

 
Loading...
Searching...
No Matches
RWBasicUString::Pad Class Reference

Inserts the contents of a Unicode string into an output stream, padding it with a designated fill character. More...

#include <rw/tools/bustring.h>

Inheritance diagram for RWBasicUString::Pad:
RWUString::Pad

Public Member Functions

 Pad (const Pad &source)
 
 Pad (const RWBasicUString &ustr, RWUChar32 codePoint=RWBasicUString::DefaultFillCharacter)
 

Public Attributes

RWUChar32 codePoint_
 
const RWUChar16data_
 
size_t length_
 

Related Symbols

(Note that these are not member symbols.)

std::ostream & operator<< (std::ostream &os, const RWBasicUString::Pad &pad)
 

Detailed Description

Defines an iostream manipulator that can be used to insert the contents of a Unicode string into an output stream, padding the Unicode string with a specified fill character until the entire width() of the output stream has been filled with code points.

If the length of the Unicode string is greater than the width() of the output stream, or if the width() of the output stream is zero, the entire contents of the Unicode string is inserted into the stream and no padding occurs.

A Pad instance is only valid as long as the source string remains unchanged. Do not create persistent instances of this class. It should only be instantiated as a temporary in an insertion expression.

std::cout << RWBasicUString::Pad(ustr, static_cast<RWUChar32>('.'))
<< std::endl;
Represents and manages an array of UTF-16 values.
Definition bustring.h:78

Constructor & Destructor Documentation

◆ Pad() [1/2]

RWBasicUString::Pad::Pad ( const Pad & source)
inline

Constructs a copy of source.

◆ Pad() [2/2]

RWBasicUString::Pad::Pad ( const RWBasicUString & ustr,
RWUChar32 codePoint = RWBasicUString::DefaultFillCharacter )
inline

Constructs a manipulator instance. The default fill character, specified in the second parameter, is the Unicode space character.

Friends And Related Symbol Documentation

◆ operator<<()

std::ostream & operator<< ( std::ostream & os,
const RWBasicUString::Pad & pad )
related

Writes the sequence of bytes that are produced when the contents of the RWBasicUString used to construct pad are converted into a UTF-8 representation.

If os.width() is greater than the number of code points contained in the source string, the output is padded using the code point specified as a parameter to pad. If os.width() is less than the number of code points contained the source string, the entire contents of the string are inserted into the output stream.

Any padding is inserted after the string if the ios_base::left format flag is set, or before if ios_base::right is set or neither flag is set.

Exceptions
RWConversionErrThrown to report conversion errors.
std::ios_base::failureThrown to report any errors detected while performing stream operations.
See also
RWBasicUString::Pad

Member Data Documentation

◆ codePoint_

RWUChar32 RWBasicUString::Pad::codePoint_

The code point used to pad the string. The default code point is the Unicode space character.

◆ data_

const RWUChar16* RWBasicUString::Pad::data_

The string to pad.

◆ length_

size_t RWBasicUString::Pad::length_

The code unit length of the array referenced by data_.

Copyright © 2024 Rogue Wave Software, Inc., a Perforce company. All Rights Reserved.