Skip to content

Instantly share code, notes, and snippets.

Avatar
💭
S4TF'ing!

Dave Abrahams dabrahams

💭
S4TF'ing!
View GitHub Profile
View Literate.md

Literate Markdown For C++ Programmers

lmt is a tool for extracting text from the code blocks in markdown files. This file demonstrates all the lmt features in a C++-centric way.

Installing lmt

First, install the go language if you don't have it (homebrew: brew install go).

@dabrahams
dabrahams / EfficientMutableProjection.swift
Last active Dec 27, 2020
How to efficiently create a mutable projection without inducing CoW
View EfficientMutableProjection.swift
/// Returns `(source, transform(source.pointee))` and destroys `source.pointee`.
///
/// This is a low-level utility for creating mutable projections of values without
/// causing needless copy-on-write.
///
/// Typical usage:
///
/// func f(x: inout X) { // inout means we have exclusive access to `x`.
/// var (xAddress, xFrobnication)
/// = unsafeMoveMap(destroying: &x) { x.frobnication() }
View LearningRateSchedule.swift
#if os(Linux)
import Glibc
#else
import Darwin
#endif
extension Collection {
/// Returns the index of the first element that matches the predicate.
///
/// The collection must already be partitioned according to the predicate, as if
@dabrahams
dabrahams / UnsafeReference.swift
Last active Oct 22, 2020
Property wrappers that emulate C++ references
View UnsafeReference.swift
@propertyWrapper
struct UnsafeReference<T> {
public let address: UnsafePointer<T>
var projectedValue: Self { self }
init(_ address: UnsafePointer<T>) {
self.address = address
}
var wrappedValue: T {
get { address.pointee }
}
@dabrahams
dabrahams / EfficientAny.swift
Last active Aug 26, 2020
An efficient storage foundation for type erasure.
View EfficientAny.swift
// Copyright 2020 Penguin 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
//
// http://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,
@dabrahams
dabrahams / TypeErasureSurvey.swift
Last active Aug 29, 2020
Swift type erasure survey / performance analysis. Build with `swiftc -O -g -whole-module-optimization`
View TypeErasureSurvey.swift
// Protocol to use for type erasure.
protocol Summable {
func sum() -> Int
}
// Concrete model. Type
extension Int: Summable {
func sum() -> Int { self }
}
@dabrahams
dabrahams / Example1.swift
Last active Jul 22, 2020
Ambiguity problems with giving generic types the right behavior with conditional conformances
View Example1.swift
protocol P { var pop: String { get } }
extension P {
var pop: String { "slow" }
var pop1: String { pop }
}
protocol Q: P {}
extension Q { var pop: String { "fastQ" } }
protocol R: P {}
@dabrahams
dabrahams / FactoryInitialization.swift
Last active Sep 3, 2020
Class factory initializers
View FactoryInitialization.swift
/// Classes whose initializers actually create derived classes
protocol FactoryInitializable {
/// The type of the least-derived class declared to be FactoryInitializable.
///
/// - Warning: Do not define this in your FactoryInitializable type!
associatedtype FactoryBase: AnyObject, FactoryInitializable = Self
// This associatedtype is a trick that captures `Self` at the point where
// `FactoryInitializable` enters a class hierarchy; in other contexts, `Self`
// refers to the most-derived type.
}
@dabrahams
dabrahams / CollectionAdapter.swift
Last active Jul 17, 2020
Motivation for non-public conformances providing public API
View CollectionAdapter.swift
/// A collection formed by adapting some `Base` collection, typically
/// displaying some altered form of the base collection's behavior.
///
/// Default implementations of all requirements are provided, forwarding their
/// implementations to the `Base` collection instance.
public protocol CollectionAdapter: Collection {
/// The type of the underlying collection being adapted.
associatedtype Base: Collection
/// The instance of the underlying collection being adapted.
@dabrahams
dabrahams / UnsafeReference.swift
Created May 15, 2020
Rescued very old proposal to redesign Unmanaged
View UnsafeReference.swift
#if false
Changes to Unmanaged
-public struct Unmanaged<Instance : AnyObject> {
// New API: `UnsafeReference(bitPattern:)`.
- public static func fromOpaque(value: COpaquePointer) -> Unmanaged
// New API: `OpaquePointer(bitPattern:)`.
- public func toOpaque() -> COpaquePointer