mirror of
https://github.com/ddidderr/wuffs.git
synced 2026-11-18 08:32:11 +01:00
150 lines
4.2 KiB
Go
150 lines
4.2 KiB
Go
// Copyright 2017 The Wuffs Authors.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// https://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
// Package builtin lists Wuffs' built-in concepts such as status codes.
|
|
package builtin
|
|
|
|
import (
|
|
t "github.com/google/wuffs/lang/token"
|
|
)
|
|
|
|
type Status struct {
|
|
Keyword t.ID
|
|
Message string
|
|
}
|
|
|
|
func (z Status) String() string {
|
|
prefix := "status "
|
|
switch z.Keyword {
|
|
case t.IDError:
|
|
prefix = "error "
|
|
case t.IDSuspension:
|
|
prefix = "suspension "
|
|
}
|
|
return prefix + z.Message
|
|
}
|
|
|
|
var StatusList = [...]Status{
|
|
// TODO: sort these somehow, when the list has stabilized?
|
|
{0, "ok"},
|
|
{t.IDError, "bad wuffs version"},
|
|
{t.IDError, "bad receiver"},
|
|
{t.IDError, "bad argument"},
|
|
{t.IDError, "initializer not called"},
|
|
{t.IDError, "invalid I/O operation"},
|
|
{t.IDError, "closed for writes"}, // TODO: is this unused? Should callee or caller check closed-ness?
|
|
{t.IDError, "unexpected EOF"}, // Used if reading when closed == true.
|
|
{t.IDSuspension, "short read"}, // Used if reading when closed == false.
|
|
{t.IDSuspension, "short write"},
|
|
{t.IDError, "cannot return a suspension"},
|
|
{t.IDError, "invalid call sequence"},
|
|
{t.IDSuspension, "end of data"},
|
|
}
|
|
|
|
var StatusMap = map[string]Status{}
|
|
|
|
func init() {
|
|
for _, s := range StatusList {
|
|
StatusMap[s.Message] = s
|
|
}
|
|
}
|
|
|
|
// TODO: a collection of forbidden variable names like and, or, not, as, ref,
|
|
// deref, false, true, in, out, this, u8, u16, etc?
|
|
|
|
var Types = []string{
|
|
// TODO: i8, i16, i32, i64.
|
|
"u8",
|
|
"u16",
|
|
"u32",
|
|
"u64",
|
|
"bool",
|
|
"status",
|
|
"reader1",
|
|
"writer1",
|
|
"image_config",
|
|
}
|
|
|
|
var Funcs = []string{
|
|
// TODO: some methods like "mark" should probably have a trailing "!".
|
|
//
|
|
// TODO: [] u8 methods (length, etc).
|
|
|
|
"u8.high_bits(n u32)(ret u8)",
|
|
"u8.low_bits(n u32)(ret u8)",
|
|
"u16.high_bits(n u32)(ret u16)",
|
|
"u16.low_bits(n u32)(ret u16)",
|
|
"u32.high_bits(n u32)(ret u32)",
|
|
"u32.low_bits(n u32)(ret u32)",
|
|
"u64.high_bits(n u32)(ret u64)",
|
|
"u64.low_bits(n u32)(ret u64)",
|
|
|
|
"status.is_error()(ret bool)",
|
|
"status.is_ok()(ret bool)",
|
|
"status.is_suspension()(ret bool)",
|
|
|
|
"reader1.read_u8?()(ret u8)",
|
|
"reader1.read_u16be?()(ret u16)",
|
|
"reader1.read_u16le?()(ret u16)",
|
|
"reader1.read_u32be?()(ret u32)",
|
|
"reader1.read_u32le?()(ret u32)",
|
|
"reader1.read_u64be?()(ret u64)",
|
|
"reader1.read_u64le?()(ret u64)",
|
|
|
|
"reader1.available()(ret u64)",
|
|
"reader1.is_marked()(ret bool)",
|
|
"reader1.limit(l u64)(ret reader1)",
|
|
"reader1.mark()()",
|
|
"reader1.since_mark()(ret[] u8)",
|
|
"reader1.skip32?(n u32)()",
|
|
"reader1.skip64?(n u64)()",
|
|
"reader1.unread_u8?()()",
|
|
|
|
"writer1.write_u8?(x u8)()",
|
|
"writer1.write_u16be?(x u16)()",
|
|
"writer1.write_u16le?(x u16)()",
|
|
"writer1.write_u32be?(x u32)()",
|
|
"writer1.write_u32le?(x u32)()",
|
|
"writer1.write_u64be?(x u64)()",
|
|
"writer1.write_u64le?(x u64)()",
|
|
|
|
"writer1.available()(ret u64)",
|
|
"writer1.copy_from_history32(distance u32, length u32)(ret u32)",
|
|
"writer1.copy_from_reader32(r reader1, length u32)(ret u32)",
|
|
"writer1.copy_from_slice(s[] u8)(ret u64)",
|
|
"writer1.copy_from_slice32(s[] u8, length u32)(ret u32)",
|
|
"writer1.is_marked()(ret bool)",
|
|
"writer1.limit(l u64)(ret writer1)",
|
|
"writer1.mark()()",
|
|
"writer1.since_mark()(ret[] u8)",
|
|
|
|
"image_config.initialize!(width u32, height u32, color_model u32)()",
|
|
}
|
|
|
|
const (
|
|
GenericReplaceFrom = t.IDCapitalT
|
|
GenericReplaceTo = t.IDDiamond
|
|
)
|
|
|
|
var SliceFuncs = []string{
|
|
// The "T" types here are generic placeholders for every "[] etc" slice
|
|
// type. When parsing these strings (e.g. in the lang/check package), "T"
|
|
// will be replaced by the "◊" diamond to denote a generic slice method, to
|
|
// avoid any possible ambiguity with a user-defined, non-generic "T" type.
|
|
"T.copy_from_slice(s T)(ret u64)",
|
|
"T.length()(ret u64)",
|
|
"T.prefix(up_to u64)(ret T)",
|
|
"T.suffix(up_to u64)(ret T)",
|
|
}
|