1 USING: help.markup help.syntax strings byte-arrays alien libc
2 debugger io.encodings.string sequences ;
6 { $values { "string" string } { "encoding" "an encoding descriptor" } { "byte-array" byte-array } }
7 { $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." }
8 { $errors "Throws an error if the string contains null characters, or characters not representable in the given encoding." } ;
11 { $values { "c-ptr" c-ptr } { "encoding" "an encoding descriptor" } { "string/f" "a string or " { $link f } } }
12 { $description "Reads a null-terminated C string from the specified address with the given encoding." } ;
15 { $values { "str/seq" { $or string sequence } } { "alien" alien } }
16 { $description "Converts the string to a format which is a valid symbol name for the Factor VM's compiled code linker. By performing this conversion ahead of time, the image loader can run without allocating memory."
18 "On all platforms, symbols are ASCII strings." } ;