string>alien ( string encoding -- byte-array )
Factor handbook » C library interface » Passing data between Factor and C » C strings

Next:

malloc-string ( string encoding -- alien )

Vocabulary
alien.strings

Inputs

string	a string
encoding	an encoding descriptor

Outputs

byte-array

a byte-array

Word description
Encodes a string together with a trailing null code point using the given encoding, and stores the resulting bytes in a freshly-allocated byte array.

Errors
Throws an error if the string contains null characters, or characters not representable in the given encoding.

See also
alien>string, malloc-string

Definition

IN: alien.strings

GENERIC#: string>alien 1 ( string encoding -- byte-array )

Methods

USING: alien alien.strings kernel ;

M: c-ptr string>alien drop ;


USING: alien.strings alien.strings.private kernel strings ;

M: string string>alien
    over check-c-string 2dup fast-string?
    [ string>alien-fast ] [ string>alien-slow ] if ;


USING: accessors alien.strings kernel ;

M: tuple string>alien drop underlying>> ;